[EDI] Copilot: Restructure organization/enterprise Copilot policies (#56603)

Co-authored-by: Isaac Brown <[email protected]>
Co-authored-by: Kevin Heis <[email protected]>

Author: 3 people

content/copilot/concepts/completions/code-referencing.md

@@ -47,7 +47,7 @@ type: overview
 
 ## About {% data variables.product.prodname_copilot_short %} code referencing on {% data variables.product.prodname_dotcom_the_website %}
 
-If you've allowed suggestions that match public code, then whenever a response from {% data variables.copilot.copilot_chat_short %} includes matching code, details of the matches will be included in the response.
+If you, or your organization, have allowed suggestions that match public code, then whenever a response from {% data variables.copilot.copilot_chat_short %} includes matching code, details of the matches will be included in the response.
 
 > [!NOTE]
 > Typically, matches to public code occur infrequently, so you should not expect to see code references in many {% data variables.copilot.copilot_chat_short %} responses.
@@ -72,16 +72,18 @@ When {% data variables.copilot.copilot_chat_short %} provides a response that in
 
 ## How code referencing finds matching code
 
-{% data variables.product.prodname_copilot_short %} code referencing searches for matches by taking the code suggestion, plus some of the code that will surround the suggestion if it is accepted, and comparing it against an index of all public repositories on {% data variables.product.prodname_dotcom_the_website %}.
+{% data variables.product.prodname_copilot_short %} code referencing compares potential code suggestions and the surrounding code of about 150 characters against an index of all public repositories on {% data variables.product.prodname_dotcom_the_website %}.
 
 Code in private {% data variables.product.prodname_dotcom %} repositories, or code outside of {% data variables.product.prodname_dotcom %}, is not included in the search process.
 
-The search index is refreshed every few months. As a result, newly committed code, and code from public repositories deleted before the index was created, may not be included in the search. For the same reason, the search may return matches to code that has been deleted or moved since the index was created.
-
 ## Limitations
 
+The search index is refreshed every few months. As a result, newly committed code, and code from public repositories deleted before the index was created, may not be included in the search. For the same reason, the search may return matches to code that has been deleted or moved since the index was created.
+
 References to matching code are currently available in JetBrains IDEs, {% data variables.product.prodname_vs %}, {% data variables.product.prodname_vscode %}, and on the {% data variables.product.github %} website.
 
 ## Further reading
 
 * [AUTOTITLE](/copilot/how-tos/completions/finding-public-code-that-matches-github-copilot-suggestions)
+* [AUTOTITLE](/copilot/how-tos/manage-your-account/managing-copilot-policies-as-an-individual-subscriber)
+* [AUTOTITLE](/copilot/how-tos/administer/organizations/managing-policies-for-copilot-in-your-organization)

content/copilot/concepts/completions/code-suggestions.md

@@ -83,6 +83,10 @@ topics:
 
 {% endeclipse %}
 
+## Code suggestions that match public code
+
+{% data variables.product.prodname_copilot %} checks each suggestion for matches with publicly available code. Any matches are discarded or suggested with a code reference, based on the setting of the "Suggestions matching public code" policy for your account or organization. See [AUTOTITLE](/copilot/concepts/completions/code-referencing).
+
 ## Next steps
 
 * [AUTOTITLE](/copilot/how-tos/completions/getting-code-suggestions-in-your-ide-with-github-copilot)

content/copilot/concepts/index.md

@@ -15,6 +15,7 @@ children:
   - /indexing-repositories-for-copilot-chat
   - /about-copilot-coding-agent
   - /about-organizing-and-sharing-context-with-copilot-spaces
+  - /policies
   - /copilot-knowledge-bases
   - /build-copilot-extensions
 ---

content/copilot/concepts/policies.md

@@ -0,0 +1,52 @@
+---
+title: Copilot policies to control availability of features and models
+shortTitle: Policies
+allowTitleToDifferFromFilename: true
+intro: 'Learn about the policies that control the availability of {% data variables.product.prodname_copilot %} features and models for users granted a license through your organization or an organization in your enterprise.'
+versions:
+  feature: copilot
+type: overview
+topics:
+  - Copilot
+  - Policy
+  - Access management
+  - Organizations
+  - Enterprise
+---
+
+## About policies for {% data variables.product.prodname_copilot_short %}
+
+When you assign a {% data variables.product.prodname_copilot_short %} license to a member of your organization, you can control the features they can use under that license with {% data variables.product.prodname_copilot_short %} policies.
+
+Policies are grouped into different types.
+
+* **Feature policy:** Defines the availability of a {% data variables.product.prodname_copilot_short %} feature. Shown on the "Policies" page.
+* **Privacy policy:** Defines whether a potentially sensitive action is allowed or not. Show at the end of the "Policies" page.
+* **Models policy:** Defines the availability of models beyond the basic models provided with {% data variables.product.prodname_copilot_short %}, which may incur additional costs. Shown on the "Models" page.
+
+Each policy controls availability for members who receive a {% data variables.product.prodname_copilot_short %} license from your enterprise or organization.
+
+## Organization-level control of policies
+
+Organization owners set policies to control the availability of features and models for users granted a {% data variables.product.prodname_copilot_short %} license by the organization. For example, an organization owner can enable or disable using {% data variables.product.prodname_copilot_short %} in the IDE (unless an enterprise owner has defined availability for the feature at the enterprise level).
+
+The enforcement options for feature and model policies in an organization are:
+
+* **Unconfigured** - A placeholder, which is removed once you have defined a setting. The policy is treated as disabled for this organization until you select an option.
+* **Enabled** - The feature is **available** to all members who are assigned {% data variables.product.prodname_copilot_short %} by the organization.
+* **Disabled** - The feature is **blocked** for all members who are assigned {% data variables.product.prodname_copilot_short %} by the organization.
+
+For privacy policies, the options are called "Allowed" and "Blocked" in preference to enabled and disabled. This provides a clearer message of the impact of a privacy policy.
+
+## Enterprise-level control of policies
+
+Enterprise owners can choose to set policies for {% data variables.product.prodname_copilot_short %} at the enterprise level or to delegate the decision to organization owners using the **No policy** option.
+
+If a policy is defined at the enterprise level, control of the policy is disabled at the organization level.
+
+If organization owners are allowed to set a policy, some organizations may enable a feature while others disable it. If a member receives access to {% data variables.product.prodname_copilot_short %} through multiple organizations with conflicting policies, either the least or most permissive policy may apply, depending on the policy. For more information, see [AUTOTITLE](/copilot/reference/feature-availability-enterprise).
+
+## Next steps
+
+* [AUTOTITLE](/copilot/how-tos/administer/organizations/managing-policies-for-copilot-in-your-organization)
+* [AUTOTITLE](/copilot/how-tos/administer/enterprises/managing-policies-and-features-for-copilot-in-your-enterprise)