docs: add numbering and headers for navigation, minor edits

[smccarthy-ie]

Adding numbered headings to help keep track of where you are in procedures, more headings to break up text, and minor copy edits only. No changes to technical content.

Please cherry pick to v0.7 also. Thanks

[smccarthy-ie]

@david-martin When you get a chance, can you review/merge this one? Nothing too controversial here. Mostly minor edits to improve readability and style :) Thanks!

[david-martin]

Thanks @smccarthy-ie

@jasonmadigan We're mid 0.8 release right now. Thoughts on backporting to 0.7 as well? (I've no issue with it per-se. The process is something I'd need a steer on with the mike plugin for mkdocs)

[jasonmadigan]

@david-martin no issue with that - it would need a backport and a re-deploy of the 0.7.x docs. Basically:

• Cherry-pick changes to the v0.2 kuadrantctl branch: https://github.com/Kuadrant/docs.kuadrant.io/blob/0.7.x/mkdocs.yml#L108
• Rebuild and push via GH action, there's a new one to re-deploy existing docs (see https://github.com/Kuadrant/docs.kuadrant.io?tab=readme-ov-file#via-ci-recommended)

[jasonmadigan]

If you need help with the cherry-pick just shout

[david-martin]

cherrypick https://github.com/Kuadrant/kuadrantctl/commit/86a0d35445a58b564949aceddb9d080befbdd5ec workflow https://github.com/Kuadrant/docs.kuadrant.io/actions/runs/9382180094

Changes look correct at a glance https://docs.kuadrant.io/0.7.0/kuadrantctl/doc/openapi-apicurio/

[smccarthy-ie]

Looks great, thanks @david-martin @jasonmadigan