changelog: Add docs/examples changes + cleanups

[phlax]

Partial fix for #22065

includes cleanups:

• fix incorrect yaml string type
• narrow paragraph widths for easier viewing/editing in editor
• fix/make consistent remaining literals
• fix remaining initial capitalization

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:]

[phlax]

/docs

/wait for:

• docs: Cleanup more literals in API docs #22174
• examples: Version updates and cleanups #22092
• docs: Fix example composition build instructions #22132
• examples: Improve waits/fix flakes #22126

[repokitteh-read-only]

Docs for this Pull Request will be rendered here:

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

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

🐱

Caused by: a #22204 (comment) was created by @phlax.

see: more, trace.

[phlax]

i will add some cleanups to this PR before i unWIP it, but we kinda need to land above PRs for it to be correct

[phlax]

@adisuissa i have tried to make the literals as consistent as possible

just this file throws up an interesting mix - names, acronyms and literals, where the distinction is not always clear cut

another example is numbers - i generally think dont literalize numbers - they would be localized in most cases - but eg response codes are a grey area - also numbers with a math operator maybe should be literals - but not sure about <0 or <0. A 0 as output probably should be a literal i think - ie you dont get back nothing you get back a 0 - there is an example of this in this file

either way i think this makes it a bit more consistent

[phlax]

https://storage.googleapis.com/envoy-pr/482e5d5/docs/version_history/v1.23/v1.23.0.html

[phlax]

arggh - i just noticed that its not ordering alphabetically - ill try and fix now

[phlax]

/wait for #22205

[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 @adisuissa
CC @envoyproxy/api-watchers: FYI only for changes made to (api/envoy/|docs/root/api-docs/).
CC @envoyproxy/dependency-shepherds: Your approval is needed for changes made to (bazel/.*repos.*\.bzl)|(bazel/dependency_imports\.bzl)|(api/bazel/.*\.bzl)|(.*/requirements\.txt)|(.*\.patch).
envoyproxy/dependency-shepherds assignee is @wrowe

🐱

Caused by: #22204 was synchronize by phlax.

see: more, trace.

[phlax]

i need fo check this over for dupes - the way the git merge works on this file can create them

[phlax]

current: https://www.envoyproxy.io/docs/envoy/latest/version_history/v1.23/v1.23.0

[phlax]

@adisuissa i think this one should be ready for final review - im reasonably confident im not undoing any of the changes you just made, and ive rinsed out the dupes

[phlax]

pr version:

https://storage.googleapis.com/envoy-pr/e25e19d/docs/version_history/v1.23/v1.23.0.html

[adisuissa]

Thanks.
Also in line 313 there "true" -> "true"

[phlax]

argg DCO

[phlax]

im gonna have to rebase/force to fix DCO - sorry - damn github!

[adisuissa]

LGTM, thanks!