add documentation to api and character functions/methods