Updated internal docs RE reST for epydoc

doc/doc/internal.txt

@@ -5,11 +5,20 @@ Internal notes
 ================
 
 
+How to write API documentation
+---------------------------------------
+
+API documentation is processed by `epydoc
+<http://epydoc.sourceforge.net/>`__ and should be written in
+`reStructuredText <http://docutils.sourceforge.net/rst.html>`__. See `here
+<http://epydoc.sourceforge.net/manual-othermarkup.html#restructuredtext>`__
+for details about how to use reST with epydoc documentation.
+
 How to build sphinx documentation
 ---------------------------------------
 
-Let's say you are writing documentation, and want to see the sphinx
-output before you push it.
+Let's say you are writing documentation, and want to see the `sphinx
+<http://sphinx.pocoo.org/>`__ output before you push it.
 Here is what you do it::
 
     cd Theano/doc
@@ -38,7 +47,7 @@ pylint
 ---------------------------------------
 
 Here is the autogenerated `pylint output
-<http://lgcm.iro.umontreal.ca/auto_theano_pylint/pylint_global.html>`.
+<http://pylearn.org/auto_theano_pylint/pylint_global.html>`__.
 
 Pylint documentation is generated using pylintrc file: ``Theano/doc/pylintrc``