diff --git a/README.md b/README.md
index 294dd439d..6ea9f1c14 100644
--- a/README.md
+++ b/README.md
@@ -35,4 +35,5 @@ The following are the broad design goals for Ethereum 2.0:
 Documentation on the different components used during spec writing can be found here:
 * [YAML Test Generators](test_generators/README.md)
 * [Executable Python Spec](test_libs/pyspec/README.md)
+* [Py-tests](py_tests/README.md)
 
diff --git a/test_generators/bls/README.md b/test_generators/bls/README.md
index 9ce1b2f6c..a21ad16d9 100644
--- a/test_generators/bls/README.md
+++ b/test_generators/bls/README.md
@@ -17,4 +17,5 @@ The base unit is bytes48 of which only 381 bits are used
 
 ## Comments
 
-Compared to Zcash, Ethereum specs always requires the compressed form (c_flag / most significant bit always set).
\ No newline at end of file
+Compared to Zcash, Ethereum specs always requires the compressed form (c_flag / most significant bit always set).
+Also note that pubkeys and privkeys are reversed.
diff --git a/test_generators/bls/main.py b/test_generators/bls/main.py
index 3c2ab454b..4c19c6249 100644
--- a/test_generators/bls/main.py
+++ b/test_generators/bls/main.py
@@ -1,7 +1,5 @@
 """
 BLS test vectors generator
-Usage:
-    "python tgen_bls path/to/output.yml"
 """
 
 # Standard library
@@ -10,13 +8,11 @@ from typing import Tuple
 
 # Third-party
 import yaml
+from py_ecc import bls
 
 # Ethereum
 from eth_utils import int_to_big_endian, big_endian_to_int
 
-# Local imports
-from py_ecc import bls
-
 
 def int_to_hex(n: int) -> str:
     return '0x' + int_to_big_endian(n).hex()