Add comments and docstrings to builders

Explains how to use the classes and the purposes of several
of the classes and tests.