docs fixes to support refactor