...
Write schema documentation for the intended audience of a third-party developer integrating with a Totara instance, not the Totara administrator.
When the in-product term for a feature or object is different from its name in source code, use the in-product term. For example, "audience" not "cohort".
Document all aspects of the API schema
...