docs: Overhaul Shell Completion & Autocomplete documentation

[Nick-Hope]

The Issue

The 'Shell Completion & Autocomplete' documentation page is difficult to follow and comprehend due to duplication and, in parts, convoluted logic. In particular, there is repetition of the instructions for obtaining the tar archive of completion scripts, and such instructions vary. DDEV version numbers also vary and are outdated in various places.

How This PR Solves The Issue

Overhaul of much of the page for clarification, conciseness, updating of version numbers, and to avoid duplication. In particular, provide instructions for obtaining the tar archive of completion scripts in just one place, and link to it from the individual instructions for specific scripts.

Manual testing instructions

See https://ddev--5701.org.readthedocs.build/en/5701/users/install/shell-completion/

Automated Testing Overview

No tests needed. Just documentation.

[stasadev]

Hi @Nick-Hope,

Thank you, I haven't reviewed this PR yet, just had a quick look at the formatting on the page, some code blocks need to be reformatted, you can view your changes online in the browser:

https://ddev.readthedocs.io/en/latest/developers/testing-docs/#fix-docs-using-web-browser

Once the PR has run its checks, you’ll see an item labeled docs/readthedocs.org:ddev. Click “Details” to review a docs build that includes your changes

Here is the link https://ddev--5701.org.readthedocs.build/en/5701/users/install/shell-completion/

[Nick-Hope]

@stasadev I got there in the end. The triple backticks are not being rendered now. Apologies if my multiple attempts caused you too many notifications.

[stasadev]

@Nick-Hope,

No problems with notifications 🙂

Thank you for your efforts to make it easier to work with DDEV!

[stasadev]

Thank you!

And for future reference, you can apply all GitHub suggestions in one commit when you view them from the Files changed tab, "Add suggestion to batch" button is available there.