Clarify the permissions that CodeRabbit needs. (#460)

jmacdotorg · web-flow · commit dbdf99f75270 · 2025-07-18T14:49:48.000Z
* Clarify the permissions that CodeRabbit needs.

* Clarify the wording of permission-granting steps.
diff --git a/docs/platforms/azure-devops.md b/docs/platforms/azure-devops.md
@@ -94,9 +94,8 @@ Follow these steps to generate the token:
 5. Select the organization you want to use the token with or select "All
    accessible organizations."
 6. Enter a name and an expiry date for the token.
-7. We need to have read & write access to "Work Items" & "Code" to post reviews
-   on pull requests. If you are on the Pro tier also add "Build" access for pipeline
-   failure remediation.
-8. Click "Create"
+7. Grant **Read, write, & manage** access to "Work Items" and "Code". CodeRabbit needs these permissions to post code reviews on pull requests.
+8. If you subscribe to CodeRabbit Pro, then you can also grant **Read** access to "Build" for pipeline failure remediation.
+9. Click "Create"
 
 ![CodeRabbit azure devOps personal access token creation form](/img/integrations/azure-access-token.png)
