test.py needs better doumentation

[lovesegfault]

Although there is some documentation written for test.py it's not really sufficient. If the objective is to make the code easy to understand. We need:

• Docstrings on all classes and methods
• More complete docstrings were appropriate
• Comments were appropriate

Naming is already good, so it's just about explaining what does what and how really.