Documentation documentation

and other changes to the documentation.

Doc/sphinx/docdoc.rst

@@ -0,0 +1,59 @@
+Documentation Documentation
+===========================
+
+This page is the documentation for the documentation. 
+
+It is very important to know this by heart when you are writing documentation
+for Simba.
+
+Documentation system
+--------------------
+The documentation system we use is sphinx. The link to sphinx can
+be found at the bottom of the page at all times.
+
+.. note::
+    It is important to note that there is also a database SQL fulltext engine
+    called Sphinx, but this is not the project we use. We use the Sphinx
+    ``documentation system`` ( http://sphinx.pocoo.org/ )
+
+Building the documentation
+--------------------------
+In the future, the online documentation will be refreshed every hour.
+
+If you want to build the documentation yourself, you should install
+sphinx-python. 
+
+Move to the ``Simba/doc/sphinx`` directory and call ``make all``. 
+This will place the doc in html format in _build/html. 
+
+.. note::
+    The build instructions are for Linux only. If you want to build the doc on
+    Windows, you are on your own. The sphinx resource site if probably a good
+    place to start.
+
+Writing documentation
+---------------------
+
+Sphinx uses the reStructuredText markup language. It is not a hard language, but
+looking through the quickstart is a good idea:
+http://docutils.sourceforge.net/docs/user/rst/quickstart.html
+
+As stated above, the markup language is not the hard part about writing
+documentation; the hard part is simply coming up with good content suited for
+the documentation. This process is rather self explanatory, so we will not cover
+this further.
+
+Directory structure
+~~~~~~~~~~~~~~~~~~~
+
+So you have written a new piece of documentation? Great!
+
+Now we just need to know where to place it. If you have simply extended a file,
+then there should be no worries as to where to place your new text. However if
+you are writing a new chapter, then placing the file in the correct directory is
+something we'd like you to consider.
+
+If you wrote a chapter for the ``Simba Reference`` or ``Scripting Reference``
+part of the documentation, place it in the ``simbaref`` or ``scriptref``
+repectively. Any other files can be put directly in the root of the sphinx
+folder. (The same place as ``index.rst``)

Doc/sphinx/index.rst

@@ -4,7 +4,7 @@
    contain the root `toctree` directive.
 
 Welcome to the Simba documentation!
-=================================
+===================================
 
 Welcome to the Documentation of the Simba project.
 
@@ -19,6 +19,8 @@ Contents:
     gettingstarted.rst
     tutorial.rst
     reference.rst
+    scriptreference.rst
+    docdoc.rst
 
 
 Indices and tables

Doc/sphinx/reference.rst

@@ -1,6 +1,11 @@
-Reference Manual
-================
+Simba Reference
+===============
 
+All Simba documentation should be in here.
+
+.. toctree::
+
+    simbaref/extensions.rst
 
 .. note::
     This is not the same as a function reference... I think

Doc/sphinx/scriptreference.rst

@@ -0,0 +1,4 @@
+Scripting Reference
+===================
+
+Scripting Reference hoi

Doc/sphinx/simbaref/extensions.rst

@@ -0,0 +1,5 @@
+Writing Simba Extensions
+========================
+
+
+Extensions