STP-3553: Change command prompts to match docs-csm

[jld-dehn-hpe]

Summary and Scope

Switched to the command prompt approach used in docs-csm. The command itself does not include the prompt, but the step or paragraph which introduces the command is annotated with where the command should be executed. This allows the admin to easily copy and paste the entire code block to get the command they want to run.

Issues and Related PRs

• Resolves STP-3553
• Change will also be needed in release/2.6

Testing

Lint and spell check

Pull Request Checklist

• Version number(s) incremented, if applicable
• Copyrights updated
• License file intact
• Target branch correct
• CHANGELOG.md updated
• Testing is appropriate and complete, if applicable
• HPC Product Announcement prepared, if applicable

[haasken-hpe]

When we remove the command prompt from the code blocks, we need to still differentiate between the command that the user must execute and the example output of that command.

I left some suggestions on how to handle that. You can also check with the writer for docs-csm to make sure my suggestion is reasonable and aligned with the strategy used there.

[haasken-hpe]

My comments are minor. The bulk of them are just suggestions that instead of specifying the bash language for example output, we just use screen. Technically, I don't think screen is a real supported language according to the GitHub-flavored Markdown docs and the Linguist languages.yml it links to. But it seems to be a convention we use. We could probably use text instead of screen and get the same effect where syntax highlighting does not occur.

[jld-dehn-hpe]

/backport release/2.6

[github-actions]

Backporting into branch release/2.6 was successful. New PR: #124