MicrosoftDocs / azure-docs

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

"Access mode for specific networks" section is confusing #114429

Closed phwecker closed 10 months ago

phwecker commented 1 year ago

https://learn.microsoft.com/en-us/azure/azure-monitor/logs/private-link-design#set-access-modes-for-specific-networks

the section about "Set access modes for specific networks" describes -at a very rudimentary level- that he access levels can be set, but has no reference to how it is done, and the associated graphics contains UI elements that are actually not there in the UI where the setting can be done.

please revisit this section as it needs clarification and -ideally- a reference to the section of the doc that describes how to do it or a short paragraph explaining it there in place.

e.g. "You can set the networks specific access mode in the Exceptions section of the AMPLS' Access Mode blade."

and please modify he graphics to not show UI elements that are not used in the UI. this confuses customers as they start hunting for the visuals.


Document Details

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

AjayBathini-MSFT commented 1 year ago

@phwecker Thanks for your feedback! We will investigate and update as appropriate.

AnuragSingh-MSFT commented 1 year ago

@phwecker, thank you for the feedback.

@guywi-ms, could you please review the feedback and share your thoughts. Thank you

guywi-ms commented 10 months ago

@phwecker Thanks for your dedication to our documentation! We've created an internal work item to incorporate your suggestions. We are closing this issue for now, but feel free to comment here as necessary. #please-close