(#1021) Provide clarity to choco sync command

[imm0rtalsupp0rt]

Description Of Changes

This commit provides recommended and alternate guidance, including a callout at the top of the page to alert users to the power of the command itself.

Motivation and Context

We get a lot of questions about how to run choco sync and this should provide the clarity requested.

Testing

• I have previewed these changes using the Docker Container or another method before submitting this pull request.

Change Types Made

• Minor documentation fix (typos etc.).
• Major documentation change (refactoring, reformatting or adding documentation to existing page).
• New documentation page added.
• The change I have made should have a video added, and I have raised an issue for this.
  • Issue #

Change Checklist

• Requires a change to menu structure (top or left-hand side)/
• Menu structure has been updated
• Images added to the img repository?
  • PR -
• All items are complete on the Definition of Done.

Related Issue

Fixes #1021

[steviecoaster]

@imm0rtalsupp0rt Does this follow the new standard "shape" for docs? Is that codified somewhere? This PR is a good opportunity to introduce those changes. Otherwise, we'll touch this again in the future.

[imm0rtalsupp0rt]

@imm0rtalsupp0rt Does this follow the new standard "shape" for docs? Is that codified somewhere? This PR is a good opportunity to introduce those changes. Otherwise, we'll touch this again in the future.

@steviecoaster this has some of the new shape I'm looking to implement. There are other changes for other parts of the documentation that have specific entries, such as versions of products, but this follows a structure that I think works across the majority of the docs. I haven't codified it yet, but I'm working on a list from the notes that I have and how the docs are written currently, and once I have one that I can share, I'm happy to do so.

[ryanrichter94]

I think you should add an additional section for the example below. Use the following code example to run choco sync against multiple installed software with a single command.

$mapping = @{
'Google Chrome' = 'googlechrome'
'Docker Dekstop' = 'docker-desktop'
'Microsoft Visual C++ v14 Redistributable (x64) - 14.50.35719'= 'vcredist140'
'Microsoft Visual Studio Code' = 'vscode'
}

$mapping.GetEnumerator() | Foreach-Object {choco sync --id="$($_.Key)" --package-id="$($_.Value)" }

The change was made in a later commit.

[steviecoaster]

LGTM