doc, tools: Improve docs around using clang-format with VS

[akkaygin]

Summary of the Pull Request

Commit dbbe820 seems to change where OpenConsole.psm1 puts clang-format.exe but /doc/building.md still uses the path from commit 9b92986.
Updated clang-format.exe's path and added the required steps to generate a clang-format.exe file.

References

PR Checklist

• Closes doc/building.md Possibly Outdated #9777
• CLA signed. If not, go over here and sign the CLA
• Tests added/passed
• Documentation updated. If checked, please file a pull request on our docs repo and link it here: #xxx (building.md doesn't exist in docs repo)
• Schema updated.
• I've discussed this with core contributors already. If not checked, I'm ready to accept this work might be rejected in favor of a different grand plan. Issue number where discussion took place: #xxx

[zadjii-msft]

This is true, but it's not technically the most correct guidance here. Technically, all you need to do is a nuget restore to get clang-format pulled down onto your machine. Those mentioned commands will work, but only because they're also calling nuget restore 😄

[akkaygin]

I see, would adding a step where the user only executes dep\nuget\nuget.exe restore tools\packages.config be a better solution? Maybe put that in a function like Get-CodeFormat? That would look like this:

...To download the required clang-format.exe file, follow one of the building instructions below and run

Import-Module .\tools\OpenConsole.psm1
Set-MsBuildDevEnvironment
Get-CodeFormat

...

[zadjii-msft]

I see, would adding a step...

Yea great idea, that all looks good to me!

[zadjii-msft]

Thanks!

[DHowett]

I'm not in love with the exposed member name here, but... this will be fine. Get- isn't totally correct for what this does; it's more of an Install-