add some more API documentation