Merge pull request #909 from reaperhulk/doc-improvements

some small doc fixes
diff --git a/docs/development/custom-vectors/cast5.rst b/docs/development/custom-vectors/cast5.rst
index 98c5ba7..f045ec1 100644
--- a/docs/development/custom-vectors/cast5.rst
+++ b/docs/development/custom-vectors/cast5.rst
@@ -3,15 +3,15 @@
 
 This page documents the code that was used to generate the CAST5 CBC, CFB, OFB,
 and CTR test vectors as well as the code used to verify them against another
-implementation. For CAST5 the CBC, CFB, and OFB vectors were generated using
-OpenSSL and the CTR vectors were generated using Apple's CommonCrypto. All the
-generated vectors were verified with Go.
+implementation. The CBC, CFB, and OFB vectors were generated using OpenSSL and
+the CTR vectors were generated using Apple's CommonCrypto. All the generated
+vectors were verified with Go.
 
 Creation
 --------
 
 ``cryptography`` was modified to support CAST5 in CBC, CFB, and OFB modes. Then
-the following python script was run to generate the vector files.
+the following Python script was run to generate the vector files.
 
 .. literalinclude:: /development/custom-vectors/cast5/generate_cast5.py
 
@@ -21,7 +21,7 @@
 Verification
 ------------
 
-The following go code was used to verify the vectors.
+The following Go code was used to verify the vectors.
 
 .. literalinclude:: /development/custom-vectors/cast5/verify_cast5.go
     :language: go
diff --git a/docs/development/custom-vectors/idea.rst b/docs/development/custom-vectors/idea.rst
index e0db58d..c226863 100644
--- a/docs/development/custom-vectors/idea.rst
+++ b/docs/development/custom-vectors/idea.rst
@@ -3,8 +3,8 @@
 
 This page documents the code that was used to generate the IDEA CBC, CFB, and
 OFB test vectors as well as the code used to verify them against another
-implementation. For IDEA the vectors were generated using OpenSSL and verified
-with Go.
+implementation. The vectors were generated using OpenSSL and verified with
+`Botan`_.
 
 Creation
 --------
@@ -20,7 +20,7 @@
 Verification
 ------------
 
-The following python code was used to verify the vectors using the `Botan`_
+The following Python code was used to verify the vectors using the `Botan`_
 project's Python bindings.
 
 .. literalinclude:: /development/custom-vectors/idea/verify_idea.py
diff --git a/docs/development/custom-vectors/seed.rst b/docs/development/custom-vectors/seed.rst
index e8fda54..5ea4295 100644
--- a/docs/development/custom-vectors/seed.rst
+++ b/docs/development/custom-vectors/seed.rst
@@ -3,7 +3,7 @@
 
 This page documents the code that was used to generate the SEED CFB and OFB
 test vectors as well as the code used to verify them against another
-implementation. For SEED the vectors were generated using OpenSSL and verified
+implementation. The vectors were generated using OpenSSL and verified
 with `Botan`_.
 
 Creation
@@ -20,7 +20,7 @@
 Verification
 ------------
 
-The following python code was used to verify the vectors using the `Botan`_
+The following Python code was used to verify the vectors using the `Botan`_
 project's Python bindings.
 
 .. literalinclude:: /development/custom-vectors/seed/verify_seed.py