Add required explicit values for repo custom properties (#59618)

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: mc <42146119+mchammer01@users.noreply.github.com>

Author: 3 people

content/organizations/managing-organization-settings/managing-custom-properties-for-repositories-in-your-organization.md

@@ -38,6 +38,7 @@ You can add custom properties to your organization and set values for those prop
 1. Under "Type", select the type of property you'd like to add. This can either be a text string{% ifversion ghes < 3.15 %} or a single select field{% else %}, a single select field, a multi select field, {% ifversion ghes > 3.20 %}a URL, {% endif %}or a true/false boolean{% endif %}.
 1. Optionally, you can select **Allow repository actors to set this property**. When enabled, repository users and apps with the repository-level "custom properties" fine-grained permission will be able to set and update the property value for their repository.
 1. Optionally, you can select **Require this property for all repositories** and add a default value. This means that you require that all repositories in your organization have a value for this property. Repositories that don’t have an explicit value for this property will inherit the default value.
+{% data reusables.organizations.custom-properties-required-values %}
 1. Click **Save property**.
 
 ## Setting values for repositories in your organization

data/features/custom-properties-required-explicit-values.yml

@@ -0,0 +1,6 @@
+# Reference: #21297
+# Custom properties with required explicit values [GA]
+versions:
+  fpt: '*'
+  ghec: '*'
+  ghes: '> 3.20'

data/reusables/enterprise-onboarding/creating-custom-properties.md

@@ -28,4 +28,5 @@ You can add custom properties to your enterprise to make those properties availa
 1. Enter a name, description, and type for the custom property. The name must be unique across all of your organizations, can't contain spaces, and cannot exceed 75 characters in length.
 1. Optionally, select **Allow repository actors to set this property**. When enabled, repository users and apps with the repository-level `custom properties` fine-grained permission will be able to set and update the property value for their repository. Additionally, any actor creating a repository can set the property on the repository.
 1. Optionally, select **Require this property for all repositories** and add a default value. This means that you require that all repositories in your enterprise have a value for this property. Repositories that don’t have an explicit value for this property will inherit the default value.
+{% data reusables.organizations.custom-properties-required-values %}
 1. Click **Save property**.

data/reusables/organizations/custom-properties-required-values.md

@@ -0,0 +1,5 @@
+{% ifversion custom-properties-required-explicit-values %}
+
+   * Optionally, you can select **Require explicit user-specified values**. When this option is enabled, users and apps with permission to set property values must provide an explicit value when setting properties, creating repositories, or transferring repositories. Repositories that don't yet have an explicit value will still inherit the default value.
+
+{% endif %}