Merge pull request #4608 from mockingjamie/master

README.txt

@@ -10,15 +10,14 @@ Related Projects:
 
    https://github.com/Theano/Theano/wiki/Related-projects
 
-We recommend you look at the documentation on the website, since it
-will be more current than the documentation included with the package.
-If you really wish to build the documentation yourself, you will need
-sphinx. Issue the following command:
+It is recommended that you look at the documentation on the website, as it will be more current than the documentation included with the package.
 
+In order to build the documentation yourself, you will need sphinx. Issue the following command:
     python ./doc/scripts/docgen.py
 
 Documentation is built into html/
-The PDF of the documentation is html/theano.pdf
+
+The PDF of the documentation can be found at html/theano.pdf
 
 
 DIRECTORY LAYOUT
@@ -31,7 +30,7 @@ Theano (current directory) is the distribution directory.
         * tensor depends upon scalar
         * sparse depends upon tensor
         * sandbox can depend on everything else
-    * Theano/examples are copies of the example on the wiki
+    * Theano/examples are copies of the example found on the wiki
     * Theano/benchmark and Theano/examples are in the distribution, but not in
       the Python package
     * Theano/bin contains executable scripts that are copied to the bin folder
@@ -39,4 +38,4 @@ Theano (current directory) is the distribution directory.
     * Tests are distributed and are part of the package, i.e. fall in
       the appropriate submodules
     * Theano/doc contains files and scripts used to generate the documentation
-    * Theano/html is the place where the documentation will be generated
+    * Theano/html is where the documentation will be generated