docs(api): cleans up property descriptions

[PaulRMellor]

Documentation

API reference cleanup

• Cleans up repetition of descriptions in and outside tables in the API reference guide.
• Removes all the sub-sections that describe the same properties in the tables.
• Updates the table descriptions in the code where necessary.
• Retains any useful information introducing the schema, with examples.
• User quotas content was moved to Deploying guide

Note that ACL descriptions were re-added for the AclRule schema (removed in #9207)

There are still some lengthy descriptions for one or two tables, such as for the CruiseControlSpec schema.
Out of scope for this PR, but as a phase 2 we could look to move such additional content and for each schema have the following only:

schema_name

• example configuration
• property descriptions

Checklist

Please go through this checklist and make sure all applicable tasks have been done

• Write tests
• Make sure all tests pass
• Update documentation
• Check RBAC rights for Kubernetes / OpenShift roles
• Try your changes from Pod inside your Kubernetes and OpenShift cluster, not just locally
• Reference relevant issue(s) and close them after merging
• Update CHANGELOG.md
• Supply screenshots for visual changes, such as Grafana dashboards

[scholzj]

One more it. But LGTM otherwise. I think you might also need to update the generated files to make the build pass.

[PaulRMellor]

Thanks for the additional comments @scholzj