API documentation should cover

API name – short description – type Description Usage Parameters Returns Source file Examples Related APIs Other stuff

Documentation should be kept up to date… in line with the latest version of the code.