more fixups - documentation is roughly 90% there