another round of documentation.
new version