misc fixes and docs