clean up api descriptor documentation