Projects base role management (GA) (#36599)

Co-authored-by: Laura Coursen <lecoursen@github.com>

content/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects.md

@@ -23,10 +23,22 @@ Project admins can also control the visibility of their project for everyone on
 
 ## Managing access for organization-level projects
 
+You can control access to your project by setting permissions for particular individuals and teams or you can set a base permission that applies to everyone in your organization.
+
 ### Managing access for everyone in your organization
 
+{% ifversion projects-v2-default-base-permission %}
+
+You can manage access for everyone in your organization to a particular project by changing the project's base permission. Changes to the base permission only affect organization members who are not organization owners and who are not granted individual access.
+
+You can also configure the default base permission at the organization-level for new projects and projects that haven't yet had a base permission configured. For more information about setting your organization's base permission for projects, see "[AUTOTITLE](/organizations/managing-organization-settings/managing-base-permissions-for-projects)."
+
+{% else %}
+
 The default base role is `write`, meaning that everyone in the organization can see and edit your project. To change project access for everyone in the organization, you can change the base role. Changes to the base role only affect organization members who are not organization owners and who are not granted individual access.
 
+{% endif %}
+
 {% data reusables.projects.project-settings %}
 1. Click **Manage access**.
 2. Under **Base role**, select the default role.

content/organizations/managing-organization-settings/index.md

@@ -43,6 +43,7 @@ children:
   - /upgrading-to-the-corporate-terms-of-service
   - /disabling-project-boards-in-your-organization
   - /disabling-insights-for-projects-in-your-organization
+  - /managing-base-permissions-for-projects
   - /allowing-project-visibility-changes-in-your-organization
   - /managing-rulesets-for-repositories-in-your-organization
 shortTitle: Manage organization settings

content/organizations/managing-organization-settings/managing-base-permissions-for-projects.md

@@ -0,0 +1,28 @@
+---
+title: 'Managing base permissions for {% data variables.projects.projects_v2 %}'
+intro: 'Organization owners can configure a base permission for {% data variables.projects.projects_v2 %} created in their organization.'
+versions:
+  feature: projects-v2-default-base-permission
+topics:
+  - Projects
+shortTitle: 'Manage {% data variables.projects.projects_v2 %} base permissions'
+allowTitleToDifferFromFilename: true
+---
+
+## About base permissions for {% data variables.projects.projects_v2 %}
+
+You can set a project's base permission to control the level of access for all members of your organization. You can then specify individual and team permissions for each project in addition to the base permission. For more information on setting permissions for individual projects, see "[AUTOTITLE](/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects)."
+
+When you set the base permission for projects in your organization's settings, the base permission will apply to any new projects created by organization members and existing projects that do not currently have a base permission configured in the project's settings.
+
+## Setting a base permission for {% data variables.projects.projects_v2  %} in your organization
+
+{% data reusables.profile.access_org %}
+{% data reusables.profile.org_settings %}
+{% data reusables.organizations.member-privileges %}
+1. Under "Projects base permissions", select the dropdown menu and click a permissions level.
+1. In the pop-up window, review the changes and number of projects that will be affected. To confirm, click **Change default permission to PERMISSION**.
+
+## Further reading
+
+* "[AUTOTITLE](/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects)"

data/features/projects-v2-default-base-permission.yml

@@ -0,0 +1,6 @@
+# Issue 10176
+# Ability to set a default base permission for projects in your organization
+versions:
+  fpt: '*'
+  ghec: '*'
+  ghes: '>=3.10'