Skip to content

Commit 1c7f001

Browse files
committed
merge, delete file, redirect
1 parent 79f9a72 commit 1c7f001

File tree

7 files changed

+63
-64
lines changed

7 files changed

+63
-64
lines changed

.openpublishing.redirection.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7190,6 +7190,11 @@
71907190
{
71917191
"source_path": "docs/boards/backlogs/set-up-your-backlog.md",
71927192
"redirect_url": "/azure/devops/boards/backlogs/create-your-backlog"
7193+
},
7194+
{
7195+
"source_path_from_root": "/docs/project/wiki/wiki-readme-permissions.md",
7196+
"redirect_url": "/azure/devops/project/wiki/manage-readme-wiki-permissions",
7197+
"redirect_document_id": false
71937198
}
71947199
]
71957200
}

docs/organizations/notifications/about-notifications.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -138,5 +138,5 @@ If you're enrolled in the Microsoft Entra profile information preview, your prof
138138
- [Default and supported notifications](oob-built-in-notifications.md)
139139
- [Query with group clauses](../../boards/queries/using-queries.md#group-clauses)
140140
- [FAQs](faq-notifications.yml)
141-
- [Default permissions and access set for collaboration tools](../../project/wiki/wiki-readme-permissions.md?toc=/azure/devops/organizations/notifications/toc.json&bc=/azure/devops/organizations/notifications/breadcrumb/toc.json)
141+
- [Default permissions and access set for collaboration tools](../../project/wiki/manage-readme-wiki-permissions.md?toc=/azure/devops/organizations/notifications/toc.json&bc=/azure/devops/organizations/notifications/breadcrumb/toc.json)
142142
- [Azure DevOps data protection overview](../../organizations/security/data-protection.md?toc=/azure/devops/organizations/notifications/toc.json&bc=/azure/devops/organizations/notifications/breadcrumb/toc.json)

docs/organizations/notifications/toc.yml

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -61,9 +61,6 @@
6161
href: ../../user-guide/provide-feedback.md
6262
- name: Reference
6363
items:
64-
- name: Default permissions (Security)
65-
displayName: personal, team, project, contributors, access, security, automatic
66-
href: ../../project/wiki/wiki-readme-permissions.md
6764
- name: View notification statistics for your organization
6865
displayName: active, subscription, event, initiator, administrator, review
6966
href: view-organization-notification-statistics.md

docs/project/feedback/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,5 +63,5 @@ For more information, see the following articles:
6363
## Related articles
6464

6565
- [Grant reviewers permissions to provide feedback](/previous-versions/azure/devops/project/feedback/give-permissions-feedback)
66-
- [Set default permissions and access for collaboration tools](../wiki/wiki-readme-permissions.md)
66+
- [Set default permissions and access for collaboration tools](../wiki/manage-readme-wiki-permissions.md)
6767
- [Provide feedback and get support](../../user-guide/provide-feedback.md)

docs/project/wiki/manage-readme-wiki-permissions.md

Lines changed: 56 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,25 @@
11
---
2-
title: Manage Permissions for READMEs and Wiki Pages
2+
title: Manage Permissions for Wikis, READMEs, and Collaboration Tools
33
titleSuffix: Azure DevOps
4-
description: Learn how to set permissions to grant or secure access to README files and your team project built-in wiki in Azure DevOps.
4+
description: Learn how to set permissions to grant or secure access to wikis, README files, notifications, and other collaboration tools in Azure DevOps.
55
ms.subservice: azure-devops-wiki
66
ms.custom: wiki, devdivchpfy22
77
ms.topic: concept-article
88
ms.author: chcomley
99
author: chcomley
10-
ms.reviewer: gopinach
1110
ai-usage: ai-assisted
1211
ms.date: 07/16/2025
1312
monikerRange: "<=azure-devops"
14-
#customer intent: As an Azure DevOps administrator, I want to manage permissions for README files and my team project wiki to ensure secure access for users.
13+
#customer intent: As an Azure DevOps administrator, I want to manage permissions for wikis, README files, and collaboration tools to ensure secure access for users.
1514
---
1615

17-
# Manage wiki permissions
16+
# Manage wiki and collaboration tool permissions
1817

1918
[!INCLUDE [version-lt-eq-azure-devops](../../includes/version-lt-eq-azure-devops.md)]
2019

21-
This article describes how to set and manage permissions for your team project wiki and project README files. Wiki permissions are managed through the underlying Git repository security settings.
20+
This article describes how to set and manage permissions for collaboration tools in Azure DevOps, including team project wikis, project README files, notifications, and feedback. These tools help teams collaborate effectively while maintaining appropriate security controls.
2221

23-
By default, all members of the Contributors group have permission to read and edit wiki pages. Project Administrators can modify these permissions to control who can read, edit, or manage wiki content.
22+
Wiki permissions are managed through the underlying Git repository security settings. By default, all members of the Contributors group have permission to read and edit wiki pages. Project Administrators can modify these permissions to control who can read, edit, or manage wiki content.
2423

2524
## Prerequisites
2625

@@ -38,6 +37,32 @@ Wiki permissions are controlled through the underlying Git repository that store
3837

3938
Each type uses the same Git repository permission model but might have different repository locations.
4039

40+
## Default permissions by role
41+
42+
The following table shows default permissions for collaboration tools including wikis, READMEs, notifications, and feedback:
43+
44+
|Task |Stakeholders |Readers |Contributors |Team Administrators | Organization owner/Project Administrator |
45+
|---------|---------|---------|---------|---------|---------|
46+
|Set personal notifications or alerts | ✔️ | | ✔️ | ✔️ | ✔️ |
47+
|Set team notifications or alerts | | | | ✔️ | ✔️ |
48+
|Set project-level notifications or alerts | | | | | ✔️ |
49+
|READMEs | See Note 1 | ✔️ | ✔️ | ✔️ |✔️|
50+
|View project wikis | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
51+
|View code wikis | | ✔️ | ✔️ | ✔️ | ✔️ |
52+
|Provision or create a wiki | | | | | ✔️ |
53+
|Publish code as wiki | | | ✔️ | See Note 2 | See Note 2 |
54+
|View the project page | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
55+
|Edit the project page | | | | | ✔️ |
56+
|Navigate using the project pages | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
57+
|Request feedback | | ✔️ | ✔️ | ✔️ | ✔️ |
58+
|Provide feedback |✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
59+
|Powerful code search | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
60+
|Powerful work tracking search | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
61+
62+
**Notes:**
63+
1. Stakeholders can view project READMEs, but not READMEs defined for a repository.
64+
2. Project Administrators or Team Administrators with contribute permission can publish code as wiki. Project Administrators have this permission by default.
65+
4166
## Manage permissions for project wikis
4267

4368
Project wikis (provisioned wikis) are stored in a dedicated Git repository. You can manage permissions for these wikis through the repository security settings.
@@ -50,7 +75,7 @@ Project wikis (provisioned wikis) are stored in a dedicated Git repository. You
5075

5176
3. Under **Repos**, select **Repositories**.
5277

53-
4. Select the wiki repository. For a project wiki, it's typically named `{ProjectName}.wiki`.
78+
4. Select the wiki repository. A project wiki is typically named `{ProjectName}.wiki`.
5479

5580
5. Select the **Security** tab.
5681

@@ -234,11 +259,29 @@ README files in repositories follow the same permission model as the repository
234259

235260
Users need **Read** permission to view README files and **Contribute** permission to edit them.
236261

262+
> [!NOTE]
263+
> Stakeholders can view project READMEs but can't access READMEs defined for specific repositories in private projects.
264+
265+
## Related collaboration tools
266+
267+
### Notifications and alerts
268+
269+
To manage notifications and alerts:
270+
- **Personal notifications**: See [Manage personal notifications](../../organizations/notifications/manage-your-personal-notifications.md)
271+
- **Team notifications**: See [Manage team notifications](../../organizations/notifications/manage-team-group-global-organization-notifications.md)
272+
273+
> [!NOTE]
274+
> There are no UI permissions associated with managing notifications. Instead, you can manage them using the [TFSSecurity command line tool](/azure/devops/server/command-line/tfssecurity-cmd#collection-level-permissions).
275+
276+
### Feedback permissions
277+
278+
For managing feedback permissions, see [Set feedback permissions](/previous-versions/azure/devops/project/feedback/get-feedback).
279+
237280
## Related content
238281

239282
- [Get started with permissions, access, and security groups](../../organizations/security/about-permissions.md)
240-
- [Git repository permissions](../../organizations/security/permissions.md#git-repository-object-level)
241-
- [Default Git repository and branch permissions](../../organizations/security/default-git-permissions.md)
242-
- [About wikis, READMEs, and Markdown](about-readme-wiki.md)
243-
- [Provisioned vs. published wikis](provisioned-vs-published-wiki.md)
244-
- [Clone and update wiki content offline](wiki-update-offline.md)
283+
- [Set Git repository permissions](../../organizations/security/permissions.md#git-repository-object-level)
284+
- [Learn about access levels](../../organizations/security/access-levels.md)
285+
- [Create and edit wikis](about-readme-wiki.md)
286+
- [Choose between provisioned and published wikis](provisioned-vs-published-wiki.md)
287+
- [Manage team notifications](../../organizations/notifications/manage-team-group-global-organization-notifications.md)

docs/project/wiki/toc.yml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,5 @@
4444
href: Markdown-guidance.md
4545
- name: Keyboard shortcuts to manage wiki pages
4646
href: ../navigation/keyboard-shortcuts.md#wiki-keyboard-shortcuts
47-
- name: Default permissions (Security)
48-
href: wiki-readme-permissions.md
4947
- name: Data protection overview
5048
href: ../../organizations/security/data-protection.md?toc=/azure/devops/project/toc.json

docs/project/wiki/wiki-readme-permissions.md

Lines changed: 0 additions & 44 deletions
This file was deleted.

0 commit comments

Comments
 (0)