misc cleanup and documentation

can read commit by commit. no functional changes.
Nice - I like the simplicity