MicrosoftDocs / azure-docs

Open source documentation of Microsoft Azure
https://docs.microsoft.com/azure
Creative Commons Attribution 4.0 International
10.2k stars 21.34k forks source link

Shaky content on assorted areas of page #92716

Closed TousleyTN closed 2 years ago

TousleyTN commented 2 years ago

This page had confusing textual elements that appeared to make it far from doctrinal Microsoft documentation (imho).... For instance, it starts by immediately defining "Azure Virtual Network" as VNet, and then proceeds to constantly interchange variations of the two terms even though one is much shorter and less confusing. Microsoft is not so 'whimsical' when they write documentation. I am similarly not so when reading it, so the added variety by the author is not a welcome feature.

Ideally it should be all Dragnet on the page... Just the Facts! Anything else adds confusion to the issue and muddles content delivery. Products and services by definition, options therein... and done.

Please have an appropriate and knowledgeable reviewer fix it. You would not opt to afford my rates, and honestly given the page content I'm still somewhat shaky on what the content intended to convey so you should go elsewhere regardless.

-TnT

And this... [Enter feedback here]... should that say [Enter feedback above] ?!? I surely hope that's what you meant because I put it above and if I shouldn't have... just more bad page writing.

See?

-TnT (ps)

[Enter feedback here]


Document Details

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

ChaitanyaNaykodi-MSFT commented 2 years ago

Thank you for your feedback! We have assigned this issue to the author to review further and take the next course of action.

mbender-ms commented 2 years ago

Thanks for the feedback, @TousleyTN.

I'm creating a doc bug related to the feedback, and I will evaluate the article accordingly.

mbender-ms commented 2 years ago

please-close