[CMSP-791] WP-CLI changes did not use clear and consistent language

[jms-pantheon]

Summary

Troubleshoot WP-CLI - Changed to use clear language

Clarity and accessibility: The replacement of "What's the TL;DR?" with "Summary of changes" in the alert title improves clarity and accessibility. Avoiding internet slang and using straightforward language makes the document more accessible to screen readers and a global audience.

The removal of colloquial language like "gymnastics" is also crucial for a global audience. Technical documentation should be written in a way that is easily understandable by people from various cultural and linguistic backgrounds.

Technical terms All references now use the standard lowercase display of stdout instead of the previous mixed-case output. I have also defined the original term "standard output (stdout)" as this is a new term on the page.

Standard second person writing Pantheon's documentation should address the user as "you" and define the speaking voice, for example "At Pantheon, we do..." instead of using "I have called..."

Release:

• When ready

---

Post Launch

Do not remove - To be completed by the docs team upon merge:

• Redirect /old-path/ => /new-path/ (if applicable)
• Include/exclude pages ^ respectively within docs search service provider (if applicable)
• For Heroes - add a props post to the discussion board.
• Remove from the project board

[pantheon-decoupled]

⚡ Deployed with Pantheon Decoupled

This build was successfully deployed with Pantheon. You can track the build logs here.

👀 Preview: https://pr-8818-documentation.appa.pantheon.site
🛠️ Manage in Pantheon: https://dashboard.pantheon.io/site/2b30153f-e8b1-4427-b076-6109e704ba5d/overview

[pwtyler]

Thanks for this, this document definitely started from a different headspace than "technical documentation" before we ended up here too.