misc documentation and cleanup