new module doc

__init__.py

 """
-WRITEME: Some module-level documentation.
+Theano is an optimizing compiler in Python, built to evaluate complicated expressions
+(especially matrix-valued ones) as quickly as possible. 
+Theano compiles expression graphs (see :doc:`graph` ) that are built by Python code.
+The expressions in these graphs are called `Apply` nodes and the variables in these graphs are called `Result` nodes.
+
+You compile a graph by calling `function`, which takes a graph, and returns a callable object.
+One of theano's most important features is that `function` can transform your graph before
+compiling it.
+It can replace simple expressions with faster or more numerically stable implementations.
+
+To learn more, check out:
+- Joseph Turian's n00b walk through (:wiki:`UserBasic`)
+- an introduction to extending theano (:wiki:`UserAdvanced`)
+- Terminology Glossary (:wiki:`TerminologyGlossary`)
+- Index of Howto documents (:wiki:`HowtoIndex`)
 
-Here is how to make a link into the wiki: check out the :wiki:`DefineGraph`.
-
-
-Testing... some more. and more. AAABCDEFGHIJK
 """
 
 __docformat__ = "restructuredtext en"