repo sync

content/admin/configuration/configuring-your-enterprise/initializing-github-ae.md

@@ -8,6 +8,7 @@ topics:
   - Enterprise
 redirect_from:
   - /admin/configuration/initializing-github-ae
+  - /enterprise-server@latest/admin/configuration/configuring-your-enterprise/initializing-github-ae
 ---
 ## About initialization
 

content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise.md

@@ -13,6 +13,7 @@ redirect_from:
   - /admin/policies/enforcing-policies-for-your-enterprise/enforcing-github-actions-policies-for-your-enterprise
   - /github/setting-up-and-managing-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account
   - /github/setting-up-and-managing-your-enterprise/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account
+  - /github/setting-up-and-managing-your-enterprise/setting-policies-for-organizations-in-your-enterprise-account/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-enterprise-account
 versions:
   ghec: '*'
   ghes: '*'

content/admin/policies/enforcing-policies-for-your-enterprise/index.md

@@ -24,4 +24,3 @@ children:
   - /enforcing-policies-for-advanced-security-in-your-enterprise
 shortTitle: Enforce policies
 ---
-

content/admin/policies/index.md

@@ -4,7 +4,6 @@ intro: 'You can set policies in {% data variables.product.product_name %} to red
 redirect_from:
   - /enterprise/admin/developer-workflow
   - /enterprise/admin/policies
-  - /github/setting-up-and-managing-your-enterprise/setting-policies-for-organizations-in-your-enterprise-account
 versions:
   ghec: '*'
   ghes: '*'
@@ -16,4 +15,3 @@ children:
   - /enforcing-policy-with-pre-receive-hooks
 shortTitle: Set policies
 ---
-

content/admin/user-management/managing-organizations-in-your-enterprise/index.md

@@ -9,6 +9,9 @@ redirect_from:
   - /github/setting-up-and-managing-your-enterprise-account/managing-organizations-in-your-enterprise-account
   - /github/setting-up-and-managing-your-enterprise/managing-organizations-in-your-enterprise-account
   - /admin/user-management/managing-organizations-in-your-enterprise/managing-unowned-organizations-in-your-enterprise
+  - /github/setting-up-and-managing-your-enterprise/managing-organizations-in-your-enterprise-account/managing-unowned-organizations-in-your-enterprise-account
+  - /github/setting-up-and-managing-your-enterprise-account/managing-unowned-organizations-in-your-enterprise-account
+  - /github/setting-up-and-managing-your-enterprise/managing-unowned-organizations-in-your-enterprise-account
 intro: 'Organizations are great for creating distinct groups of users within your company, such as divisions or groups working on similar projects. {% ifversion ghae %}Internal{% else %}Public and internal{% endif %} repositories that belong to an organization are accessible to members of other organizations in the enterprise, while private repositories are inaccessible to anyone but members of the organization that are granted access.'
 versions:
   ghec: '*'
@@ -31,4 +34,3 @@ children:
   - /continuous-integration-using-jenkins
 shortTitle: Manage organizations
 ---
-

content/rest/overview/resources-in-the-rest-api.md

@@ -699,4 +699,3 @@ If no `Time-Zone` header is specified and you make an authenticated call to the
 If the steps above don't result in any information, we use UTC as the timezone to create the git commit.
 
 [pagination-guide]: /guides/traversing-with-pagination
-

content/support/learning-about-github-support/about-github-support.md

@@ -17,6 +17,8 @@ redirect_from:
   - /github/working-with-github-support/github-enterprise-cloud-support
   - /articles/business-plan-support
   - /articles/github-business-cloud-support
+  - /admin/enterprise-support/about-support-for-advanced-security
+  - /enterprise-server/admin/enterprise-support/about-support-for-advanced-security
 topics:
   - Support
 ---

contributing/redirects.md

@@ -10,23 +10,34 @@ Within docs.github.com, you can redirect from one file to another or from one ve
 
 Sometimes we change the name of an article but want its old URL to redirect to its new URL. For these types of redirects, we use `redirect_from` frontmatter. See [/content#redirect_from](/content#redirect_from) for details.
 
+### Automatic redirects for URLs that do not include a version
+
+If a URL for a docs page is entered without a version segment (e.g., `https://docs.github.com/foo` instead of `https://docs.github.com/<version>/foo`), the site will automatically redirect it to the **first available version** of the page. The order of precedence is specified in `lib/all-versions.js`, where the current order is: 
+
+1. Free, Pro, & Team (`fpt`)
+1. Enterprise Cloud (`ghec`)
+1. Enterprise Server (`ghes`)
+1. GitHub AE (`ghae`)
+
+So if a page `foo.md` is only available in Cloud and Server, the link `https://docs.github.com/foo` will automatically redirect to `https://docs.github.com/enterprise-cloud@latest/foo` because Cloud has precedence over Server.
+
+If `foo.md` is available in Free, Pro, & Team, no redirect will occur because `fpt` pages do not have a version segment, so the `fpt` content at `https://docs.github.com/foo` will render.
+
 ### Redirects across versions
 
-If you want the URL for one version of an article to redirect to the URL for another version, you must use [/lib/redirects/static/redirect-exceptions.txt](/lib/redirects/static/redirect-exceptions.txt) instead. For example, if you remove the Free, Pro, & Team (`fpt`) version of an article, to prevent 404s, the URL for the `fpt` version should redirect to a version of the article that still exists.
+If you want the URL for one version of an article to redirect to a URL for another version, you must use [/lib/redirects/static/redirect-exceptions.txt](/lib/redirects/static/redirect-exceptions.txt) instead. For example, if you remove the Free, Pro, & Team (`fpt`) version of an article, the URL will [automatically redirect](#automatic-redirects-for-urls-that-do-not-include-a-version) to the next available version of the page. If you want it to redirect to a version that is **lower in the order of precedence**, or to a different page entirely, you must specify an exception.
+
+Another example: we removed the `ghes` version of "[Exporting member information for your organization](https://docs.github.com/en/organizations/managing-membership-in-your-organization/exporting-member-information-for-your-organization)," but we don't want URLs that include the `enterprise-server@<release>` version segment to 404. In order to redirect `ghes` URLs to another version (such as `ghec`), we need to add an exception.
 
-Each entry in this file should start with the path you want to redirect _to_, including the version, followed by an unordered list of the paths you want to redirect _from_. For example, if you removed the `fpt` version of "[Cloning a repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository)", you would redirect folks who attempt to access that path to the `ghec` version with the following entry.
+Each entry in [the exceptions file](/lib/redirects/static/redirect-exceptions.txt) should start with the path you want to redirect _to_, including the version, followed by an unordered list of the paths you want to redirect _from_:
 
 ```
-/enterprise-cloud@latest/repositories/creating-and-managing-repositories/cloning-a-repository
-- /articles/cloning-a-repository
-- /articles/cloning-a-repository-from-github
-- /github/creating-cloning-and-archiving-repositories/cloning-a-repository
-- /github/creating-cloning-and-archiving-repositories/cloning-a-repository-from-github/cloning-a-repository
-- /repositories/creating-and-managing-repositories/cloning-a-repository
+/enterprise-cloud@latest/organizations/managing-membership-in-your-organization/exporting-member-information-for-your-organization
+  - /[email protected]/organizations/managing-membership-in-your-organization/exporting-member-information-for-your-organization
+  - /[email protected]/organizations/managing-membership-in-your-organization/exporting-member-information-for-your-organization
+  - /[email protected]/organizations/managing-membership-in-your-organization/exporting-member-information-for-your-organization
 ```
 
-Note that you must add redirects for both the current `fpt` path and any previous `fpt` paths.
-
 ## External redirects
 
 Sometimes the canonical home of some content moves outside the help site. For these types of redirects, we add entries to [/lib/redirects/external-sites.json](/lib/redirects/external-sites.json).

data/graphql/ghec/schema.docs.graphql

@@ -25330,6 +25330,11 @@ type Organization implements Actor & MemberStatusable & Node & PackageOwner & Pr
   Events involving this sponsorable, such as new sponsorships.
   """
   sponsorsActivities(
+    """
+    Filter activities to only the specified actions.
+    """
+    actions: [SponsorsActivityAction!] = []
+
     """
     Returns the elements in the list that come after the specified cursor.
     """
@@ -25356,7 +25361,8 @@ type Organization implements Actor & MemberStatusable & Node & PackageOwner & Pr
     orderBy: SponsorsActivityOrder = {field: TIMESTAMP, direction: DESC}
 
     """
-    Filter activities returned to only those that occurred in a given time range.
+    Filter activities returned to only those that occurred in the most recent
+    specified time period. Set to ALL to avoid filtering by when the activity occurred.
     """
     period: SponsorsActivityPeriod = MONTH
   ): SponsorsActivityConnection!
@@ -29814,6 +29820,16 @@ type ProjectV2Item implements Node {
   """
   databaseId: Int
 
+  """
+  A specific field value given a field name
+  """
+  fieldValueByName(
+    """
+    The name of the field to return the field value of
+    """
+    name: String!
+  ): ProjectV2ItemFieldValue
+
   """
   List of field values
   """
@@ -43671,6 +43687,11 @@ interface Sponsorable {
   Events involving this sponsorable, such as new sponsorships.
   """
   sponsorsActivities(
+    """
+    Filter activities to only the specified actions.
+    """
+    actions: [SponsorsActivityAction!] = []
+
     """
     Returns the elements in the list that come after the specified cursor.
     """
@@ -43697,7 +43718,8 @@ interface Sponsorable {
     orderBy: SponsorsActivityOrder = {field: TIMESTAMP, direction: DESC}
 
     """
-    Filter activities returned to only those that occurred in a given time range.
+    Filter activities returned to only those that occurred in the most recent
+    specified time period. Set to ALL to avoid filtering by when the activity occurred.
     """
     period: SponsorsActivityPeriod = MONTH
   ): SponsorsActivityConnection!
@@ -52049,6 +52071,11 @@ type User implements Actor & Node & PackageOwner & ProfileOwner & ProjectNextOwn
   Events involving this sponsorable, such as new sponsorships.
   """
   sponsorsActivities(
+    """
+    Filter activities to only the specified actions.
+    """
+    actions: [SponsorsActivityAction!] = []
+
     """
     Returns the elements in the list that come after the specified cursor.
     """
@@ -52075,7 +52102,8 @@ type User implements Actor & Node & PackageOwner & ProfileOwner & ProjectNextOwn
     orderBy: SponsorsActivityOrder = {field: TIMESTAMP, direction: DESC}
 
     """
-    Filter activities returned to only those that occurred in a given time range.
+    Filter activities returned to only those that occurred in the most recent
+    specified time period. Set to ALL to avoid filtering by when the activity occurred.
     """
     period: SponsorsActivityPeriod = MONTH
   ): SponsorsActivityConnection!

data/graphql/schema.docs.graphql

@@ -25330,6 +25330,11 @@ type Organization implements Actor & MemberStatusable & Node & PackageOwner & Pr
   Events involving this sponsorable, such as new sponsorships.
   """
   sponsorsActivities(
+    """
+    Filter activities to only the specified actions.
+    """
+    actions: [SponsorsActivityAction!] = []
+
     """
     Returns the elements in the list that come after the specified cursor.
     """
@@ -25356,7 +25361,8 @@ type Organization implements Actor & MemberStatusable & Node & PackageOwner & Pr
     orderBy: SponsorsActivityOrder = {field: TIMESTAMP, direction: DESC}
 
     """
-    Filter activities returned to only those that occurred in a given time range.
+    Filter activities returned to only those that occurred in the most recent
+    specified time period. Set to ALL to avoid filtering by when the activity occurred.
     """
     period: SponsorsActivityPeriod = MONTH
   ): SponsorsActivityConnection!
@@ -29814,6 +29820,16 @@ type ProjectV2Item implements Node {
   """
   databaseId: Int
 
+  """
+  A specific field value given a field name
+  """
+  fieldValueByName(
+    """
+    The name of the field to return the field value of
+    """
+    name: String!
+  ): ProjectV2ItemFieldValue
+
   """
   List of field values
   """
@@ -43671,6 +43687,11 @@ interface Sponsorable {
   Events involving this sponsorable, such as new sponsorships.
   """
   sponsorsActivities(
+    """
+    Filter activities to only the specified actions.
+    """
+    actions: [SponsorsActivityAction!] = []
+
     """
     Returns the elements in the list that come after the specified cursor.
     """
@@ -43697,7 +43718,8 @@ interface Sponsorable {
     orderBy: SponsorsActivityOrder = {field: TIMESTAMP, direction: DESC}
 
     """
-    Filter activities returned to only those that occurred in a given time range.
+    Filter activities returned to only those that occurred in the most recent
+    specified time period. Set to ALL to avoid filtering by when the activity occurred.
     """
     period: SponsorsActivityPeriod = MONTH
   ): SponsorsActivityConnection!
@@ -52049,6 +52071,11 @@ type User implements Actor & Node & PackageOwner & ProfileOwner & ProjectNextOwn
   Events involving this sponsorable, such as new sponsorships.
   """
   sponsorsActivities(
+    """
+    Filter activities to only the specified actions.
+    """
+    actions: [SponsorsActivityAction!] = []
+
     """
     Returns the elements in the list that come after the specified cursor.
     """
@@ -52075,7 +52102,8 @@ type User implements Actor & Node & PackageOwner & ProfileOwner & ProjectNextOwn
     orderBy: SponsorsActivityOrder = {field: TIMESTAMP, direction: DESC}
 
     """
-    Filter activities returned to only those that occurred in a given time range.
+    Filter activities returned to only those that occurred in the most recent
+    specified time period. Set to ALL to avoid filtering by when the activity occurred.
     """
     period: SponsorsActivityPeriod = MONTH
   ): SponsorsActivityConnection!

lib/all-versions.js

@@ -6,6 +6,13 @@ import enterpriseServerReleases from './enterprise-server-releases.js'
 const versionDelimiter = '@'
 const latestNonNumberedRelease = 'latest'
 
+// !Explanation of versionless redirect fallbacks!
+// This array is **in order** of the versions the site should try to fall back to if
+// no version is provided in a URL. For example, if /foo refers to a page that is available
+// in all versions, we should not redirect it (because /foo is the correct FPT versioned URL).
+// But if /foo refers to a page that is only available in GHEC and GHES, we should redirect it
+// to /enterprise-cloud@latest/foo (since GHEC comes first in the hierarchy of version fallbacks).
+// The implementation lives in lib/redirects/permalinks.js.
 const plans = [
   {
     // free-pro-team is **not** a user-facing version and is stripped from URLs.

lib/frontmatter.js

@@ -68,7 +68,7 @@ export const schema = {
       message: 'must be the filename of an existing layout file, or `false` for no layout',
     },
     redirect_from: {
-      type: ['array', 'string'],
+      type: 'array',
     },
     allowTitleToDifferFromFilename: {
       type: 'boolean',

lib/graphql/static/changelog.json

@@ -1,4 +1,20 @@
 [
+  {
+    "schemaChanges": [
+      {
+        "title": "The GraphQL schema includes these changes:",
+        "changes": [
+          "Argument 'actions: [SponsorsActivityAction!]` added to field `Organization.sponsorsActivities'",
+          "Field `fieldValueByName` was added to object type 'ProjectV2Item'",
+          "Argument 'actions: [SponsorsActivityAction!]` added to field `Sponsorable.sponsorsActivities'",
+          "Argument 'actions: [SponsorsActivityAction!]` added to field `User.sponsorsActivities'"
+        ]
+      }
+    ],
+    "previewChanges": [],
+    "upcomingChanges": [],
+    "date": "2022-07-22"
+  },
   {
     "schemaChanges": [
       {