keeping documentation in sync with API