azure-docs icon indicating copy to clipboard operation
azure-docs copied to clipboard

Why not display roles needed for any technical walkthrough?

Open meduri99 opened this issue 3 years ago • 2 comments

This is just a sample page I am referring to here, to explain how the help section can be more effective. When we want to try something explained on any page, it will be excellent to see a para on what all the roles are needed to replicate the item shown in that page.

Example - you need X, Y, Z roles to try this on Azure portal.

Like the ingredients of a recipe, this will make us check with our administrators to provide the roles expected.

Thanks!


Document Details

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

meduri99 avatar Nov 10 '22 00:11 meduri99

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

SaibabaBalapur-MSFT avatar Nov 10 '22 04:11 SaibabaBalapur-MSFT

@AaronMaxwell Please review the feedback and comment on the same.

SadiqhAhmed-MSFT avatar Nov 10 '22 12:11 SadiqhAhmed-MSFT

Thanks for your dedication to our documentation. This is a great idea.

Adding required roles as part of prerequisites sections would need to be added to our Contributor's Guide.

This PR has been submitted as feedback to our team that handles content planning, design, style, etc.

https://learn.microsoft.com/en-us/style-guide/content-planning #please-close

AaronMaxwell avatar Nov 15 '22 15:11 AaronMaxwell