api/type: complete docstrings