fixes and docs