Adding some comments to the implementation notes.
Javadocing.