docs: Improve ordering and titles in API TOCs

[phlax]

Fix #22875

Related to #20238

Signed-off-by: Ryan Northey ryan@synca.io

Commit Message:
Additional Description:
Risk Level:
Testing:
Docs Changes:
Release Notes:
Platform Specific Features:
[Optional Runtime guard:]
[Optional Fixes #Issue]
[Optional Fixes commit #PR or SHA]
[Optional Deprecated:]
[Optional API Considerations:]

[repokitteh-read-only]

Docs for this Pull Request will be rendered here:

https://storage.googleapis.com/envoy-pr/23536/docs/index.html

The docs are (re-)rendered each time the CI envoy-presubmit (precheck docs) job completes.

🐱

Caused by: #23536 was opened by phlax.

see: more, trace.

[repokitteh-read-only]

CC @envoyproxy/api-shepherds: Your approval is needed for changes made to (api/envoy/|docs/root/api-docs/).
envoyproxy/api-shepherds assignee is @htuch
CC @envoyproxy/api-watchers: FYI only for changes made to (api/envoy/|docs/root/api-docs/).

🐱

Caused by: #23536 was opened by phlax.

see: more, trace.

[wbpcode]

Seems like related to #22875. will we get this in 1.24.0?

[wbpcode]

/retest

[phlax]

will we get this in 1.24.0?

im hoping so - im working on it now

[repokitteh-read-only]

Retrying Azure Pipelines:
Retried failed jobs in: envoy-presubmit

🐱

Caused by: a #23536 (comment) was created by @wbpcode.

see: more, trace.

[wbpcode]

will we get this in 1.24.0?

im hoping so - im working on it now

Thanks for your hard work.

[phlax]

cc @mattklein123 i have focused on this page (and related):

https://storage.googleapis.com/envoy-pr/53aca79/docs/api-v3/api.html

as it seemed the worst offender in terms of readability.

alpha ordering can be imperfect as it doesnt always group as you want - i have done a bit of tweaking of api titles to try and improve this - we could probably go further - eg Path matcher -> Matcher - path, String matcher -> Matcher - string etc

i have also tried to make the titles more consistent in terms of capitalization

[mattklein123]

Nice!