docs: Add "reference" directory for putting docs about the language.

dpgeorge · dpgeorge · commit aef3846c13d0 · 2015-06-25T00:20:57.000+01:00
diff --git a/docs/esp8266_contents.rst b/docs/esp8266_contents.rst
@@ -4,4 +4,5 @@ MicroPython documentation contents
 .. toctree::
 
     library/index.rst
-    license.rst
+    reference/index.rst
+    license.rst
diff --git a/docs/pyboard_contents.rst b/docs/pyboard_contents.rst
@@ -7,6 +7,7 @@ MicroPython documentation contents
     pyboard/general.rst
     pyboard/tutorial/index.rst
     library/index.rst
+    reference/index.rst
     pyboard/hardware/index.rst
     license.rst
 
diff --git a/docs/reference/index.rst b/docs/reference/index.rst
@@ -0,0 +1,10 @@
+The MicroPython language
+========================
+
+MicroPython aims to implement the Python 3.4 standard, and most of
+the features of MicroPython are identical to those described by the
+documentation at
+`docs.python.org <https://docs.python.org/3.4/reference/index.html>`_.
+
+Differences to standard Python as well as additional features of
+MicroPython are described in the sections here.
diff --git a/docs/topindex.html b/docs/topindex.html
@@ -47,6 +47,10 @@ <h1>MicroPython documentation</h1>
       </p>
     </td>
     <td width="40%" style="padding-left:2em;">
+      <p class="biglink">
+        <a class="biglink" href="{{ pathto("reference/index") }}">Language Reference</a><br/>
+        <span class="linkdescr">information about MicroPython specific language features</span>
+      </p>
       {% if port == "pyboard" %}
         <p class="biglink">
             <a class="biglink" href="{{ pathto(port + "/hardware/index") }}">The {{ port }} hardware</a><br/>
diff --git a/docs/wipy_contents.rst b/docs/wipy_contents.rst
@@ -6,4 +6,5 @@ MicroPython documentation contents
     wipy/quickref.rst
     wipy/general.rst
     library/index.rst
+    reference/index.rst
     license.rst
