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

I find this page VERY confusing #89661

Closed erjosito closed 2 years ago

erjosito commented 2 years ago

Hey there, I think I understand what Private Link does, but it took me 2 hours to understand and test the limitations of AMPLS... There has to be an easy way to describe this, happy to help if needed


Document Details

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

erjosito commented 2 years ago

Let me qualify the feedback a bit better: the "scope" concept is new for somebody already familiar with Private Link, but instead of comparing with familiar structures that the reader might know from other Azure services, and build from there, the article introduces everything from scratch, leaving the reader the task of finding out what is different in AzMonitor

MarileeTurscak-MSFT commented 2 years ago

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

noakup commented 2 years ago

@erjosito - thanks for letting us know. I added a clear note on AMPLS, clarifying how we use it and that it’s different than Private Links set up in other services. The documentaion will be refreshed soon.

AbbyMSFT commented 2 years ago

please-close