Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve Service User ADO docs #6640

Open
1 task done
jennlw opened this issue Dec 11, 2024 · 0 comments
Open
1 task done

Improve Service User ADO docs #6640

jennlw opened this issue Dec 11, 2024 · 0 comments
Assignees
Labels
content Improvements or additions to content improvement Use this when an area of the docs needs improvement as it's currently unclear

Comments

@jennlw
Copy link

jennlw commented Dec 11, 2024

Contributions

  • I have read the contribution docs, and understand what's expected of me.

Link to the page on docs.getdbt.com requiring updates

https://learn.microsoft.com/en-us/azure/devops/organizations/security/request-changes-permissions?view=azure-devops

What part(s) of the page would you like to see updated?

Gouthami and I worked with a customer today trying to get their ADO permissions set up for the Service User. The customer requested improvements to this from the point of view of an Azure Admin with little experience. Example for the Required Permissions section there is example code:
az devops security permission update --organization https://dev.azure.com/<org_name> --namespace-id cb594ebe-87dd-4fc9-ac2c-6a10a4c92046 --subject <service_account>@xxxxxx.onmicrosoft.com --token PublisherSecurity/<azure_devops_project_object_id> --allow-bit 1

It was confusing for the user to understand where to get the namespace-id as well as where to find the azure_devops_project_object_id. They said it would be helpful if there were more details here on precise steps, screenshots, etc to help identify these details.

With more details here from a perspective of a brand new Azure Admin trying to set this up, and knowing all the places they need to go in Azure to find the information they need, would be helpful in successful setup by customers on their own.

Additional information

Ticket this feedback was from - feedback given during call: https://dbtcloud.zendesk.com/agent/tickets/78781

Please reach out to me as well if you have further questions. I am happy to have a call or whatever is needed to address any questions.

@jennlw jennlw added content Improvements or additions to content improvement Use this when an area of the docs needs improvement as it's currently unclear labels Dec 11, 2024
@matthewshaver matthewshaver self-assigned this Dec 11, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
content Improvements or additions to content improvement Use this when an area of the docs needs improvement as it's currently unclear
Projects
None yet
Development

No branches or pull requests

2 participants