Refine setup and configuration docs

[pellared]

Why

Fixes #2071

Towards #2076

What

• Add recommendation for configuration methods
• Update IIS instrumentation docs
• Update Windows Service instrumentation docs
• Add comments for Bash script
• Update PowerShell module docs

[pellared]

@ramanjaneyagupta PTAL and feel free to provide any feedback

[pellared]

I know that dotnet run is not currently working. Reference #1744

@pjanotti Should we keep it or change the example to use some executable? E.g.

Suggested change

	dotnet run
	.\MyNetApp.exe

[pjanotti]

I will explicitly call out the current issues with dotnet CLI and suggest to create a shell to run the instrumented version. Basically: build and run dotnet CLI on shell 1 then set up the environment for automatic instrumentation on shell 2. A warning icon, plus, a link to the bug seems worthwhile at the moment.

[pellared]

I will address it in a separate PR.

[pellared]

@theletterf PTAL. Lots of docs changes

[pjanotti]

@pellared for the time being we need to ensure that the instrumentation environment variables are not set in the same context/shell in which dotnet CLI is being used. There are too many setting combinations and most of them lead to different problems. So explicitly call that out and recommend running the executable directly in a separate context/shell to get instrumentation going.

[pjanotti]

I will explicitly call out the current issues with dotnet CLI and suggest to create a shell to run the instrumented version. Basically: build and run dotnet CLI on shell 1 then set up the environment for automatic instrumentation on shell 2. A warning icon, plus, a link to the bug seems worthwhile at the moment.