Merge pull request #8 from delallea/nouiz-doc_str

doc/cifarSC2011/extending_theano.txt

@@ -131,29 +131,28 @@ Op example
             return i0_shapes
 
         def grad(self, inputs, output_grads):
-            return [output_grads[0]*2]
+            return [output_grads[0] * 2]
 
 Test it!
 
 .. code-block:: python
 
     x = theano.tensor.matrix()
-    f = theano.function([x],DoubleOp()(x))
+    f = theano.function([x], DoubleOp()(x))
     import numpy
-    inp = numpy.random.rand(5,5)
+    inp = numpy.random.rand(5, 5)
     out = f(inp)
-    assert numpy.allclose(inp*2, out)
+    assert numpy.allclose(inp * 2, out)
     print inp
     print out
 
 Testing the gradient
 --------------------
 
-The function :ref:`verify_grad
-<validating_grad>`
-verify the gradient of an Op or Theano graph. It compare the
-analytic(symbolicaly computed) gradient and the numeric
-gradient(computed through the Finite Difference Method).
+The function :ref:`verify_grad <validating_grad>`
+verifies the gradient of an Op or Theano graph. It compares the
+analytic (symbolically computed) gradient and the numeric
+gradient (computed through the Finite Difference Method).
 
 To verify the grad method of the DoubleOp, you can use this:
 
@@ -163,6 +162,9 @@ To verify the grad method of the DoubleOp, you can use this:
    import theano.tests
    theano.tests.unittest_tools.verify_grad(DoubleOp(), [numpy.random.rand(5,7,2)])
 
+If nothing happens, then it works! If you want to see it fail, you can
+implement a wrong gradient (for instance removing the multiplication by 2).
+
 Exercises 8
 -----------
 

doc/tutorial/faq.txt

@@ -6,7 +6,7 @@ Frequently Asked Questions
 ==========================
 
 TypeError: object of type 'TensorVariable' has no len()
---------------------------------------------------------------
+-------------------------------------------------------
 
 If you receive this error:
 
@@ -14,10 +14,10 @@ If you receive this error:
 
    TypeError: object of type 'TensorVariable' has no len()
 
-We can't implement the __len__ function on Theano Varible. This is
-because Python request that we return an integer, but we can't do this
-as we are working with symbolic variable. You can use `var.shape[0]`
-as a workaround.
+We can't implement the __len__ function on Theano Variables. This is
+because Python requires that this function returns an integer, but we
+can't do this as we are working with symbolic variables. You can use
+`var.shape[0]` as a workaround.
 
-Also we can't change the error to a better one for some other Python
-internal behavior that we can't change.
+Also we can't change the above error message into a more explicit one
+because of some other Python internal behavior that can't be modified.