bring documentation in sync with endpoints