wrote more API docs