cleanup for release

[goatherd]

Fix non-code stuff for initial release:

• document covered changes
• review Readme.md
• adjust License file
• adjust class comments

[goatherd]

got the number wrong in that commit message..