api documentation and consistency