partially updated API docs