Comment code thoroughly for annotated source
Add annotated source docs.