updated docs based on apiman refactoring