Updates reference terms with latest attributes, updated readme

Author: Alice Pintus

Language/Functions/Analog IO/analogWrite.adoc

@@ -1,3 +1,8 @@
+:source-highlighter: pygments
+:pygments-style: arduino
+:ext-relative: adoc
+
+
 = analogWrite()
 
 
@@ -21,8 +26,8 @@ image::http://arduino.cc/en/uploads/Main/ArduinoUno_R3_Front_450px.jpg[caption="
 
 [float]
 === Parameters
-`pin`: the pin to write to. +
-`value`: the duty cycle: between 0 (always off) and 255 (always on).
+`pin`: the pin to write to. Allowed data types: int. +
+`value`: the duty cycle: between 0 (always off) and 255 (always on). Allowed data types: int
 
 
 [float]
@@ -75,14 +80,14 @@ image::http://arduino.cc/en/uploads/Main/ArduinoUno_R3_Front_450px.jpg[caption="
 [float]
 === See also
 [role="language"]
-* #LANGUAGE# http://arduino.cc/en/Reference/AnalogRead[analogRead()]
-* #LANGUAGE# http://arduino.cc/en/Reference/AnalogRead[analogRead()]
+* #LANGUAGE# link:analogRead{ext-relative}[analogRead()]
+* #LANGUAGE# link:analogWriteResolution{ext-relative}[analogWriteResolution()]
 
 [role="definition"]
-* #DEFINITION# http://arduino.cc/en/Tutorial/PWM[PWM]
+* #DEFINITION# http://arduino.cc/en/Tutorial/PWM[PWM^]
 
 [role="example"]
-* #EXAMPLE# http://arduino.cc/en/Tutorial/Blink[Blink]
+* #EXAMPLE# http://arduino.cc/en/Tutorial/Blink[Blink^]
 
 --
 // HOW TO USE SECTION ENDS

Language/Functions/Communication/serial.adoc

@@ -1,3 +1,7 @@
+:source-highlighter: pygments
+:pygments-style: arduino
+:ext-relative: adoc
+
 = Serial()
 
 
@@ -59,15 +63,16 @@ http://arduino.cc[serialEvent()]
 
 [float]
 === See also
-[role="language"]
-* #LANGUAGE# http://arduino.cc/en/Reference/AnalogRead[analogRead()]
-* #LANGUAGE# http://arduino.cc/en/Reference/AnalogRead[analogRead()]
-
-[role="definition"]
-* #DEFINITION# http://arduino.cc/en/Tutorial/PWM[PWM]
 
 [role="example"]
-* #EXAMPLE# http://arduino.cc/en/Tutorial/Blink[Blink]
+* #EXAMPLE# http://arduino.cc/en/Tutorial/ReadAsciiString[ReadAsciiString^]
+* #EXAMPLE# http://arduino.cc/en/Tutorial/ASCIITable[ASCII TAble^]
+* #EXAMPLE# http://arduino.cc/en/Tutorial/Dimmer[Dimmer^]
+* #EXAMPLE# http://arduino.cc/en/Tutorial/Graph[Graph^]
+* #EXAMPLE# http://arduino.cc/en/Tutorial/PhysicalPixel[Physical Pixel^]
+* #EXAMPLE# http://arduino.cc/en/Tutorial/SerialCallResponse[Serial Call Response^]
+* #EXAMPLE# http://arduino.cc/en/Tutorial/SerialCallResponseASCII[Serial Call Response ASCII^]
+
 
 --
 // SEEALSO SECTION ENDS

Language/Structure/Boolean Operators/&&.adoc

@@ -1,3 +1,7 @@
+:source-highlighter: pygments
+:pygments-style: arduino
+:ext-relative: adoc
+
 = && (and)
 
 
@@ -49,10 +53,10 @@ Make sure you don't mistake the boolean AND operator, && (double ampersand) for
 [float]
 === See also
 [role="language"]
-* #LANGUAGE# http://arduino.cc/en/Reference/BitwiseAnd[&] (bitwise AND)
-* #LANGUAGE# http://arduino.cc/en/Reference/BitwiseAnd[|] (bitwise OR)
-* #LANGUAGE# http://arduino.cc/en/Reference/BitwiseXorNot[~] (bitwise NOT)
-* #LANGUAGE# http://arduino.cc/en/Reference/If[if]
+* #LANGUAGE# link:BitwiseAnd{ext-relative}[&^] (bitwise AND)
+* #LANGUAGE# link:BitwiseOr{ext-relative}[|^] (bitwise OR)
+* #LANGUAGE# link:BitwiseXorNot{ext-relative}[~^] (bitwise NOT)
+* #LANGUAGE# link:If{ext-relative}[if^]
 
 --
 // HOW TO USE SECTION ENDS

Language/Structure/Further Syntax/CurlyBraces.adoc

@@ -1,3 +1,7 @@
+:source-highlighter: pygments
+:pygments-style: arduino
+:ext-relative: adoc
+
 = {} Curly Braces
 
 
@@ -95,5 +99,13 @@ else
 [%hardbreaks]
 
 
+[float]
+=== See also
+[role="language"]
+* #LANGUAGE# link:SemiColon{ext-relative}[;^] (semicolon)
+* #LANGUAGE# link:SingleComment{ext-relative}[//^] (single line comment)
+* #LANGUAGE# link:MultiComments{ext-relative}[/* */^] (multi-line comment)
+
+
 --
 // HOW TO USE SECTION ENDS

Language/Structure/Main/setup.adoc

@@ -1,3 +1,7 @@
+:source-highlighter: pygments
+:pygments-style: arduino
+:ext-relative: adoc
+
 = setup()
 
 
@@ -50,3 +54,8 @@ void loop()
 
 --
 // HOW TO USE SECTION ENDS
+
+[float]
+=== See also
+[role="language"]
+* #LANGUAGE# link:Loop{ext-relative}[loop^]

Language/Variables/Constants/high-low.adoc

@@ -16,3 +16,25 @@ If you want to contribute to the Language Reference or edit existing content, yo
 Please note that every Reference file should include as least a Description, some Example Code, and links to other relevant infos (See Also section). 
 
 If you need to add images to the Asciidoc please create a folder called attachments in the same directory as the Asciidoc file. Images can be saved in SVG and PNG format, max size 200KB.
+
+##Folder Structure
+```
+reference-en
+├─ AsciiDoc_sample
+│   ├── AsciiDoc_Dictionary
+│   │   ├── AsciiDoc_Template-Dictionary.adoc
+│   │   └── attachments
+│   └── Reference_Terms
+│       ├── AsciiDoc_Template-Parent_Of_Entities.adoc
+│       ├── AsciiDoc_Template-Single_Entity.adoc
+│       └── attachments
+├── Language
+│   ├── Functions
+│   ├── Structure
+│   └── Variables
+├── LICENCE.md
+└── README.md
+
+```
+
+Within the Language folder, the file tree follows the same structure as in the [Arduino Reference webpage](http://arduino.cc/en/Reference/HomePage).