improve API docs