docs: Update documentation

[embano1]

Description

• Remove $ from docs for easy copy and paste
• Update installation instructions for recent go versions

Closes: #2830
Signed-off-by: Michael Gasch mgasch@vmware.com

Type of change

Please mark options that are relevant:

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to
  not work as expected)
• This change requires a documentation update
• Build related change

How Has This Been Tested?

Please describe the tests that you ran to verify your changes. Provide
instructions so we can reproduce. If applicable, please also list any relevant
details for your test configuration.

• Test Description 1
• Test Description 2

Checklist:

• My code follows the CONTRIBUTION guidelines of
  this project
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• Any dependent changes have been merged

[dougm]

The nice thing about console + $ command prefix is you can clearly see the commands vs output. Compare the current: https://github.com/vmware/govmomi/tree/master/vcsim#usage
The command and comment are colorized black+grey, output is blue. This is esp. useful when a console section contains multiple commands+outputs.

To w/o the $, all text is blue: https://github.com/vmware/govmomi/blob/c235e4f3282f4f1cee09b7224388b7cd2a30cc9d/vcsim/README.md#usage

I would prefer to keep console+prompt in the sections where include the output. Ok with me to remove the prompt where we don't include any output. But, in those cases you'd probably want to change console to bash, so we get the consistent color (black vs blue).

ex see current black: https://github.com/vmware/govmomi/tree/master/vcsim#install-via-go-get
vs pr blue: https://github.com/vmware/govmomi/blob/c235e4f3282f4f1cee09b7224388b7cd2a30cc9d/vcsim/README.md#install-via-go-install

[embano1]

Makes sense, wasn't aware of these little subtleties :)

[embano1]

Changed all non-output lines to bash, reverted back the commands with output to console prefixed by $

[dougm]

lgtm, thanks!