Azure-docs: Troubleshooting page is a mess

Created on 31 Jul 2019  Â·  9Comments  Â·  Source: MicrosoftDocs/azure-docs

https://docs.microsoft.com/en-us/azure/virtual-machines/troubleshooting/ is just a bunch of text without proper order and subsections.

For example:

This is under SSH but doesn't in any way about it:

"Common error messages
Performance issues with Windows VMs
How to use PerfInsights
Performance diagnostics extension"


Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

Pri2 assigned-to-author doc-bug triaged virtual-machines-windowsvc

All 9 comments

@Bafff Thanks for providing feedback and bringing this to our attention. I am assigning the issue to content author for getting this fixed.

Maybe it is more related to the https://github.com/MicrosoftDocs/azure-docs/blob/master/articles/virtual-machines/troubleshooting/index.md page. But there was no link to open an issue there

@Bafff Yes, we see the menu on the left is correct but the one on the right side is not aligned correctly.

image

@anandhms Can you please look into the issue and fix the menu in the document.

@VikasPullagura-MSFT : I have updated the PR to include an updated index.md page with Performance Diagnostics items in a new hierarchy. Please take a look.

As far as the other items on this page, you may want to follow-up with @JarrettRenshaw

@MicahMcKittrick-MSFT but I don't see that it is resolved

@Bafff sorry I hit close by accident.

@jarretRenshaw Are you able to update the ToC? There is extra items under SSH that do not have anything to do with SSH. There are most likely others as well.
image

@Bafff I have restructured the Troubleshooting page. I will process to close this issue. Free feel to let me know if you have any suggestion or comments. Thanks.``

please-close

Was this page helpful?
0 / 5 - 0 ratings

Related issues

paulmarshall picture paulmarshall  Â·  3Comments

bdcoder2 picture bdcoder2  Â·  3Comments

DeepPuddles picture DeepPuddles  Â·  3Comments

spottedmahn picture spottedmahn  Â·  3Comments

jamesgallagher-ie picture jamesgallagher-ie  Â·  3Comments