Field databaseId was added to object type PinnedIssueComment
",
+ "
Field fullDatabaseId was added to object type PinnedIssueComment
",
+ "
Field id was added to object type PinnedIssueComment
",
+ "
Field issue was added to object type PinnedIssueComment
",
+ "
Field issueComment was added to object type PinnedIssueComment
",
+ "
Field pinnedAt was added to object type PinnedIssueComment
",
+ "
Field pinnedBy was added to object type PinnedIssueComment
",
+ "
Type 'ProjectV2IssueFieldValues' was added
",
+ "
Member IssueFieldDateValue was added to Union type 'ProjectV2IssueFieldValues'
",
+ "
Member IssueFieldNumberValue was added to Union type 'ProjectV2IssueFieldValues'
",
+ "
Member IssueFieldSingleSelectValue was added to Union type 'ProjectV2IssueFieldValues'
",
+ "
Member IssueFieldTextValue was added to Union type 'ProjectV2IssueFieldValues'
",
+ "
Type 'ProjectV2ItemIssueFieldValue' was added
",
+ "
Field field was added to object type 'ProjectV2ItemIssueFieldValue'
",
+ "
Field issueFieldValue was added to object type 'ProjectV2ItemIssueFieldValue'
",
+ "
Type SetIssueFieldValueInput was added
",
+ "
Input field clientMutationId of type String was added to input object type SetIssueFieldValueInput
",
+ "
Input field issueFields of type '[IssueFieldCreateOrUpdateInput!]!was added to input object typeSetIssueFieldValueInput'
",
+ "
Input field issueId of type ID! was added to input object type SetIssueFieldValueInput
",
+ "
Type SetIssueFieldValuePayload was added
",
+ "
Field clientMutationId was added to object type SetIssueFieldValuePayload
",
+ "
Field issue was added to object type SetIssueFieldValuePayload
",
+ "
Field issueFieldValues was added to object type SetIssueFieldValuePayload
",
+ "
Type UnpinIssueCommentInput was added
",
+ "
Input field clientMutationId of type String was added to input object type UnpinIssueCommentInput
",
+ "
Input field issueCommentId of type ID! was added to input object type UnpinIssueCommentInput
",
+ "
Type UnpinIssueCommentPayload was added
",
+ "
Field clientMutationId was added to object type UnpinIssueCommentPayload
",
+ "
Field issueComment was added to object type UnpinIssueCommentPayload
",
+ "
Type UpdateIssueFieldInput was added
",
+ "
Input field clientMutationId of type String was added to input object type UpdateIssueFieldInput
",
+ "
Input field description of type String was added to input object type UpdateIssueFieldInput
",
+ "
Input field id of type ID! was added to input object type UpdateIssueFieldInput
",
+ "
Input field name of type String was added to input object type UpdateIssueFieldInput
",
+ "
Input field options of type '[IssueFieldSingleSelectOptionInput!]was added to input object typeUpdateIssueFieldInput'
",
+ "
Input field visibility of type IssueFieldVisibility was added to input object type UpdateIssueFieldInput
",
+ "
Type UpdateIssueFieldPayload was added
",
+ "
Field clientMutationId was added to object type UpdateIssueFieldPayload
",
+ "
Field issueField was added to object type UpdateIssueFieldPayload
",
+ "
Type UpdateIssueFieldValueInput was added
",
+ "
Input field clientMutationId of type String was added to input object type UpdateIssueFieldValueInput
",
+ "
Input field issueField of type IssueFieldCreateOrUpdateInput! was added to input object type UpdateIssueFieldValueInput
",
+ "
Input field issueId of type ID! was added to input object type UpdateIssueFieldValueInput
",
+ "
Type UpdateIssueFieldValuePayload was added
",
+ "
Field clientMutationId was added to object type UpdateIssueFieldValuePayload
",
+ "
Field issue was added to object type UpdateIssueFieldValuePayload
",
+ "
Field issueFieldValue was added to object type UpdateIssueFieldValuePayload
",
+ "
Input field issueFields of type '[IssueFieldCreateOrUpdateInput!]was added to input object typeCreateIssueInput'
",
+ "
Field issueFieldValues was added to object type Issue
",
+ "
Argument after: String added to field Issue.issueFieldValues
",
+ "
Argument before: String added to field Issue.issueFieldValues
",
+ "
Argument first: Int added to field Issue.issueFieldValues
",
+ "
Argument last: Int added to field Issue.issueFieldValues
",
+ "
Field pinnedIssueComment was added to object type Issue
",
+ "
IssueComment object implements Pinnable interface
",
+ "
Field isPinned was added to object type IssueComment
",
+ "
Field pinnedAt was added to object type IssueComment
",
+ "
Field pinnedBy was added to object type IssueComment
",
+ "
Field viewerCanPin was added to object type IssueComment
",
+ "
Field viewerCanUnpin was added to object type IssueComment
",
+ "
Member IssueCommentPinnedEvent was added to Union type IssueTimelineItems
",
+ "
Member IssueCommentUnpinnedEvent was added to Union type IssueTimelineItems
",
+ "
Field pinnedFields was added to object type IssueType
",
+ "
Field createIssueField was added to object type Mutation
",
+ "
Argument input: CreateIssueFieldInput! added to field Mutation.createIssueField
",
+ "
Field createIssueFieldValue was added to object type Mutation
",
+ "
Argument input: CreateIssueFieldValueInput! added to field Mutation.createIssueFieldValue
",
+ "
Field 'createProjectV2IssueFieldwas added to object typeMutation'
",
+ "
Argument 'input: CreateProjectV2IssueFieldInput!added to fieldMutation.createProjectV2IssueField'
",
+ "
Field deleteIssueField was added to object type Mutation
",
+ "
Argument input: DeleteIssueFieldInput! added to field Mutation.deleteIssueField
",
+ "
Field deleteIssueFieldValue was added to object type Mutation
",
+ "
Argument input: DeleteIssueFieldValueInput! added to field Mutation.deleteIssueFieldValue
",
+ "
Field pinIssueComment was added to object type Mutation
",
+ "
Argument input: PinIssueCommentInput! added to field Mutation.pinIssueComment
",
+ "
Field setIssueFieldValue was added to object type Mutation
",
+ "
Argument input: SetIssueFieldValueInput! added to field Mutation.setIssueFieldValue
",
+ "
Field unpinIssueComment was added to object type Mutation
",
+ "
Argument input: UnpinIssueCommentInput! added to field Mutation.unpinIssueComment
",
+ "
Field updateIssueField was added to object type Mutation
",
+ "
Argument input: UpdateIssueFieldInput! added to field Mutation.updateIssueField
",
+ "
Field updateIssueFieldValue was added to object type Mutation
",
+ "
Argument input: UpdateIssueFieldValueInput! added to field Mutation.updateIssueFieldValue
",
+ "
Field issueFields was added to object type Organization
",
+ "
Argument after: String added to field Organization.issueFields
",
+ "
Argument before: String added to field Organization.issueFields
",
+ "
Argument first: Int added to field Organization.issueFields
",
+ "
Argument last: Int added to field Organization.issueFields
",
+ "
Argument orderBy: IssueFieldOrder (with default value) added to field Organization.issueFields
",
+ "
Member 'ProjectV2ItemIssueFieldValuewas added to Union typeProjectV2ItemFieldValue'
",
+ "
Member IssueCommentPinnedEvent was added to Union type PullRequestTimelineItems
",
+ "
Member IssueCommentUnpinnedEvent was added to Union type PullRequestTimelineItems
"
+ ]
+ }
+ ],
+ "previewChanges": [],
+ "upcomingChanges": [],
+ "date": "2026-03-12"
+ },
{
"schemaChanges": [
{
diff --git a/src/graphql/data/fpt/schema.docs.graphql b/src/graphql/data/fpt/schema.docs.graphql
index 586ce5c06c1c..e3a1a1179bbb 100644
--- a/src/graphql/data/fpt/schema.docs.graphql
+++ b/src/graphql/data/fpt/schema.docs.graphql
@@ -8178,6 +8178,101 @@ type CreateIpAllowListEntryPayload {
ipAllowListEntry: IpAllowListEntry
}
+"""
+Autogenerated input type of CreateIssueField
+"""
+input CreateIssueFieldInput {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The data type of the issue field.
+ """
+ dataType: IssueFieldDataType!
+
+ """
+ A description of the issue field.
+ """
+ description: String
+
+ """
+ The name of the issue field.
+ """
+ name: String!
+
+ """
+ The options for the issue field if applicable.
+ """
+ options: [IssueFieldSingleSelectOptionInput!]
+
+ """
+ The ID of the organization where the issue field will be created.
+ """
+ ownerId: ID! @possibleTypes(concreteTypes: ["Organization"])
+
+ """
+ The visibility of the issue field.
+ """
+ visibility: IssueFieldVisibility
+}
+
+"""
+Autogenerated return type of CreateIssueField.
+"""
+type CreateIssueFieldPayload {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The newly created issue field.
+ """
+ issueField: IssueFields
+}
+
+"""
+Autogenerated input type of CreateIssueFieldValue
+"""
+input CreateIssueFieldValueInput {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The field value to create.
+ """
+ issueField: IssueFieldCreateOrUpdateInput!
+
+ """
+ The ID of the issue.
+ """
+ issueId: ID! @possibleTypes(concreteTypes: ["Issue"])
+}
+
+"""
+Autogenerated return type of CreateIssueFieldValue.
+"""
+type CreateIssueFieldValuePayload {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The issue object.
+ """
+ issue: Issue
+
+ """
+ The newly created issue field value.
+ """
+ issueFieldValue: IssueFieldValue
+}
+
"""
Autogenerated input type of CreateIssue
"""
@@ -8206,6 +8301,11 @@ input CreateIssueInput {
"""
clientMutationId: String
+ """
+ An array of issue fields to set on the issue during creation
+ """
+ issueFields: [IssueFieldCreateOrUpdateInput!]
+
"""
The name of an issue template in the repository, assigns labels and assignees from the template to the issue
"""
@@ -8597,6 +8697,45 @@ input CreateProjectV2Input {
title: String!
}
+"""
+Autogenerated input type of CreateProjectV2IssueField
+"""
+input CreateProjectV2IssueFieldInput {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The ID of the IssueField to create the field for.
+ """
+ issueFieldId: ID!
+ @possibleTypes(
+ concreteTypes: ["IssueFieldDate", "IssueFieldNumber", "IssueFieldSingleSelect", "IssueFieldText"]
+ abstractType: "IssueFields"
+ )
+
+ """
+ The ID of the Project to create the field in.
+ """
+ projectId: ID! @possibleTypes(concreteTypes: ["ProjectV2"])
+}
+
+"""
+Autogenerated return type of CreateProjectV2IssueField.
+"""
+type CreateProjectV2IssueFieldPayload {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The new field.
+ """
+ projectV2Field: ProjectV2FieldConfiguration
+}
+
"""
Autogenerated return type of CreateProjectV2.
"""
@@ -10139,6 +10278,80 @@ type DeleteIssueCommentPayload {
clientMutationId: String
}
+"""
+Autogenerated input type of DeleteIssueField
+"""
+input DeleteIssueFieldInput {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The ID of the field to delete.
+ """
+ fieldId: ID!
+ @possibleTypes(
+ concreteTypes: ["IssueFieldDate", "IssueFieldNumber", "IssueFieldSingleSelect", "IssueFieldText"]
+ abstractType: "IssueFields"
+ )
+}
+
+"""
+Autogenerated return type of DeleteIssueField.
+"""
+type DeleteIssueFieldPayload {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The deleted issue field.
+ """
+ issueField: IssueFields
+}
+
+"""
+Autogenerated input type of DeleteIssueFieldValue
+"""
+input DeleteIssueFieldValueInput {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The ID of the field to delete.
+ """
+ fieldId: ID!
+
+ """
+ The ID of the issue.
+ """
+ issueId: ID! @possibleTypes(concreteTypes: ["Issue"])
+}
+
+"""
+Autogenerated return type of DeleteIssueFieldValue.
+"""
+type DeleteIssueFieldValuePayload {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The issue object.
+ """
+ issue: Issue
+
+ """
+ Whether the field value was successfully deleted.
+ """
+ success: Boolean
+}
+
"""
Autogenerated input type of DeleteIssue
"""
@@ -19184,6 +19397,31 @@ type Issue implements Assignable & Closable & Comment & Deletable & Labelable &
"""
issueDependenciesSummary: IssueDependenciesSummary!
+ """
+ Fields that are set on this issue
+ """
+ issueFieldValues(
+ """
+ Returns the elements in the list that come after the specified cursor.
+ """
+ after: String
+
+ """
+ Returns the elements in the list that come before the specified cursor.
+ """
+ before: String
+
+ """
+ Returns the first _n_ elements from the list.
+ """
+ first: Int
+
+ """
+ Returns the last _n_ elements from the list.
+ """
+ last: Int
+ ): IssueFieldValueConnection
+
"""
The issue type for this Issue
"""
@@ -19294,6 +19532,11 @@ type Issue implements Assignable & Closable & Comment & Deletable & Labelable &
last: Int
): UserConnection!
+ """
+ The pinned comment for this issue.
+ """
+ pinnedIssueComment: PinnedIssueComment
+
"""
List of project cards associated with this issue.
"""
@@ -19806,7 +20049,7 @@ enum IssueClosedStateReason {
"""
Represents a comment on an Issue.
"""
-type IssueComment implements Comment & Deletable & Minimizable & Node & Reactable & RepositoryNode & Updatable & UpdatableComment {
+type IssueComment implements Comment & Deletable & Minimizable & Node & Pinnable & Reactable & RepositoryNode & Updatable & UpdatableComment {
"""
The actor who authored the comment.
"""
@@ -19872,6 +20115,11 @@ type IssueComment implements Comment & Deletable & Minimizable & Node & Reactabl
"""
isMinimized: Boolean!
+ """
+ Indicates whether or not this entity is currently pinned.
+ """
+ isPinned: Boolean
+
"""
Identifies the issue associated with the comment.
"""
@@ -19889,6 +20137,16 @@ type IssueComment implements Comment & Deletable & Minimizable & Node & Reactabl
"""
minimizedReason: String
+ """
+ Identifies the date and time when this entity was pinned.
+ """
+ pinnedAt: DateTime
+
+ """
+ The user who pinned this entity.
+ """
+ pinnedBy: User
+
"""
Identifies when the comment was published at.
"""
@@ -19995,6 +20253,11 @@ type IssueComment implements Comment & Deletable & Minimizable & Node & Reactabl
"""
viewerCanMinimize: Boolean!
+ """
+ Check if the current viewer can pin this entity.
+ """
+ viewerCanPin: Boolean!
+
"""
Can user react to this subject
"""
@@ -20005,6 +20268,11 @@ type IssueComment implements Comment & Deletable & Minimizable & Node & Reactabl
"""
viewerCanUnminimize: Boolean!
+ """
+ Check if the current viewer can unpin this entity.
+ """
+ viewerCanUnpin: Boolean!
+
"""
Check if the current viewer can update this object.
"""
@@ -20086,6 +20354,56 @@ enum IssueCommentOrderField {
UPDATED_AT
}
+"""
+Represents a 'issue_comment_pinned' event on a given issue.
+"""
+type IssueCommentPinnedEvent implements Node {
+ """
+ Identifies the actor who performed the event.
+ """
+ actor: Actor
+
+ """
+ Identifies the date and time when the object was created.
+ """
+ createdAt: DateTime!
+
+ """
+ The Node ID of the IssueCommentPinnedEvent object
+ """
+ id: ID!
+
+ """
+ Identifies the issue comment associated with the 'issue_comment_pinned' event.
+ """
+ issueComment: IssueComment
+}
+
+"""
+Represents a 'issue_comment_unpinned' event on a given issue.
+"""
+type IssueCommentUnpinnedEvent implements Node {
+ """
+ Identifies the actor who performed the event.
+ """
+ actor: Actor
+
+ """
+ Identifies the date and time when the object was created.
+ """
+ createdAt: DateTime!
+
+ """
+ The Node ID of the IssueCommentUnpinnedEvent object
+ """
+ id: ID!
+
+ """
+ Identifies the issue comment associated with the 'issue_comment_unpinned' event.
+ """
+ issueComment: IssueComment
+}
+
"""
The connection type for Issue.
"""
@@ -20221,6 +20539,576 @@ type IssueEdge {
node: Issue
}
+"""
+Common fields across different issue field types
+"""
+interface IssueFieldCommon {
+ """
+ The issue field's creation timestamp.
+ """
+ createdAt: DateTime!
+
+ """
+ The issue field's data type.
+ """
+ dataType: IssueFieldDataType!
+
+ """
+ The issue field's description.
+ """
+ description: String
+
+ """
+ The issue field's name.
+ """
+ name: String!
+
+ """
+ The issue field's visibility.
+ """
+ visibility: IssueFieldVisibility!
+}
+
+"""
+Represents an issue field value that must be set on an issue during issue creation
+"""
+input IssueFieldCreateOrUpdateInput {
+ """
+ The date value, for a date field
+ """
+ dateValue: String
+
+ """
+ Set to true to delete the field value
+ """
+ delete: Boolean
+
+ """
+ The ID of the issue field
+ """
+ fieldId: ID!
+
+ """
+ The numeric value, for a number field
+ """
+ numberValue: Float
+
+ """
+ The ID of the selected option, for a single select field
+ """
+ singleSelectOptionId: ID
+
+ """
+ The text value, for a text field
+ """
+ textValue: String
+}
+
+"""
+The type of an issue field.
+"""
+enum IssueFieldDataType {
+ """
+ Date
+ """
+ DATE
+
+ """
+ Number
+ """
+ NUMBER
+
+ """
+ Single Select
+ """
+ SINGLE_SELECT
+
+ """
+ Text
+ """
+ TEXT
+}
+
+"""
+Represents a date issue field.
+"""
+type IssueFieldDate implements IssueFieldCommon & Node {
+ """
+ The issue field's creation timestamp.
+ """
+ createdAt: DateTime!
+
+ """
+ The issue field's data type.
+ """
+ dataType: IssueFieldDataType!
+
+ """
+ The issue field's description.
+ """
+ description: String
+
+ """
+ The Node ID of the IssueFieldDate object
+ """
+ id: ID!
+
+ """
+ The issue field's name.
+ """
+ name: String!
+
+ """
+ The issue field's visibility.
+ """
+ visibility: IssueFieldVisibility!
+}
+
+"""
+The value of a date field in an Issue item.
+"""
+type IssueFieldDateValue implements IssueFieldValueCommon & Node {
+ """
+ The issue field that contains this value.
+ """
+ field: IssueFields
+
+ """
+ The Node ID of the IssueFieldDateValue object
+ """
+ id: ID!
+
+ """
+ Value of the field.
+ """
+ value: String!
+}
+
+"""
+Represents a number issue field.
+"""
+type IssueFieldNumber implements IssueFieldCommon & Node {
+ """
+ The issue field's creation timestamp.
+ """
+ createdAt: DateTime!
+
+ """
+ The issue field's data type.
+ """
+ dataType: IssueFieldDataType!
+
+ """
+ The issue field's description.
+ """
+ description: String
+
+ """
+ The Node ID of the IssueFieldNumber object
+ """
+ id: ID!
+
+ """
+ The issue field's name.
+ """
+ name: String!
+
+ """
+ The issue field's visibility.
+ """
+ visibility: IssueFieldVisibility!
+}
+
+"""
+The value of a number field in an Issue item.
+"""
+type IssueFieldNumberValue implements IssueFieldValueCommon & Node {
+ """
+ The issue field that contains this value.
+ """
+ field: IssueFields
+
+ """
+ The Node ID of the IssueFieldNumberValue object
+ """
+ id: ID!
+
+ """
+ Value of the field.
+ """
+ value: Float!
+}
+
+"""
+Ordering options for issue field connections
+"""
+input IssueFieldOrder {
+ """
+ The ordering direction.
+ """
+ direction: OrderDirection!
+
+ """
+ The field to order issue fields by.
+ """
+ field: IssueFieldOrderField!
+}
+
+"""
+Properties by which issue field connections can be ordered.
+"""
+enum IssueFieldOrderField {
+ """
+ Order issue fields by creation time
+ """
+ CREATED_AT
+
+ """
+ Order issue fields by name
+ """
+ NAME
+}
+
+"""
+Represents a single select issue field.
+"""
+type IssueFieldSingleSelect implements IssueFieldCommon & Node {
+ """
+ The issue field's creation timestamp.
+ """
+ createdAt: DateTime!
+
+ """
+ The issue field's data type.
+ """
+ dataType: IssueFieldDataType!
+
+ """
+ The issue field's description.
+ """
+ description: String
+
+ """
+ The Node ID of the IssueFieldSingleSelect object
+ """
+ id: ID!
+
+ """
+ The issue field's name.
+ """
+ name: String!
+
+ """
+ Options for the single select field
+ """
+ options: [IssueFieldSingleSelectOption!]!
+
+ """
+ The issue field's visibility.
+ """
+ visibility: IssueFieldVisibility!
+}
+
+"""
+Represents an option in a single-select issue field.
+"""
+type IssueFieldSingleSelectOption implements Node {
+ """
+ The option's display color.
+ """
+ color: IssueFieldSingleSelectOptionColor!
+
+ """
+ The option's plain-text description.
+ """
+ description: String
+
+ """
+ The Node ID of the IssueFieldSingleSelectOption object
+ """
+ id: ID!
+
+ """
+ The option's name.
+ """
+ name: String!
+
+ """
+ The option's priority order.
+ """
+ priority: Int
+}
+
+"""
+The display color of a single-select field option.
+"""
+enum IssueFieldSingleSelectOptionColor {
+ """
+ blue
+ """
+ BLUE
+
+ """
+ gray
+ """
+ GRAY
+
+ """
+ green
+ """
+ GREEN
+
+ """
+ orange
+ """
+ ORANGE
+
+ """
+ pink
+ """
+ PINK
+
+ """
+ purple
+ """
+ PURPLE
+
+ """
+ red
+ """
+ RED
+
+ """
+ yellow
+ """
+ YELLOW
+}
+
+"""
+A single selection option for an issue field.
+"""
+input IssueFieldSingleSelectOptionInput {
+ """
+ The color associated with the option.
+ """
+ color: IssueFieldSingleSelectOptionColor!
+
+ """
+ A description of the option.
+ """
+ description: String
+
+ """
+ The name of the option.
+ """
+ name: String!
+
+ """
+ The priority of the option in the list.
+ """
+ priority: Int!
+}
+
+"""
+The value of a single select field in an Issue item.
+"""
+type IssueFieldSingleSelectValue implements IssueFieldValueCommon & Node {
+ """
+ The option's display color.
+ """
+ color: IssueFieldSingleSelectOptionColor!
+
+ """
+ The option's plain-text description.
+ """
+ description: String
+
+ """
+ The issue field that contains this value.
+ """
+ field: IssueFields
+
+ """
+ The Node ID of the IssueFieldSingleSelectValue object
+ """
+ id: ID!
+
+ """
+ The option's name.
+ """
+ name: String!
+}
+
+"""
+Represents a text issue field.
+"""
+type IssueFieldText implements IssueFieldCommon & Node {
+ """
+ The issue field's creation timestamp.
+ """
+ createdAt: DateTime!
+
+ """
+ The issue field's data type.
+ """
+ dataType: IssueFieldDataType!
+
+ """
+ The issue field's description.
+ """
+ description: String
+
+ """
+ The Node ID of the IssueFieldText object
+ """
+ id: ID!
+
+ """
+ The issue field's name.
+ """
+ name: String!
+
+ """
+ The issue field's visibility.
+ """
+ visibility: IssueFieldVisibility!
+}
+
+"""
+The value of a text field in an Issue item.
+"""
+type IssueFieldTextValue implements IssueFieldValueCommon & Node {
+ """
+ The issue field that contains this value.
+ """
+ field: IssueFields
+
+ """
+ The Node ID of the IssueFieldTextValue object
+ """
+ id: ID!
+
+ """
+ Value of the field.
+ """
+ value: String!
+}
+
+"""
+Issue field values
+"""
+union IssueFieldValue = IssueFieldDateValue | IssueFieldNumberValue | IssueFieldSingleSelectValue | IssueFieldTextValue
+
+"""
+Common fields across different issue field value types
+"""
+interface IssueFieldValueCommon {
+ """
+ The issue field that contains this value.
+ """
+ field: IssueFields
+}
+
+"""
+The connection type for IssueFieldValue.
+"""
+type IssueFieldValueConnection {
+ """
+ A list of edges.
+ """
+ edges: [IssueFieldValueEdge]
+
+ """
+ A list of nodes.
+ """
+ nodes: [IssueFieldValue]
+
+ """
+ Information to aid in pagination.
+ """
+ pageInfo: PageInfo!
+
+ """
+ Identifies the total count of items in the connection.
+ """
+ totalCount: Int!
+}
+
+"""
+An edge in a connection.
+"""
+type IssueFieldValueEdge {
+ """
+ A cursor for use in pagination.
+ """
+ cursor: String!
+
+ """
+ The item at the end of the edge.
+ """
+ node: IssueFieldValue
+}
+
+"""
+The visibility of an issue field.
+"""
+enum IssueFieldVisibility {
+ """
+ All
+ """
+ ALL
+
+ """
+ Org Only
+ """
+ ORG_ONLY
+}
+
+"""
+Possible issue fields.
+"""
+union IssueFields = IssueFieldDate | IssueFieldNumber | IssueFieldSingleSelect | IssueFieldText
+
+"""
+The connection type for IssueFields.
+"""
+type IssueFieldsConnection {
+ """
+ A list of edges.
+ """
+ edges: [IssueFieldsEdge]
+
+ """
+ A list of nodes.
+ """
+ nodes: [IssueFields]
+
+ """
+ Information to aid in pagination.
+ """
+ pageInfo: PageInfo!
+
+ """
+ Identifies the total count of items in the connection.
+ """
+ totalCount: Int!
+}
+
+"""
+An edge in a connection.
+"""
+type IssueFieldsEdge {
+ """
+ A cursor for use in pagination.
+ """
+ cursor: String!
+
+ """
+ The item at the end of the edge.
+ """
+ node: IssueFields
+}
+
"""
Ways in which to filter lists of issues.
"""
@@ -20536,6 +21424,8 @@ union IssueTimelineItems =
| DemilestonedEvent
| DisconnectedEvent
| IssueComment
+ | IssueCommentPinnedEvent
+ | IssueCommentUnpinnedEvent
| IssueTypeAddedEvent
| IssueTypeChangedEvent
| IssueTypeRemovedEvent
@@ -20967,6 +21857,11 @@ type IssueType implements Node {
The issue type's name.
"""
name: String!
+
+ """
+ An ordered list of issue fields pinned to this type.
+ """
+ pinnedFields: [IssueFields!]
}
"""
@@ -25218,6 +26113,26 @@ type Mutation {
input: CreateIssueInput!
): CreateIssuePayload
+ """
+ Creates a new issue field.
+ """
+ createIssueField(
+ """
+ Parameters for CreateIssueField
+ """
+ input: CreateIssueFieldInput!
+ ): CreateIssueFieldPayload
+
+ """
+ Creates a new issue field value for an issue.
+ """
+ createIssueFieldValue(
+ """
+ Parameters for CreateIssueFieldValue
+ """
+ input: CreateIssueFieldValueInput!
+ ): CreateIssueFieldValuePayload
+
"""
Creates a new issue type
"""
@@ -25291,6 +26206,16 @@ type Mutation {
input: CreateProjectV2FieldInput!
): CreateProjectV2FieldPayload
+ """
+ Create a new project issue field.
+ """
+ createProjectV2IssueField(
+ """
+ Parameters for CreateProjectV2IssueField
+ """
+ input: CreateProjectV2IssueFieldInput!
+ ): CreateProjectV2IssueFieldPayload
+
"""
Creates a status update within a Project.
"""
@@ -25492,6 +26417,26 @@ type Mutation {
input: DeleteIssueCommentInput!
): DeleteIssueCommentPayload
+ """
+ Deletes an issue field.
+ """
+ deleteIssueField(
+ """
+ Parameters for DeleteIssueField
+ """
+ input: DeleteIssueFieldInput!
+ ): DeleteIssueFieldPayload
+
+ """
+ Deletes an issue field value from an issue.
+ """
+ deleteIssueFieldValue(
+ """
+ Parameters for DeleteIssueFieldValue
+ """
+ input: DeleteIssueFieldValueInput!
+ ): DeleteIssueFieldValuePayload
+
"""
Delete an issue type
"""
@@ -25983,6 +26928,16 @@ type Mutation {
input: PinIssueInput!
): PinIssuePayload
+ """
+ Pins an Issue Comment.
+ """
+ pinIssueComment(
+ """
+ Parameters for PinIssueComment
+ """
+ input: PinIssueCommentInput!
+ ): PinIssueCommentPayload
+
"""
Promote a repository custom property to the enterprise level.
"""
@@ -26314,6 +27269,16 @@ type Mutation {
input: SetEnterpriseIdentityProviderInput!
): SetEnterpriseIdentityProviderPayload
+ """
+ Sets the value of an IssueFieldValue.
+ """
+ setIssueFieldValue(
+ """
+ Parameters for SetIssueFieldValue
+ """
+ input: SetIssueFieldValueInput!
+ ): SetIssueFieldValuePayload
+
"""
Set an organization level interaction limit for an organization's public repositories.
"""
@@ -26547,6 +27512,16 @@ type Mutation {
input: UnpinIssueInput!
): UnpinIssuePayload
+ """
+ Unpins an Issue Comment.
+ """
+ unpinIssueComment(
+ """
+ Parameters for UnpinIssueComment
+ """
+ input: UnpinIssueCommentInput!
+ ): UnpinIssueCommentPayload
+
"""
Marks a review thread as unresolved.
"""
@@ -26857,6 +27832,26 @@ type Mutation {
input: UpdateIssueCommentInput!
): UpdateIssueCommentPayload
+ """
+ Updates an issue field.
+ """
+ updateIssueField(
+ """
+ Parameters for UpdateIssueField
+ """
+ input: UpdateIssueFieldInput!
+ ): UpdateIssueFieldPayload
+
+ """
+ Updates an existing issue field value for an issue.
+ """
+ updateIssueFieldValue(
+ """
+ Parameters for UpdateIssueFieldValue
+ """
+ input: UpdateIssueFieldValueInput!
+ ): UpdateIssueFieldValuePayload
+
"""
Updates the issue type on an issue
"""
@@ -32762,6 +33757,36 @@ type Organization implements Actor & MemberStatusable & Node & PackageOwner & Pr
"""
isVerified: Boolean!
+ """
+ A list of the organization's issue fields
+ """
+ issueFields(
+ """
+ Returns the elements in the list that come after the specified cursor.
+ """
+ after: String
+
+ """
+ Returns the elements in the list that come before the specified cursor.
+ """
+ before: String
+
+ """
+ Returns the first _n_ elements from the list.
+ """
+ first: Int
+
+ """
+ Returns the last _n_ elements from the list.
+ """
+ last: Int
+
+ """
+ Ordering options for issue fields returned from the connection.
+ """
+ orderBy: IssueFieldOrder = {field: CREATED_AT, direction: ASC}
+ ): IssueFieldsConnection
+
"""
A list of the organization's issue types
"""
@@ -35608,6 +36633,36 @@ type PinEnvironmentPayload {
pinnedEnvironment: PinnedEnvironment
}
+"""
+Autogenerated input type of PinIssueComment
+"""
+input PinIssueCommentInput {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The ID of the Issue Comment to pin. Comment pinning is not supported on Pull Requests.
+ """
+ issueCommentId: ID! @possibleTypes(concreteTypes: ["IssueComment"])
+}
+
+"""
+Autogenerated return type of PinIssueComment.
+"""
+type PinIssueCommentPayload {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The Issue Comment that was pinned
+ """
+ issueComment: IssueComment
+}
+
"""
Autogenerated input type of PinIssue
"""
@@ -35638,6 +36693,36 @@ type PinIssuePayload {
issue: Issue
}
+"""
+Entities that can be pinned.
+"""
+interface Pinnable {
+ """
+ Indicates whether or not this entity is currently pinned.
+ """
+ isPinned: Boolean
+
+ """
+ Identifies the date and time when this entity was pinned.
+ """
+ pinnedAt: DateTime
+
+ """
+ The user who pinned this entity.
+ """
+ pinnedBy: User
+
+ """
+ Check if the current viewer can pin this entity.
+ """
+ viewerCanPin: Boolean!
+
+ """
+ Check if the current viewer can unpin this entity.
+ """
+ viewerCanUnpin: Boolean!
+}
+
"""
Types that can be pinned to a profile page.
"""
@@ -36048,6 +37133,46 @@ type PinnedIssue implements Node {
repository: Repository!
}
+"""
+A comment pinned to an Issue.
+"""
+type PinnedIssueComment implements Node {
+ """
+ Identifies the primary key from the database.
+ """
+ databaseId: Int
+
+ """
+ Identifies the primary key from the database as a BigInt.
+ """
+ fullDatabaseId: BigInt
+
+ """
+ The Node ID of the PinnedIssueComment object
+ """
+ id: ID!
+
+ """
+ The issue that this comment belongs to.
+ """
+ issue: Issue!
+
+ """
+ The comment that was pinned.
+ """
+ issueComment: IssueComment!
+
+ """
+ Identifies when the comment was pinned.
+ """
+ pinnedAt: DateTime!
+
+ """
+ The actor that pinned this comment.
+ """
+ pinnedBy: Actor!
+}
+
"""
The connection type for PinnedIssue.
"""
@@ -38322,6 +39447,15 @@ input ProjectV2Filters {
state: ProjectV2State
}
+"""
+Possible issue field values for a Project item.
+"""
+union ProjectV2IssueFieldValues =
+ | IssueFieldDateValue
+ | IssueFieldNumberValue
+ | IssueFieldSingleSelectValue
+ | IssueFieldTextValue
+
"""
An item within a Project.
"""
@@ -38925,6 +40059,7 @@ union ProjectV2ItemFieldValue =
| ProjectV2ItemFieldSingleSelectValue
| ProjectV2ItemFieldTextValue
| ProjectV2ItemFieldUserValue
+ | ProjectV2ItemIssueFieldValue
"""
Common fields across different project field value types
@@ -39031,6 +40166,21 @@ enum ProjectV2ItemFieldValueOrderField {
POSITION
}
+"""
+The value of an issue field in a Project item.
+"""
+type ProjectV2ItemIssueFieldValue {
+ """
+ Field that contains this value.
+ """
+ field: ProjectV2FieldConfiguration!
+
+ """
+ Value of the Issue Field
+ """
+ issueFieldValue: ProjectV2IssueFieldValues
+}
+
"""
Ordering options for project v2 item connections
"""
@@ -43441,6 +44591,8 @@ union PullRequestTimelineItems =
| HeadRefForcePushedEvent
| HeadRefRestoredEvent
| IssueComment
+ | IssueCommentPinnedEvent
+ | IssueCommentUnpinnedEvent
| IssueTypeAddedEvent
| IssueTypeChangedEvent
| IssueTypeRemovedEvent
@@ -56767,6 +57919,46 @@ type SetEnterpriseIdentityProviderPayload {
identityProvider: EnterpriseIdentityProvider
}
+"""
+Autogenerated input type of SetIssueFieldValue
+"""
+input SetIssueFieldValueInput {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The issue fields to set on the issue
+ """
+ issueFields: [IssueFieldCreateOrUpdateInput!]!
+
+ """
+ The ID of the Issue to set the field value on.
+ """
+ issueId: ID! @possibleTypes(concreteTypes: ["Issue"])
+}
+
+"""
+Autogenerated return type of SetIssueFieldValue.
+"""
+type SetIssueFieldValuePayload {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The issue where the field values were set.
+ """
+ issue: Issue
+
+ """
+ The issue field values that were created or updated.
+ """
+ issueFieldValues: [IssueFieldValue!]
+}
+
"""
Autogenerated input type of SetOrganizationInteractionLimit
"""
@@ -64047,6 +65239,36 @@ type UnminimizeCommentPayload {
unminimizedComment: Minimizable
}
+"""
+Autogenerated input type of UnpinIssueComment
+"""
+input UnpinIssueCommentInput {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The ID of the Issue Comment to unpin. Comment pinning is not supported on Pull Requests.
+ """
+ issueCommentId: ID! @possibleTypes(concreteTypes: ["IssueComment"])
+}
+
+"""
+Autogenerated return type of UnpinIssueComment.
+"""
+type UnpinIssueCommentPayload {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The Issue Comment that was unpinned
+ """
+ issueComment: IssueComment
+}
+
"""
Autogenerated input type of UnpinIssue
"""
@@ -65534,6 +66756,100 @@ type UpdateIssueCommentPayload {
issueComment: IssueComment
}
+"""
+Autogenerated input type of UpdateIssueField
+"""
+input UpdateIssueFieldInput {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ A description of the issue field.
+ """
+ description: String
+
+ """
+ The ID of the issue field to update.
+ """
+ id: ID!
+ @possibleTypes(
+ concreteTypes: ["IssueFieldDate", "IssueFieldNumber", "IssueFieldSingleSelect", "IssueFieldText"]
+ abstractType: "IssueFields"
+ )
+
+ """
+ The name of the issue field.
+ """
+ name: String
+
+ """
+ The options for the issue field if applicable.
+ """
+ options: [IssueFieldSingleSelectOptionInput!]
+
+ """
+ The visibility of the issue field.
+ """
+ visibility: IssueFieldVisibility
+}
+
+"""
+Autogenerated return type of UpdateIssueField.
+"""
+type UpdateIssueFieldPayload {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The updated issue field.
+ """
+ issueField: IssueFields
+}
+
+"""
+Autogenerated input type of UpdateIssueFieldValue
+"""
+input UpdateIssueFieldValueInput {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The field value to update.
+ """
+ issueField: IssueFieldCreateOrUpdateInput!
+
+ """
+ The ID of the issue.
+ """
+ issueId: ID! @possibleTypes(concreteTypes: ["Issue"])
+}
+
+"""
+Autogenerated return type of UpdateIssueFieldValue.
+"""
+type UpdateIssueFieldValuePayload {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The issue object.
+ """
+ issue: Issue
+
+ """
+ The updated issue field value.
+ """
+ issueFieldValue: IssueFieldValue
+}
+
"""
Autogenerated input type of UpdateIssue
"""
diff --git a/src/graphql/data/fpt/schema.json b/src/graphql/data/fpt/schema.json
index d8e856d13e0c..98844d4d5c90 100644
--- a/src/graphql/data/fpt/schema.json
+++ b/src/graphql/data/fpt/schema.json
@@ -3077,6 +3077,82 @@
}
]
},
+ {
+ "name": "createIssueField",
+ "kind": "mutations",
+ "id": "createissuefield",
+ "href": "/graphql/reference/mutations#createissuefield",
+ "description": "
",
+ "type": "ID!",
+ "id": "id",
+ "kind": "scalars",
+ "href": "/graphql/reference/scalars#id",
+ "isDeprecated": false
+ }
+ ]
+ },
{
"name": "UpdateIssueInput",
"kind": "inputObjects",
diff --git a/src/graphql/data/ghec/schema.docs.graphql b/src/graphql/data/ghec/schema.docs.graphql
index 586ce5c06c1c..e3a1a1179bbb 100644
--- a/src/graphql/data/ghec/schema.docs.graphql
+++ b/src/graphql/data/ghec/schema.docs.graphql
@@ -8178,6 +8178,101 @@ type CreateIpAllowListEntryPayload {
ipAllowListEntry: IpAllowListEntry
}
+"""
+Autogenerated input type of CreateIssueField
+"""
+input CreateIssueFieldInput {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The data type of the issue field.
+ """
+ dataType: IssueFieldDataType!
+
+ """
+ A description of the issue field.
+ """
+ description: String
+
+ """
+ The name of the issue field.
+ """
+ name: String!
+
+ """
+ The options for the issue field if applicable.
+ """
+ options: [IssueFieldSingleSelectOptionInput!]
+
+ """
+ The ID of the organization where the issue field will be created.
+ """
+ ownerId: ID! @possibleTypes(concreteTypes: ["Organization"])
+
+ """
+ The visibility of the issue field.
+ """
+ visibility: IssueFieldVisibility
+}
+
+"""
+Autogenerated return type of CreateIssueField.
+"""
+type CreateIssueFieldPayload {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The newly created issue field.
+ """
+ issueField: IssueFields
+}
+
+"""
+Autogenerated input type of CreateIssueFieldValue
+"""
+input CreateIssueFieldValueInput {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The field value to create.
+ """
+ issueField: IssueFieldCreateOrUpdateInput!
+
+ """
+ The ID of the issue.
+ """
+ issueId: ID! @possibleTypes(concreteTypes: ["Issue"])
+}
+
+"""
+Autogenerated return type of CreateIssueFieldValue.
+"""
+type CreateIssueFieldValuePayload {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The issue object.
+ """
+ issue: Issue
+
+ """
+ The newly created issue field value.
+ """
+ issueFieldValue: IssueFieldValue
+}
+
"""
Autogenerated input type of CreateIssue
"""
@@ -8206,6 +8301,11 @@ input CreateIssueInput {
"""
clientMutationId: String
+ """
+ An array of issue fields to set on the issue during creation
+ """
+ issueFields: [IssueFieldCreateOrUpdateInput!]
+
"""
The name of an issue template in the repository, assigns labels and assignees from the template to the issue
"""
@@ -8597,6 +8697,45 @@ input CreateProjectV2Input {
title: String!
}
+"""
+Autogenerated input type of CreateProjectV2IssueField
+"""
+input CreateProjectV2IssueFieldInput {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The ID of the IssueField to create the field for.
+ """
+ issueFieldId: ID!
+ @possibleTypes(
+ concreteTypes: ["IssueFieldDate", "IssueFieldNumber", "IssueFieldSingleSelect", "IssueFieldText"]
+ abstractType: "IssueFields"
+ )
+
+ """
+ The ID of the Project to create the field in.
+ """
+ projectId: ID! @possibleTypes(concreteTypes: ["ProjectV2"])
+}
+
+"""
+Autogenerated return type of CreateProjectV2IssueField.
+"""
+type CreateProjectV2IssueFieldPayload {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The new field.
+ """
+ projectV2Field: ProjectV2FieldConfiguration
+}
+
"""
Autogenerated return type of CreateProjectV2.
"""
@@ -10139,6 +10278,80 @@ type DeleteIssueCommentPayload {
clientMutationId: String
}
+"""
+Autogenerated input type of DeleteIssueField
+"""
+input DeleteIssueFieldInput {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The ID of the field to delete.
+ """
+ fieldId: ID!
+ @possibleTypes(
+ concreteTypes: ["IssueFieldDate", "IssueFieldNumber", "IssueFieldSingleSelect", "IssueFieldText"]
+ abstractType: "IssueFields"
+ )
+}
+
+"""
+Autogenerated return type of DeleteIssueField.
+"""
+type DeleteIssueFieldPayload {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The deleted issue field.
+ """
+ issueField: IssueFields
+}
+
+"""
+Autogenerated input type of DeleteIssueFieldValue
+"""
+input DeleteIssueFieldValueInput {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The ID of the field to delete.
+ """
+ fieldId: ID!
+
+ """
+ The ID of the issue.
+ """
+ issueId: ID! @possibleTypes(concreteTypes: ["Issue"])
+}
+
+"""
+Autogenerated return type of DeleteIssueFieldValue.
+"""
+type DeleteIssueFieldValuePayload {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The issue object.
+ """
+ issue: Issue
+
+ """
+ Whether the field value was successfully deleted.
+ """
+ success: Boolean
+}
+
"""
Autogenerated input type of DeleteIssue
"""
@@ -19184,6 +19397,31 @@ type Issue implements Assignable & Closable & Comment & Deletable & Labelable &
"""
issueDependenciesSummary: IssueDependenciesSummary!
+ """
+ Fields that are set on this issue
+ """
+ issueFieldValues(
+ """
+ Returns the elements in the list that come after the specified cursor.
+ """
+ after: String
+
+ """
+ Returns the elements in the list that come before the specified cursor.
+ """
+ before: String
+
+ """
+ Returns the first _n_ elements from the list.
+ """
+ first: Int
+
+ """
+ Returns the last _n_ elements from the list.
+ """
+ last: Int
+ ): IssueFieldValueConnection
+
"""
The issue type for this Issue
"""
@@ -19294,6 +19532,11 @@ type Issue implements Assignable & Closable & Comment & Deletable & Labelable &
last: Int
): UserConnection!
+ """
+ The pinned comment for this issue.
+ """
+ pinnedIssueComment: PinnedIssueComment
+
"""
List of project cards associated with this issue.
"""
@@ -19806,7 +20049,7 @@ enum IssueClosedStateReason {
"""
Represents a comment on an Issue.
"""
-type IssueComment implements Comment & Deletable & Minimizable & Node & Reactable & RepositoryNode & Updatable & UpdatableComment {
+type IssueComment implements Comment & Deletable & Minimizable & Node & Pinnable & Reactable & RepositoryNode & Updatable & UpdatableComment {
"""
The actor who authored the comment.
"""
@@ -19872,6 +20115,11 @@ type IssueComment implements Comment & Deletable & Minimizable & Node & Reactabl
"""
isMinimized: Boolean!
+ """
+ Indicates whether or not this entity is currently pinned.
+ """
+ isPinned: Boolean
+
"""
Identifies the issue associated with the comment.
"""
@@ -19889,6 +20137,16 @@ type IssueComment implements Comment & Deletable & Minimizable & Node & Reactabl
"""
minimizedReason: String
+ """
+ Identifies the date and time when this entity was pinned.
+ """
+ pinnedAt: DateTime
+
+ """
+ The user who pinned this entity.
+ """
+ pinnedBy: User
+
"""
Identifies when the comment was published at.
"""
@@ -19995,6 +20253,11 @@ type IssueComment implements Comment & Deletable & Minimizable & Node & Reactabl
"""
viewerCanMinimize: Boolean!
+ """
+ Check if the current viewer can pin this entity.
+ """
+ viewerCanPin: Boolean!
+
"""
Can user react to this subject
"""
@@ -20005,6 +20268,11 @@ type IssueComment implements Comment & Deletable & Minimizable & Node & Reactabl
"""
viewerCanUnminimize: Boolean!
+ """
+ Check if the current viewer can unpin this entity.
+ """
+ viewerCanUnpin: Boolean!
+
"""
Check if the current viewer can update this object.
"""
@@ -20086,6 +20354,56 @@ enum IssueCommentOrderField {
UPDATED_AT
}
+"""
+Represents a 'issue_comment_pinned' event on a given issue.
+"""
+type IssueCommentPinnedEvent implements Node {
+ """
+ Identifies the actor who performed the event.
+ """
+ actor: Actor
+
+ """
+ Identifies the date and time when the object was created.
+ """
+ createdAt: DateTime!
+
+ """
+ The Node ID of the IssueCommentPinnedEvent object
+ """
+ id: ID!
+
+ """
+ Identifies the issue comment associated with the 'issue_comment_pinned' event.
+ """
+ issueComment: IssueComment
+}
+
+"""
+Represents a 'issue_comment_unpinned' event on a given issue.
+"""
+type IssueCommentUnpinnedEvent implements Node {
+ """
+ Identifies the actor who performed the event.
+ """
+ actor: Actor
+
+ """
+ Identifies the date and time when the object was created.
+ """
+ createdAt: DateTime!
+
+ """
+ The Node ID of the IssueCommentUnpinnedEvent object
+ """
+ id: ID!
+
+ """
+ Identifies the issue comment associated with the 'issue_comment_unpinned' event.
+ """
+ issueComment: IssueComment
+}
+
"""
The connection type for Issue.
"""
@@ -20221,6 +20539,576 @@ type IssueEdge {
node: Issue
}
+"""
+Common fields across different issue field types
+"""
+interface IssueFieldCommon {
+ """
+ The issue field's creation timestamp.
+ """
+ createdAt: DateTime!
+
+ """
+ The issue field's data type.
+ """
+ dataType: IssueFieldDataType!
+
+ """
+ The issue field's description.
+ """
+ description: String
+
+ """
+ The issue field's name.
+ """
+ name: String!
+
+ """
+ The issue field's visibility.
+ """
+ visibility: IssueFieldVisibility!
+}
+
+"""
+Represents an issue field value that must be set on an issue during issue creation
+"""
+input IssueFieldCreateOrUpdateInput {
+ """
+ The date value, for a date field
+ """
+ dateValue: String
+
+ """
+ Set to true to delete the field value
+ """
+ delete: Boolean
+
+ """
+ The ID of the issue field
+ """
+ fieldId: ID!
+
+ """
+ The numeric value, for a number field
+ """
+ numberValue: Float
+
+ """
+ The ID of the selected option, for a single select field
+ """
+ singleSelectOptionId: ID
+
+ """
+ The text value, for a text field
+ """
+ textValue: String
+}
+
+"""
+The type of an issue field.
+"""
+enum IssueFieldDataType {
+ """
+ Date
+ """
+ DATE
+
+ """
+ Number
+ """
+ NUMBER
+
+ """
+ Single Select
+ """
+ SINGLE_SELECT
+
+ """
+ Text
+ """
+ TEXT
+}
+
+"""
+Represents a date issue field.
+"""
+type IssueFieldDate implements IssueFieldCommon & Node {
+ """
+ The issue field's creation timestamp.
+ """
+ createdAt: DateTime!
+
+ """
+ The issue field's data type.
+ """
+ dataType: IssueFieldDataType!
+
+ """
+ The issue field's description.
+ """
+ description: String
+
+ """
+ The Node ID of the IssueFieldDate object
+ """
+ id: ID!
+
+ """
+ The issue field's name.
+ """
+ name: String!
+
+ """
+ The issue field's visibility.
+ """
+ visibility: IssueFieldVisibility!
+}
+
+"""
+The value of a date field in an Issue item.
+"""
+type IssueFieldDateValue implements IssueFieldValueCommon & Node {
+ """
+ The issue field that contains this value.
+ """
+ field: IssueFields
+
+ """
+ The Node ID of the IssueFieldDateValue object
+ """
+ id: ID!
+
+ """
+ Value of the field.
+ """
+ value: String!
+}
+
+"""
+Represents a number issue field.
+"""
+type IssueFieldNumber implements IssueFieldCommon & Node {
+ """
+ The issue field's creation timestamp.
+ """
+ createdAt: DateTime!
+
+ """
+ The issue field's data type.
+ """
+ dataType: IssueFieldDataType!
+
+ """
+ The issue field's description.
+ """
+ description: String
+
+ """
+ The Node ID of the IssueFieldNumber object
+ """
+ id: ID!
+
+ """
+ The issue field's name.
+ """
+ name: String!
+
+ """
+ The issue field's visibility.
+ """
+ visibility: IssueFieldVisibility!
+}
+
+"""
+The value of a number field in an Issue item.
+"""
+type IssueFieldNumberValue implements IssueFieldValueCommon & Node {
+ """
+ The issue field that contains this value.
+ """
+ field: IssueFields
+
+ """
+ The Node ID of the IssueFieldNumberValue object
+ """
+ id: ID!
+
+ """
+ Value of the field.
+ """
+ value: Float!
+}
+
+"""
+Ordering options for issue field connections
+"""
+input IssueFieldOrder {
+ """
+ The ordering direction.
+ """
+ direction: OrderDirection!
+
+ """
+ The field to order issue fields by.
+ """
+ field: IssueFieldOrderField!
+}
+
+"""
+Properties by which issue field connections can be ordered.
+"""
+enum IssueFieldOrderField {
+ """
+ Order issue fields by creation time
+ """
+ CREATED_AT
+
+ """
+ Order issue fields by name
+ """
+ NAME
+}
+
+"""
+Represents a single select issue field.
+"""
+type IssueFieldSingleSelect implements IssueFieldCommon & Node {
+ """
+ The issue field's creation timestamp.
+ """
+ createdAt: DateTime!
+
+ """
+ The issue field's data type.
+ """
+ dataType: IssueFieldDataType!
+
+ """
+ The issue field's description.
+ """
+ description: String
+
+ """
+ The Node ID of the IssueFieldSingleSelect object
+ """
+ id: ID!
+
+ """
+ The issue field's name.
+ """
+ name: String!
+
+ """
+ Options for the single select field
+ """
+ options: [IssueFieldSingleSelectOption!]!
+
+ """
+ The issue field's visibility.
+ """
+ visibility: IssueFieldVisibility!
+}
+
+"""
+Represents an option in a single-select issue field.
+"""
+type IssueFieldSingleSelectOption implements Node {
+ """
+ The option's display color.
+ """
+ color: IssueFieldSingleSelectOptionColor!
+
+ """
+ The option's plain-text description.
+ """
+ description: String
+
+ """
+ The Node ID of the IssueFieldSingleSelectOption object
+ """
+ id: ID!
+
+ """
+ The option's name.
+ """
+ name: String!
+
+ """
+ The option's priority order.
+ """
+ priority: Int
+}
+
+"""
+The display color of a single-select field option.
+"""
+enum IssueFieldSingleSelectOptionColor {
+ """
+ blue
+ """
+ BLUE
+
+ """
+ gray
+ """
+ GRAY
+
+ """
+ green
+ """
+ GREEN
+
+ """
+ orange
+ """
+ ORANGE
+
+ """
+ pink
+ """
+ PINK
+
+ """
+ purple
+ """
+ PURPLE
+
+ """
+ red
+ """
+ RED
+
+ """
+ yellow
+ """
+ YELLOW
+}
+
+"""
+A single selection option for an issue field.
+"""
+input IssueFieldSingleSelectOptionInput {
+ """
+ The color associated with the option.
+ """
+ color: IssueFieldSingleSelectOptionColor!
+
+ """
+ A description of the option.
+ """
+ description: String
+
+ """
+ The name of the option.
+ """
+ name: String!
+
+ """
+ The priority of the option in the list.
+ """
+ priority: Int!
+}
+
+"""
+The value of a single select field in an Issue item.
+"""
+type IssueFieldSingleSelectValue implements IssueFieldValueCommon & Node {
+ """
+ The option's display color.
+ """
+ color: IssueFieldSingleSelectOptionColor!
+
+ """
+ The option's plain-text description.
+ """
+ description: String
+
+ """
+ The issue field that contains this value.
+ """
+ field: IssueFields
+
+ """
+ The Node ID of the IssueFieldSingleSelectValue object
+ """
+ id: ID!
+
+ """
+ The option's name.
+ """
+ name: String!
+}
+
+"""
+Represents a text issue field.
+"""
+type IssueFieldText implements IssueFieldCommon & Node {
+ """
+ The issue field's creation timestamp.
+ """
+ createdAt: DateTime!
+
+ """
+ The issue field's data type.
+ """
+ dataType: IssueFieldDataType!
+
+ """
+ The issue field's description.
+ """
+ description: String
+
+ """
+ The Node ID of the IssueFieldText object
+ """
+ id: ID!
+
+ """
+ The issue field's name.
+ """
+ name: String!
+
+ """
+ The issue field's visibility.
+ """
+ visibility: IssueFieldVisibility!
+}
+
+"""
+The value of a text field in an Issue item.
+"""
+type IssueFieldTextValue implements IssueFieldValueCommon & Node {
+ """
+ The issue field that contains this value.
+ """
+ field: IssueFields
+
+ """
+ The Node ID of the IssueFieldTextValue object
+ """
+ id: ID!
+
+ """
+ Value of the field.
+ """
+ value: String!
+}
+
+"""
+Issue field values
+"""
+union IssueFieldValue = IssueFieldDateValue | IssueFieldNumberValue | IssueFieldSingleSelectValue | IssueFieldTextValue
+
+"""
+Common fields across different issue field value types
+"""
+interface IssueFieldValueCommon {
+ """
+ The issue field that contains this value.
+ """
+ field: IssueFields
+}
+
+"""
+The connection type for IssueFieldValue.
+"""
+type IssueFieldValueConnection {
+ """
+ A list of edges.
+ """
+ edges: [IssueFieldValueEdge]
+
+ """
+ A list of nodes.
+ """
+ nodes: [IssueFieldValue]
+
+ """
+ Information to aid in pagination.
+ """
+ pageInfo: PageInfo!
+
+ """
+ Identifies the total count of items in the connection.
+ """
+ totalCount: Int!
+}
+
+"""
+An edge in a connection.
+"""
+type IssueFieldValueEdge {
+ """
+ A cursor for use in pagination.
+ """
+ cursor: String!
+
+ """
+ The item at the end of the edge.
+ """
+ node: IssueFieldValue
+}
+
+"""
+The visibility of an issue field.
+"""
+enum IssueFieldVisibility {
+ """
+ All
+ """
+ ALL
+
+ """
+ Org Only
+ """
+ ORG_ONLY
+}
+
+"""
+Possible issue fields.
+"""
+union IssueFields = IssueFieldDate | IssueFieldNumber | IssueFieldSingleSelect | IssueFieldText
+
+"""
+The connection type for IssueFields.
+"""
+type IssueFieldsConnection {
+ """
+ A list of edges.
+ """
+ edges: [IssueFieldsEdge]
+
+ """
+ A list of nodes.
+ """
+ nodes: [IssueFields]
+
+ """
+ Information to aid in pagination.
+ """
+ pageInfo: PageInfo!
+
+ """
+ Identifies the total count of items in the connection.
+ """
+ totalCount: Int!
+}
+
+"""
+An edge in a connection.
+"""
+type IssueFieldsEdge {
+ """
+ A cursor for use in pagination.
+ """
+ cursor: String!
+
+ """
+ The item at the end of the edge.
+ """
+ node: IssueFields
+}
+
"""
Ways in which to filter lists of issues.
"""
@@ -20536,6 +21424,8 @@ union IssueTimelineItems =
| DemilestonedEvent
| DisconnectedEvent
| IssueComment
+ | IssueCommentPinnedEvent
+ | IssueCommentUnpinnedEvent
| IssueTypeAddedEvent
| IssueTypeChangedEvent
| IssueTypeRemovedEvent
@@ -20967,6 +21857,11 @@ type IssueType implements Node {
The issue type's name.
"""
name: String!
+
+ """
+ An ordered list of issue fields pinned to this type.
+ """
+ pinnedFields: [IssueFields!]
}
"""
@@ -25218,6 +26113,26 @@ type Mutation {
input: CreateIssueInput!
): CreateIssuePayload
+ """
+ Creates a new issue field.
+ """
+ createIssueField(
+ """
+ Parameters for CreateIssueField
+ """
+ input: CreateIssueFieldInput!
+ ): CreateIssueFieldPayload
+
+ """
+ Creates a new issue field value for an issue.
+ """
+ createIssueFieldValue(
+ """
+ Parameters for CreateIssueFieldValue
+ """
+ input: CreateIssueFieldValueInput!
+ ): CreateIssueFieldValuePayload
+
"""
Creates a new issue type
"""
@@ -25291,6 +26206,16 @@ type Mutation {
input: CreateProjectV2FieldInput!
): CreateProjectV2FieldPayload
+ """
+ Create a new project issue field.
+ """
+ createProjectV2IssueField(
+ """
+ Parameters for CreateProjectV2IssueField
+ """
+ input: CreateProjectV2IssueFieldInput!
+ ): CreateProjectV2IssueFieldPayload
+
"""
Creates a status update within a Project.
"""
@@ -25492,6 +26417,26 @@ type Mutation {
input: DeleteIssueCommentInput!
): DeleteIssueCommentPayload
+ """
+ Deletes an issue field.
+ """
+ deleteIssueField(
+ """
+ Parameters for DeleteIssueField
+ """
+ input: DeleteIssueFieldInput!
+ ): DeleteIssueFieldPayload
+
+ """
+ Deletes an issue field value from an issue.
+ """
+ deleteIssueFieldValue(
+ """
+ Parameters for DeleteIssueFieldValue
+ """
+ input: DeleteIssueFieldValueInput!
+ ): DeleteIssueFieldValuePayload
+
"""
Delete an issue type
"""
@@ -25983,6 +26928,16 @@ type Mutation {
input: PinIssueInput!
): PinIssuePayload
+ """
+ Pins an Issue Comment.
+ """
+ pinIssueComment(
+ """
+ Parameters for PinIssueComment
+ """
+ input: PinIssueCommentInput!
+ ): PinIssueCommentPayload
+
"""
Promote a repository custom property to the enterprise level.
"""
@@ -26314,6 +27269,16 @@ type Mutation {
input: SetEnterpriseIdentityProviderInput!
): SetEnterpriseIdentityProviderPayload
+ """
+ Sets the value of an IssueFieldValue.
+ """
+ setIssueFieldValue(
+ """
+ Parameters for SetIssueFieldValue
+ """
+ input: SetIssueFieldValueInput!
+ ): SetIssueFieldValuePayload
+
"""
Set an organization level interaction limit for an organization's public repositories.
"""
@@ -26547,6 +27512,16 @@ type Mutation {
input: UnpinIssueInput!
): UnpinIssuePayload
+ """
+ Unpins an Issue Comment.
+ """
+ unpinIssueComment(
+ """
+ Parameters for UnpinIssueComment
+ """
+ input: UnpinIssueCommentInput!
+ ): UnpinIssueCommentPayload
+
"""
Marks a review thread as unresolved.
"""
@@ -26857,6 +27832,26 @@ type Mutation {
input: UpdateIssueCommentInput!
): UpdateIssueCommentPayload
+ """
+ Updates an issue field.
+ """
+ updateIssueField(
+ """
+ Parameters for UpdateIssueField
+ """
+ input: UpdateIssueFieldInput!
+ ): UpdateIssueFieldPayload
+
+ """
+ Updates an existing issue field value for an issue.
+ """
+ updateIssueFieldValue(
+ """
+ Parameters for UpdateIssueFieldValue
+ """
+ input: UpdateIssueFieldValueInput!
+ ): UpdateIssueFieldValuePayload
+
"""
Updates the issue type on an issue
"""
@@ -32762,6 +33757,36 @@ type Organization implements Actor & MemberStatusable & Node & PackageOwner & Pr
"""
isVerified: Boolean!
+ """
+ A list of the organization's issue fields
+ """
+ issueFields(
+ """
+ Returns the elements in the list that come after the specified cursor.
+ """
+ after: String
+
+ """
+ Returns the elements in the list that come before the specified cursor.
+ """
+ before: String
+
+ """
+ Returns the first _n_ elements from the list.
+ """
+ first: Int
+
+ """
+ Returns the last _n_ elements from the list.
+ """
+ last: Int
+
+ """
+ Ordering options for issue fields returned from the connection.
+ """
+ orderBy: IssueFieldOrder = {field: CREATED_AT, direction: ASC}
+ ): IssueFieldsConnection
+
"""
A list of the organization's issue types
"""
@@ -35608,6 +36633,36 @@ type PinEnvironmentPayload {
pinnedEnvironment: PinnedEnvironment
}
+"""
+Autogenerated input type of PinIssueComment
+"""
+input PinIssueCommentInput {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The ID of the Issue Comment to pin. Comment pinning is not supported on Pull Requests.
+ """
+ issueCommentId: ID! @possibleTypes(concreteTypes: ["IssueComment"])
+}
+
+"""
+Autogenerated return type of PinIssueComment.
+"""
+type PinIssueCommentPayload {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The Issue Comment that was pinned
+ """
+ issueComment: IssueComment
+}
+
"""
Autogenerated input type of PinIssue
"""
@@ -35638,6 +36693,36 @@ type PinIssuePayload {
issue: Issue
}
+"""
+Entities that can be pinned.
+"""
+interface Pinnable {
+ """
+ Indicates whether or not this entity is currently pinned.
+ """
+ isPinned: Boolean
+
+ """
+ Identifies the date and time when this entity was pinned.
+ """
+ pinnedAt: DateTime
+
+ """
+ The user who pinned this entity.
+ """
+ pinnedBy: User
+
+ """
+ Check if the current viewer can pin this entity.
+ """
+ viewerCanPin: Boolean!
+
+ """
+ Check if the current viewer can unpin this entity.
+ """
+ viewerCanUnpin: Boolean!
+}
+
"""
Types that can be pinned to a profile page.
"""
@@ -36048,6 +37133,46 @@ type PinnedIssue implements Node {
repository: Repository!
}
+"""
+A comment pinned to an Issue.
+"""
+type PinnedIssueComment implements Node {
+ """
+ Identifies the primary key from the database.
+ """
+ databaseId: Int
+
+ """
+ Identifies the primary key from the database as a BigInt.
+ """
+ fullDatabaseId: BigInt
+
+ """
+ The Node ID of the PinnedIssueComment object
+ """
+ id: ID!
+
+ """
+ The issue that this comment belongs to.
+ """
+ issue: Issue!
+
+ """
+ The comment that was pinned.
+ """
+ issueComment: IssueComment!
+
+ """
+ Identifies when the comment was pinned.
+ """
+ pinnedAt: DateTime!
+
+ """
+ The actor that pinned this comment.
+ """
+ pinnedBy: Actor!
+}
+
"""
The connection type for PinnedIssue.
"""
@@ -38322,6 +39447,15 @@ input ProjectV2Filters {
state: ProjectV2State
}
+"""
+Possible issue field values for a Project item.
+"""
+union ProjectV2IssueFieldValues =
+ | IssueFieldDateValue
+ | IssueFieldNumberValue
+ | IssueFieldSingleSelectValue
+ | IssueFieldTextValue
+
"""
An item within a Project.
"""
@@ -38925,6 +40059,7 @@ union ProjectV2ItemFieldValue =
| ProjectV2ItemFieldSingleSelectValue
| ProjectV2ItemFieldTextValue
| ProjectV2ItemFieldUserValue
+ | ProjectV2ItemIssueFieldValue
"""
Common fields across different project field value types
@@ -39031,6 +40166,21 @@ enum ProjectV2ItemFieldValueOrderField {
POSITION
}
+"""
+The value of an issue field in a Project item.
+"""
+type ProjectV2ItemIssueFieldValue {
+ """
+ Field that contains this value.
+ """
+ field: ProjectV2FieldConfiguration!
+
+ """
+ Value of the Issue Field
+ """
+ issueFieldValue: ProjectV2IssueFieldValues
+}
+
"""
Ordering options for project v2 item connections
"""
@@ -43441,6 +44591,8 @@ union PullRequestTimelineItems =
| HeadRefForcePushedEvent
| HeadRefRestoredEvent
| IssueComment
+ | IssueCommentPinnedEvent
+ | IssueCommentUnpinnedEvent
| IssueTypeAddedEvent
| IssueTypeChangedEvent
| IssueTypeRemovedEvent
@@ -56767,6 +57919,46 @@ type SetEnterpriseIdentityProviderPayload {
identityProvider: EnterpriseIdentityProvider
}
+"""
+Autogenerated input type of SetIssueFieldValue
+"""
+input SetIssueFieldValueInput {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The issue fields to set on the issue
+ """
+ issueFields: [IssueFieldCreateOrUpdateInput!]!
+
+ """
+ The ID of the Issue to set the field value on.
+ """
+ issueId: ID! @possibleTypes(concreteTypes: ["Issue"])
+}
+
+"""
+Autogenerated return type of SetIssueFieldValue.
+"""
+type SetIssueFieldValuePayload {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The issue where the field values were set.
+ """
+ issue: Issue
+
+ """
+ The issue field values that were created or updated.
+ """
+ issueFieldValues: [IssueFieldValue!]
+}
+
"""
Autogenerated input type of SetOrganizationInteractionLimit
"""
@@ -64047,6 +65239,36 @@ type UnminimizeCommentPayload {
unminimizedComment: Minimizable
}
+"""
+Autogenerated input type of UnpinIssueComment
+"""
+input UnpinIssueCommentInput {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The ID of the Issue Comment to unpin. Comment pinning is not supported on Pull Requests.
+ """
+ issueCommentId: ID! @possibleTypes(concreteTypes: ["IssueComment"])
+}
+
+"""
+Autogenerated return type of UnpinIssueComment.
+"""
+type UnpinIssueCommentPayload {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The Issue Comment that was unpinned
+ """
+ issueComment: IssueComment
+}
+
"""
Autogenerated input type of UnpinIssue
"""
@@ -65534,6 +66756,100 @@ type UpdateIssueCommentPayload {
issueComment: IssueComment
}
+"""
+Autogenerated input type of UpdateIssueField
+"""
+input UpdateIssueFieldInput {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ A description of the issue field.
+ """
+ description: String
+
+ """
+ The ID of the issue field to update.
+ """
+ id: ID!
+ @possibleTypes(
+ concreteTypes: ["IssueFieldDate", "IssueFieldNumber", "IssueFieldSingleSelect", "IssueFieldText"]
+ abstractType: "IssueFields"
+ )
+
+ """
+ The name of the issue field.
+ """
+ name: String
+
+ """
+ The options for the issue field if applicable.
+ """
+ options: [IssueFieldSingleSelectOptionInput!]
+
+ """
+ The visibility of the issue field.
+ """
+ visibility: IssueFieldVisibility
+}
+
+"""
+Autogenerated return type of UpdateIssueField.
+"""
+type UpdateIssueFieldPayload {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The updated issue field.
+ """
+ issueField: IssueFields
+}
+
+"""
+Autogenerated input type of UpdateIssueFieldValue
+"""
+input UpdateIssueFieldValueInput {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The field value to update.
+ """
+ issueField: IssueFieldCreateOrUpdateInput!
+
+ """
+ The ID of the issue.
+ """
+ issueId: ID! @possibleTypes(concreteTypes: ["Issue"])
+}
+
+"""
+Autogenerated return type of UpdateIssueFieldValue.
+"""
+type UpdateIssueFieldValuePayload {
+ """
+ A unique identifier for the client performing the mutation.
+ """
+ clientMutationId: String
+
+ """
+ The issue object.
+ """
+ issue: Issue
+
+ """
+ The updated issue field value.
+ """
+ issueFieldValue: IssueFieldValue
+}
+
"""
Autogenerated input type of UpdateIssue
"""
diff --git a/src/graphql/data/ghec/schema.json b/src/graphql/data/ghec/schema.json
index d8e856d13e0c..98844d4d5c90 100644
--- a/src/graphql/data/ghec/schema.json
+++ b/src/graphql/data/ghec/schema.json
@@ -3077,6 +3077,82 @@
}
]
},
+ {
+ "name": "createIssueField",
+ "kind": "mutations",
+ "id": "createissuefield",
+ "href": "/graphql/reference/mutations#createissuefield",
+ "description": "
",
+ "type": "ID!",
+ "id": "id",
+ "kind": "scalars",
+ "href": "/graphql/reference/scalars#id",
+ "isDeprecated": false
+ }
+ ]
+ },
{
"name": "UpdateIssueInput",
"kind": "inputObjects",
From 2bbf57a64839909eac94b7c759e27576b81dd1f3 Mon Sep 17 00:00:00 2001
From: Joe Clark <31087804+jc-clark@users.noreply.github.com>
Date: Thu, 12 Mar 2026 10:09:27 -0700
Subject: [PATCH 2/8] Add discovery landing page and categories for
repositories (#60145)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
...ut-archiving-content-and-data-on-github.md | 2 +
.../archiving-repositories.md | 2 +
.../backing-up-a-repository.md | 2 +
.../referencing-and-citing-content.md | 2 +
.../about-merge-methods-on-github.md | 2 +
...guring-commit-merging-for-pull-requests.md | 2 +
...uring-commit-rebasing-for-pull-requests.md | 2 +
...ring-commit-squashing-for-pull-requests.md | 2 +
.../managing-a-merge-queue.md | 2 +
...ge-for-pull-requests-in-your-repository.md | 2 +
...estions-to-update-pull-request-branches.md | 2 +
...ging-the-automatic-deletion-of-branches.md | 2 +
.../changing-the-default-branch.md | 2 +
...nd-restoring-branches-in-a-pull-request.md | 2 +
.../renaming-a-branch.md | 2 +
.../viewing-branches-in-your-repository.md | 2 +
.../about-protected-branches.md | 2 +
.../managing-a-branch-protection-rule.md | 2 +
.../managing-rulesets/about-rulesets.md | 2 +
.../available-rules-for-rulesets.md | 2 +
.../creating-rulesets-for-a-repository.md | 2 +
.../managing-rulesets-for-a-repository.md | 2 +
.../troubleshooting-rules.md | 2 +
.../about-repositories.md | 2 +
.../access-to-repositories.md | 2 +
.../best-practices-for-repositories.md | 2 +
.../cloning-a-repository.md | 2 +
.../creating-a-new-repository.md | 2 +
.../creating-a-repository-from-a-template.md | 2 +
.../creating-a-template-repository.md | 2 +
.../creating-an-issues-only-repository.md | 2 +
.../deleting-a-repository.md | 2 +
.../duplicating-a-repository.md | 2 +
.../quickstart-for-repositories.md | 2 +
.../renaming-a-repository.md | 2 +
.../repository-limits.md | 2 +
.../restoring-a-deleted-repository.md | 2 +
.../transferring-a-repository.md | 2 +
.../troubleshooting-cloning-errors.md | 2 +
.../viewing-all-your-repositories.md | 2 +
content/repositories/index.md | 38 ++++++++++---------
.../about-citation-files.md | 2 +
.../about-code-owners.md | 2 +
.../about-readmes.md | 2 +
.../about-repository-languages.md | 2 +
...classifying-your-repository-with-topics.md | 2 +
...g-your-repositorys-social-media-preview.md | 2 +
...ing-a-sponsor-button-in-your-repository.md | 2 +
.../licensing-a-repository.md | 2 +
.../disabling-issues.md | 2 +
.../disabling-projects-in-a-repository.md | 2 +
.../disabling-pull-requests.md | 2 +
...ing-github-discussions-for-a-repository.md | 2 +
...ithub-actions-settings-for-a-repository.md | 2 +
...d-analysis-settings-for-your-repository.md | 2 +
...fications-for-pushes-to-your-repository.md | 2 +
...tolinks-to-reference-external-resources.md | 2 +
.../configuring-tag-protection-rules.md | 2 +
...nymous-git-read-access-for-a-repository.md | 2 +
.../managing-auto-closing-issues.md | 2 +
...-objects-in-archives-of-your-repository.md | 2 +
...naging-github-models-in-your-repository.md | 2 +
...pull-request-reviews-in-your-repository.md | 2 +
...d-people-with-access-to-your-repository.md | 2 +
...mmit-signoff-policy-for-your-repository.md | 2 +
...fault-branch-name-for-your-repositories.md | 2 +
...-the-forking-policy-for-your-repository.md | 2 +
...ing-the-push-policy-for-your-repository.md | 2 +
.../setting-repository-visibility.md | 2 +
...-collaborators-to-a-personal-repository.md | 2 +
...-of-your-personal-accounts-repositories.md | 2 +
...evels-for-a-personal-account-repository.md | 2 +
...collaborator-from-a-personal-repository.md | 2 +
...ourself-from-a-collaborators-repository.md | 2 +
.../about-releases.md | 2 +
.../automatically-generated-release-notes.md | 2 +
...for-release-forms-with-query-parameters.md | 2 +
.../comparing-releases.md | 2 +
.../linking-to-releases.md | 2 +
.../managing-releases-in-a-repository.md | 2 +
.../searching-a-repositorys-releases.md | 2 +
...wing-your-repositorys-releases-and-tags.md | 2 +
.../about-repository-graphs.md | 2 +
...lyzing-changes-to-a-repositorys-content.md | 2 +
...anding-connections-between-repositories.md | 2 +
...o-view-a-summary-of-repository-activity.md | 2 +
...ity-view-to-see-changes-to-a-repository.md | 2 +
.../viewing-a-projects-contributors.md | 2 +
...deployment-activity-for-your-repository.md | 2 +
.../viewing-traffic-to-a-repository.md | 2 +
.../adding-a-file-to-a-repository.md | 2 +
.../managing-files/creating-new-files.md | 2 +
...zing-how-changed-files-appear-on-github.md | 2 +
.../deleting-files-in-a-repository.md | 2 +
.../managing-files/editing-files.md | 2 +
.../moving-a-file-to-a-new-location.md | 2 +
.../managing-files/renaming-a-file.md | 2 +
.../about-git-large-file-storage.md | 2 +
.../about-large-files-on-github.md | 2 +
...llaboration-with-git-large-file-storage.md | 2 +
.../configuring-git-large-file-storage.md | 2 +
.../installing-git-large-file-storage.md | 2 +
...ur-repository-to-git-large-file-storage.md | 2 +
...oving-files-from-git-large-file-storage.md | 2 +
...-git-large-file-storage-upload-failures.md | 2 +
.../downloading-source-code-archives.md | 2 +
.../getting-permanent-links-to-files.md | 2 +
.../using-files/navigating-code-on-github.md | 2 +
.../viewing-and-understanding-files.md | 2 +
.../working-with-non-code-files.md | 2 +
110 files changed, 239 insertions(+), 17 deletions(-)
diff --git a/content/repositories/archiving-a-github-repository/about-archiving-content-and-data-on-github.md b/content/repositories/archiving-a-github-repository/about-archiving-content-and-data-on-github.md
index 28516dd3af3f..c602662e6401 100644
--- a/content/repositories/archiving-a-github-repository/about-archiving-content-and-data-on-github.md
+++ b/content/repositories/archiving-a-github-repository/about-archiving-content-and-data-on-github.md
@@ -9,6 +9,8 @@ versions:
fpt: '*'
ghec: '*'
shortTitle: Archive content & data
+category:
+ - Manage, move, and archive a repository
---
## Persistence of public repositories
diff --git a/content/repositories/archiving-a-github-repository/archiving-repositories.md b/content/repositories/archiving-a-github-repository/archiving-repositories.md
index f0fb36c3d770..300fdc94b8f2 100644
--- a/content/repositories/archiving-a-github-repository/archiving-repositories.md
+++ b/content/repositories/archiving-a-github-repository/archiving-repositories.md
@@ -12,6 +12,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Manage, move, and archive a repository
---
## About repository archival
diff --git a/content/repositories/archiving-a-github-repository/backing-up-a-repository.md b/content/repositories/archiving-a-github-repository/backing-up-a-repository.md
index f56e768d5be2..99a6b841cdaf 100644
--- a/content/repositories/archiving-a-github-repository/backing-up-a-repository.md
+++ b/content/repositories/archiving-a-github-repository/backing-up-a-repository.md
@@ -9,6 +9,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Manage, move, and archive a repository
---
You may want to take backups of repositories for archiving or disaster recovery purposes.
diff --git a/content/repositories/archiving-a-github-repository/referencing-and-citing-content.md b/content/repositories/archiving-a-github-repository/referencing-and-citing-content.md
index 634c60a24927..1f0040925813 100644
--- a/content/repositories/archiving-a-github-repository/referencing-and-citing-content.md
+++ b/content/repositories/archiving-a-github-repository/referencing-and-citing-content.md
@@ -9,6 +9,8 @@ versions:
fpt: '*'
ghec: '*'
shortTitle: Reference & cite content
+category:
+ - Manage, move, and archive a repository
---
## Issuing a persistent identifier for your repository with Zenodo
diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/about-merge-methods-on-github.md b/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/about-merge-methods-on-github.md
index 2dac01a71717..21f884deabb2 100644
--- a/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/about-merge-methods-on-github.md
+++ b/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/about-merge-methods-on-github.md
@@ -10,6 +10,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: About merge methods
+category:
+ - Configure merges and pull requests
---
{% data reusables.pull_requests.configure_pull_request_merges_intro %} You can enforce one type of merge method, such as commit squashing or rebasing, by only enabling the desired method for your repository.
diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/configuring-commit-merging-for-pull-requests.md b/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/configuring-commit-merging-for-pull-requests.md
index a5b308fbe6e0..a5c9f32d0c21 100644
--- a/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/configuring-commit-merging-for-pull-requests.md
+++ b/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/configuring-commit-merging-for-pull-requests.md
@@ -6,6 +6,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Configure commit merging
+category:
+ - Configure merges and pull requests
---
{% data reusables.pull_requests.configure_pull_request_merges_intro %}
diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/configuring-commit-rebasing-for-pull-requests.md b/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/configuring-commit-rebasing-for-pull-requests.md
index ff5a80fbfc0d..ba8e810caedc 100644
--- a/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/configuring-commit-rebasing-for-pull-requests.md
+++ b/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/configuring-commit-rebasing-for-pull-requests.md
@@ -10,6 +10,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Configure commit rebasing
+category:
+ - Configure merges and pull requests
---
{% data reusables.pull_requests.configure_pull_request_merges_intro %}
diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/configuring-commit-squashing-for-pull-requests.md b/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/configuring-commit-squashing-for-pull-requests.md
index 2e0500b7b4cf..9d04bc5b1bfc 100644
--- a/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/configuring-commit-squashing-for-pull-requests.md
+++ b/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/configuring-commit-squashing-for-pull-requests.md
@@ -10,6 +10,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Configure commit squashing
+category:
+ - Configure merges and pull requests
---
{% data reusables.pull_requests.configure_pull_request_merges_intro %}
diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-a-merge-queue.md b/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-a-merge-queue.md
index 9c3e99f6db81..3fdb6217429c 100644
--- a/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-a-merge-queue.md
+++ b/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-a-merge-queue.md
@@ -10,6 +10,8 @@ product: '{% data reusables.gated-features.merge-queue %}'
shortTitle: Managing merge queue
redirect_from:
- /repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/using-a-merge-queue
+category:
+ - Configure merges and pull requests
---
## About merge queues
diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository.md b/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository.md
index 57e49c26438e..0d9dc84e1956 100644
--- a/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository.md
+++ b/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository.md
@@ -11,6 +11,8 @@ redirect_from:
- /github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository
- /github/administering-a-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository
shortTitle: Manage auto merge
+category:
+ - Configure merges and pull requests
---
## About auto-merge
diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-suggestions-to-update-pull-request-branches.md b/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-suggestions-to-update-pull-request-branches.md
index 3db09a7adbc9..b0cc9f599c72 100644
--- a/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-suggestions-to-update-pull-request-branches.md
+++ b/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-suggestions-to-update-pull-request-branches.md
@@ -7,6 +7,8 @@ versions:
ghec: '*'
shortTitle: Manage branch updates
permissions: People with maintainer permissions can enable or disable the setting to suggest updating pull request branches.
+category:
+ - Configure merges and pull requests
---
## About suggestions to update a pull request branch
diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-the-automatic-deletion-of-branches.md b/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-the-automatic-deletion-of-branches.md
index 9ee746683917..011b3105cdca 100644
--- a/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-the-automatic-deletion-of-branches.md
+++ b/content/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-the-automatic-deletion-of-branches.md
@@ -10,6 +10,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Automatic branch deletion
+category:
+ - Configure merges and pull requests
---
Anyone with admin permissions to a repository can enable or disable the automatic deletion of branches. Branch protection rules and repository rules can also prevent branches being automatically deleted. For more information, see{% ifversion fpt or ghec %} [AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/about-rulesets) and{% endif %} [AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches).
diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/changing-the-default-branch.md b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/changing-the-default-branch.md
index 52e0562217d1..870d1ffab735 100644
--- a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/changing-the-default-branch.md
+++ b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/changing-the-default-branch.md
@@ -12,6 +12,8 @@ redirect_from:
- /github/administering-a-repository/changing-the-default-branch
- /github/administering-a-repository/managing-branches-in-your-repository/changing-the-default-branch
shortTitle: Change the default branch
+category:
+ - Manage branches and protect code
---
## About changing the default branch
diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/deleting-and-restoring-branches-in-a-pull-request.md b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/deleting-and-restoring-branches-in-a-pull-request.md
index 5ca7123faaf4..4224089d62e9 100644
--- a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/deleting-and-restoring-branches-in-a-pull-request.md
+++ b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/deleting-and-restoring-branches-in-a-pull-request.md
@@ -13,6 +13,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Delete & restore branches
+category:
+ - Manage branches and protect code
---
## Deleting a branch used for a pull request
diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch.md b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch.md
index b8fbb3272f4c..deaf25c20cf3 100644
--- a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch.md
+++ b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch.md
@@ -9,6 +9,8 @@ versions:
redirect_from:
- /github/administering-a-repository/renaming-a-branch
- /github/administering-a-repository/managing-branches-in-your-repository/renaming-a-branch
+category:
+ - Manage branches and protect code
---
## About renaming branches
diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/viewing-branches-in-your-repository.md b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/viewing-branches-in-your-repository.md
index 03eb658a4b7e..0d68a4f37006 100644
--- a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/viewing-branches-in-your-repository.md
+++ b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/viewing-branches-in-your-repository.md
@@ -10,6 +10,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: View branches
+category:
+ - Manage branches and protect code
---
{% data reusables.repositories.navigate-to-repo %}
{% data reusables.repositories.navigate-to-branches %}
diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches.md b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches.md
index 3bb71bcf90fa..8a4b20cfaca9 100644
--- a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches.md
+++ b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches.md
@@ -22,6 +22,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Manage branches and protect code
---
## About branch protection rules
diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/managing-a-branch-protection-rule.md b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/managing-a-branch-protection-rule.md
index c9fd8b5d27d4..f5f7c310366a 100644
--- a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/managing-a-branch-protection-rule.md
+++ b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/managing-a-branch-protection-rule.md
@@ -25,6 +25,8 @@ versions:
ghec: '*'
permissions: 'People with admin permissions or a custom role with the "edit repository rules" permission to a repository can manage branch protection rules.'
shortTitle: Branch protection rule
+category:
+ - Manage branches and protect code
---
## About branch protection rules
diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/about-rulesets.md b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/about-rulesets.md
index a6b781a2dc60..4704333ac5a0 100644
--- a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/about-rulesets.md
+++ b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/about-rulesets.md
@@ -8,6 +8,8 @@ versions:
ghes: '*'
permissions: '{% data reusables.repositories.repo-rules-permissions %}'
shortTitle: About rulesets
+category:
+ - Manage branches and protect code
---
## About rulesets
diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/available-rules-for-rulesets.md b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/available-rules-for-rulesets.md
index 0a97bfb4477d..97a2ad983d16 100644
--- a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/available-rules-for-rulesets.md
+++ b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/available-rules-for-rulesets.md
@@ -10,6 +10,8 @@ permissions: '{% data reusables.repositories.repo-rules-permissions %}'
shortTitle: Available rules
redirect_from:
- /actions/sharing-automations/required-workflows
+category:
+ - Manage branches and protect code
---
You can create branch or tag rulesets to control how users can interact with selected branches and tags in a repository. {% ifversion push-rulesets %}You can also create push rulesets to block pushes to a private or internal repository and that repository's entire fork network.{% endif %}
diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/creating-rulesets-for-a-repository.md b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/creating-rulesets-for-a-repository.md
index 9f343b93e22a..2c82d4fa1904 100644
--- a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/creating-rulesets-for-a-repository.md
+++ b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/creating-rulesets-for-a-repository.md
@@ -8,6 +8,8 @@ versions:
ghes: '*'
permissions: '{% data reusables.repositories.repo-rules-permissions %}'
shortTitle: Create a ruleset
+category:
+ - Manage branches and protect code
---
## Introduction
diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/managing-rulesets-for-a-repository.md b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/managing-rulesets-for-a-repository.md
index d46f52df7cbc..3d8fce74210f 100644
--- a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/managing-rulesets-for-a-repository.md
+++ b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/managing-rulesets-for-a-repository.md
@@ -8,6 +8,8 @@ versions:
ghes: '*'
permissions: '{% data reusables.repositories.repo-rules-permissions %}'
shortTitle: Manage a ruleset
+category:
+ - Manage branches and protect code
---
After creating a ruleset, you can still make changes to it. For example, you can add rules to better protect your branches or tags, or you can {% ifversion repo-rules-enterprise %}switch your ruleset from "Evaluate" mode to "Active" after testing its effects on the contributor experience for your repository{% else %}temporarily disable a ruleset to troubleshoot any unintended effects on the contributor experience for your repository{% endif %}.
diff --git a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/troubleshooting-rules.md b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/troubleshooting-rules.md
index cd0b5dc0b38c..6eefba01e272 100644
--- a/content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/troubleshooting-rules.md
+++ b/content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/troubleshooting-rules.md
@@ -7,6 +7,8 @@ versions:
ghec: '*'
ghes: '*'
shortTitle: Troubleshooting
+category:
+ - Manage branches and protect code
---
## Troubleshooting rulesets
diff --git a/content/repositories/creating-and-managing-repositories/about-repositories.md b/content/repositories/creating-and-managing-repositories/about-repositories.md
index b75ea4d18b9b..e3a0793db9f1 100644
--- a/content/repositories/creating-and-managing-repositories/about-repositories.md
+++ b/content/repositories/creating-and-managing-repositories/about-repositories.md
@@ -15,6 +15,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Create and set up a repository
---
## About repositories
diff --git a/content/repositories/creating-and-managing-repositories/access-to-repositories.md b/content/repositories/creating-and-managing-repositories/access-to-repositories.md
index b9f78f987fc5..9acc9cb573f5 100644
--- a/content/repositories/creating-and-managing-repositories/access-to-repositories.md
+++ b/content/repositories/creating-and-managing-repositories/access-to-repositories.md
@@ -10,6 +10,8 @@ contentType: other
redirect_from:
- /account-and-profile/concepts/personal-repository-access-and-collaboration
- /account-and-profile/concepts/access-to-repositories
+category:
+ - Manage access and repository policies
---
## About collaboration in a personal repository
diff --git a/content/repositories/creating-and-managing-repositories/best-practices-for-repositories.md b/content/repositories/creating-and-managing-repositories/best-practices-for-repositories.md
index eebe0e3e0b47..53cdbafe5274 100644
--- a/content/repositories/creating-and-managing-repositories/best-practices-for-repositories.md
+++ b/content/repositories/creating-and-managing-repositories/best-practices-for-repositories.md
@@ -6,6 +6,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Create and set up a repository
---
## Create a README file
diff --git a/content/repositories/creating-and-managing-repositories/cloning-a-repository.md b/content/repositories/creating-and-managing-repositories/cloning-a-repository.md
index 0734120c8ff8..f87d66eaedc5 100644
--- a/content/repositories/creating-and-managing-repositories/cloning-a-repository.md
+++ b/content/repositories/creating-and-managing-repositories/cloning-a-repository.md
@@ -10,6 +10,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Create and set up a repository
---
## About cloning a repository
diff --git a/content/repositories/creating-and-managing-repositories/creating-a-new-repository.md b/content/repositories/creating-and-managing-repositories/creating-a-new-repository.md
index c75e572dc8fb..f928db8bfd24 100644
--- a/content/repositories/creating-and-managing-repositories/creating-a-new-repository.md
+++ b/content/repositories/creating-and-managing-repositories/creating-a-new-repository.md
@@ -15,6 +15,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Create and set up a repository
---
> [!TIP]
diff --git a/content/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template.md b/content/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template.md
index 1ee81ea692fe..5bf06569206d 100644
--- a/content/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template.md
+++ b/content/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template.md
@@ -11,6 +11,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Create from a template
+category:
+ - Create and set up a repository
---
## About repository templates
diff --git a/content/repositories/creating-and-managing-repositories/creating-a-template-repository.md b/content/repositories/creating-and-managing-repositories/creating-a-template-repository.md
index 9eae4abb00e6..7ff0d9add747 100644
--- a/content/repositories/creating-and-managing-repositories/creating-a-template-repository.md
+++ b/content/repositories/creating-and-managing-repositories/creating-a-template-repository.md
@@ -11,6 +11,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Create a template repo
+category:
+ - Create and set up a repository
---
## About template repositories
diff --git a/content/repositories/creating-and-managing-repositories/creating-an-issues-only-repository.md b/content/repositories/creating-and-managing-repositories/creating-an-issues-only-repository.md
index 96416293a1bc..3fcf1b0befa9 100644
--- a/content/repositories/creating-and-managing-repositories/creating-an-issues-only-repository.md
+++ b/content/repositories/creating-and-managing-repositories/creating-an-issues-only-repository.md
@@ -12,6 +12,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Issues-only repository
+category:
+ - Create and set up a repository
---
1. Create a **private** repository to host the source code from your project.
1. Create a second repository with the permissions you desire to host the issue tracker.
diff --git a/content/repositories/creating-and-managing-repositories/deleting-a-repository.md b/content/repositories/creating-and-managing-repositories/deleting-a-repository.md
index 147dd396d07e..97ba4770d201 100644
--- a/content/repositories/creating-and-managing-repositories/deleting-a-repository.md
+++ b/content/repositories/creating-and-managing-repositories/deleting-a-repository.md
@@ -11,6 +11,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Manage, move, and archive a repository
---
{% data reusables.organizations.owners-and-admins-can %} delete an organization repository, and these users may be prevented from deleting a repository by an organization or enterprise policy. {% data reusables.organizations.new-repo-permissions-more-info %}
diff --git a/content/repositories/creating-and-managing-repositories/duplicating-a-repository.md b/content/repositories/creating-and-managing-repositories/duplicating-a-repository.md
index 119e084a14b6..8046d0114238 100644
--- a/content/repositories/creating-and-managing-repositories/duplicating-a-repository.md
+++ b/content/repositories/creating-and-managing-repositories/duplicating-a-repository.md
@@ -10,6 +10,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Create and set up a repository
---
{% ifversion fpt or ghec %}
diff --git a/content/repositories/creating-and-managing-repositories/quickstart-for-repositories.md b/content/repositories/creating-and-managing-repositories/quickstart-for-repositories.md
index 842220031a3d..5f86783420d0 100644
--- a/content/repositories/creating-and-managing-repositories/quickstart-for-repositories.md
+++ b/content/repositories/creating-and-managing-repositories/quickstart-for-repositories.md
@@ -12,6 +12,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Create and set up a repository
---
## Create a repository
diff --git a/content/repositories/creating-and-managing-repositories/renaming-a-repository.md b/content/repositories/creating-and-managing-repositories/renaming-a-repository.md
index d7aaaee70b52..7c8f310a01fc 100644
--- a/content/repositories/creating-and-managing-repositories/renaming-a-repository.md
+++ b/content/repositories/creating-and-managing-repositories/renaming-a-repository.md
@@ -9,6 +9,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Manage, move, and archive a repository
---
When you rename a repository, all existing information, with the exception of project site URLs, is automatically redirected to the new name, including:
diff --git a/content/repositories/creating-and-managing-repositories/repository-limits.md b/content/repositories/creating-and-managing-repositories/repository-limits.md
index 8a2d1cefa697..eb14c4a74638 100644
--- a/content/repositories/creating-and-managing-repositories/repository-limits.md
+++ b/content/repositories/creating-and-managing-repositories/repository-limits.md
@@ -5,6 +5,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Create and set up a repository
---
Certain types of repository resources can be quite large, requiring excessive processing on {% data variables.product.github %}. Because of this, limits are set to ensure requests complete in a reasonable amount of time. Exceeding the recommended maximum limit increases the risk of degraded repository health, which includes, but is not limited to, slow response times for basic Git operations and UI latency.
diff --git a/content/repositories/creating-and-managing-repositories/restoring-a-deleted-repository.md b/content/repositories/creating-and-managing-repositories/restoring-a-deleted-repository.md
index dc5d0276329e..e16dcb9ddb7b 100644
--- a/content/repositories/creating-and-managing-repositories/restoring-a-deleted-repository.md
+++ b/content/repositories/creating-and-managing-repositories/restoring-a-deleted-repository.md
@@ -11,6 +11,8 @@ versions:
ghec: '*'
ghes: '*'
shortTitle: Restore deleted repository
+category:
+ - Manage, move, and archive a repository
---
{% ifversion ghes %}
diff --git a/content/repositories/creating-and-managing-repositories/transferring-a-repository.md b/content/repositories/creating-and-managing-repositories/transferring-a-repository.md
index 15ae83da879c..c72987ea4970 100644
--- a/content/repositories/creating-and-managing-repositories/transferring-a-repository.md
+++ b/content/repositories/creating-and-managing-repositories/transferring-a-repository.md
@@ -18,6 +18,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Manage, move, and archive a repository
---
## About repository transfers
diff --git a/content/repositories/creating-and-managing-repositories/troubleshooting-cloning-errors.md b/content/repositories/creating-and-managing-repositories/troubleshooting-cloning-errors.md
index a5e454b08135..57bd1fe5b85d 100644
--- a/content/repositories/creating-and-managing-repositories/troubleshooting-cloning-errors.md
+++ b/content/repositories/creating-and-managing-repositories/troubleshooting-cloning-errors.md
@@ -16,6 +16,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Create and set up a repository
---
## HTTPS cloning errors
diff --git a/content/repositories/creating-and-managing-repositories/viewing-all-your-repositories.md b/content/repositories/creating-and-managing-repositories/viewing-all-your-repositories.md
index 246dfe7a7533..dc21d2ea393f 100644
--- a/content/repositories/creating-and-managing-repositories/viewing-all-your-repositories.md
+++ b/content/repositories/creating-and-managing-repositories/viewing-all-your-repositories.md
@@ -8,6 +8,8 @@ versions:
ghes: '>=3.22'
shortTitle: View all repositories
type: how_to
+category:
+ - Manage, move, and archive a repository
---
## Viewing repositories
diff --git a/content/repositories/index.md b/content/repositories/index.md
index 0808703ef128..a4625d6f2ad6 100644
--- a/content/repositories/index.md
+++ b/content/repositories/index.md
@@ -5,24 +5,18 @@ intro: Learn to use and manage the repositories that allow you to store and coll
introLinks:
quickstart: /repositories/creating-and-managing-repositories/quickstart-for-repositories
overview: /repositories/creating-and-managing-repositories/about-repositories
-featuredLinks:
- startHere:
+layout: discovery-landing
+carousels:
+ recommended:
+ - /repositories/creating-and-managing-repositories/quickstart-for-repositories
+ - /repositories/creating-and-managing-repositories/about-repositories
+ - /repositories/creating-and-managing-repositories/best-practices-for-repositories
+ - /repositories/creating-and-managing-repositories/creating-a-new-repository
- /repositories/creating-and-managing-repositories/cloning-a-repository
- - /repositories/creating-and-managing-repositories/restoring-a-deleted-repository
- - /repositories/working-with-files/managing-files/adding-a-file-to-a-repository
- - /repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository
- popular:
- - /repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches
- - /repositories/releasing-projects-on-github/about-releases
- /repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes
- - /repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
- guideCards:
- - /repositories/creating-and-managing-repositories/deleting-a-repository
- - /repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/managing-a-branch-protection-rule
- - /repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/setting-repository-visibility
-changelog:
- label: repos
-layout: product-landing
+ - /repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/about-rulesets
+ - /repositories/releasing-projects-on-github/managing-releases-in-a-repository
+ - /repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-teams-and-people-with-access-to-your-repository
redirect_from:
- /github/creating-cloning-and-archiving-repositories
versions:
@@ -37,5 +31,15 @@ children:
- /releasing-projects-on-github
- /viewing-activity-and-data-for-your-repository
- /archiving-a-github-repository
+includedCategories:
+ - Create and set up a repository
+ - Manage, move, and archive a repository
+ - Work with files
+ - Store large files with Git LFS
+ - Manage branches and protect code
+ - Configure merges and pull requests
+ - Manage access and repository policies
+ - Customize and configure a repository
+ - Release software
+ - Track repository activity
---
-
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-citation-files.md b/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-citation-files.md
index 1f3ae6f33ba0..43349af0fecc 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-citation-files.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-citation-files.md
@@ -7,6 +7,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Customize and configure a repository
---
## About CITATION files
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md b/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md
index d49f3e0b49b3..59cb9e1dfed0 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md
@@ -12,6 +12,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Customize and configure a repository
---
The people you choose as code owners must have write permissions for the repository. When the code owner is a team, that team must be visible and it must have write permissions, even if all the individual members of the team already have write permissions directly, through organization membership, or through another team membership.
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md b/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md
index 104f5a68a34a..dccaca0601ca 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes.md
@@ -12,6 +12,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Customize and configure a repository
---
## About READMEs
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-repository-languages.md b/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-repository-languages.md
index 5f1d24fc9a45..c9e0cf26e4d5 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-repository-languages.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-repository-languages.md
@@ -15,6 +15,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Repository languages
+category:
+ - Customize and configure a repository
---
{% data variables.product.github %} uses the open source [Linguist library](https://github.com/github-linguist/linguist) to
determine file languages for syntax highlighting and repository statistics. Language statistics will update after you push changes to your default branch.
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/classifying-your-repository-with-topics.md b/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/classifying-your-repository-with-topics.md
index 136e306793fa..f47d172a8c59 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/classifying-your-repository-with-topics.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/classifying-your-repository-with-topics.md
@@ -11,6 +11,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Classify with topics
+category:
+ - Customize and configure a repository
---
## About topics
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/customizing-your-repositorys-social-media-preview.md b/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/customizing-your-repositorys-social-media-preview.md
index ce3532e5a2a0..a94ba5f1b5cf 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/customizing-your-repositorys-social-media-preview.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/customizing-your-repositorys-social-media-preview.md
@@ -10,6 +10,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Social media preview
+category:
+ - Customize and configure a repository
---
Until you add an image, repository links expand to show basic information about the repository and the owner's avatar. Adding an image to your repository can help identify your project across various social platforms.
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/displaying-a-sponsor-button-in-your-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/displaying-a-sponsor-button-in-your-repository.md
index 3bd2c239bbe8..58d3ffced82b 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/displaying-a-sponsor-button-in-your-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/displaying-a-sponsor-button-in-your-repository.md
@@ -10,6 +10,8 @@ versions:
fpt: '*'
ghec: '*'
shortTitle: Display a sponsor button
+category:
+ - Customize and configure a repository
---
## About FUNDING files
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository.md
index 32e1def60cd1..e74eaa4851e7 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository.md
@@ -10,6 +10,8 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
+category:
+ - Customize and configure a repository
---
## Choosing the right license
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/disabling-issues.md b/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/disabling-issues.md
index 253f81f5c48a..4a24818b5f42 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/disabling-issues.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/disabling-issues.md
@@ -10,6 +10,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Customize and configure a repository
---
{% data reusables.repositories.navigate-to-repo %}
{% data reusables.repositories.sidebar-settings %}
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/disabling-projects-in-a-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/disabling-projects-in-a-repository.md
index 51bd71d42f9c..21a61e4e9b9e 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/disabling-projects-in-a-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/disabling-projects-in-a-repository.md
@@ -13,6 +13,8 @@ versions:
ghec: '*'
shortTitle: 'Disable projects'
allowTitleToDifferFromFilename: true
+category:
+ - Customize and configure a repository
---
## Disabling {% data variables.projects.projects_v2 %} in a repository
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/disabling-pull-requests.md b/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/disabling-pull-requests.md
index 63bc25cabe14..0f7ce0f75206 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/disabling-pull-requests.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/disabling-pull-requests.md
@@ -8,6 +8,8 @@ redirect_from:
- /github/administering-a-repository/managing-repository-settings/disabling-pull-requests
versions:
feature: disable-restrict-prs
+category:
+ - Customize and configure a repository
---
{% data reusables.repositories.navigate-to-repo %}
{% data reusables.repositories.sidebar-settings %}
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/enabling-or-disabling-github-discussions-for-a-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/enabling-or-disabling-github-discussions-for-a-repository.md
index 4193ced68813..26493b23abff 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/enabling-or-disabling-github-discussions-for-a-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/enabling-or-disabling-github-discussions-for-a-repository.md
@@ -10,6 +10,8 @@ redirect_from:
- /github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository
- /github/administering-a-repository/managing-repository-settings/enabling-or-disabling-github-discussions-for-a-repository
shortTitle: Discussions
+category:
+ - Customize and configure a repository
---
## Enabling or disabling {% data variables.product.prodname_discussions %} for your repository
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md
index b7ac5b1bb743..53969c97dab9 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md
@@ -12,6 +12,8 @@ versions:
ghec: '*'
type: how_to
shortTitle: Manage GitHub Actions settings
+category:
+ - Manage access and repository policies
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-security-and-analysis-settings-for-your-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-security-and-analysis-settings-for-your-repository.md
index c2ee1b4228ec..1e3762bcce59 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-security-and-analysis-settings-for-your-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-security-and-analysis-settings-for-your-repository.md
@@ -15,6 +15,8 @@ versions:
ghec: '*'
type: how_to
shortTitle: Security & analysis
+category:
+ - Manage access and repository policies
---
{% ifversion dependabot-alerts-enterprise-enablement %}
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/about-email-notifications-for-pushes-to-your-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/about-email-notifications-for-pushes-to-your-repository.md
index d8354625a74f..8c097ccb944b 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/about-email-notifications-for-pushes-to-your-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/about-email-notifications-for-pushes-to-your-repository.md
@@ -14,6 +14,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Email notifications for pushes
+category:
+ - Customize and configure a repository
---
{% data reusables.notifications.outbound_email_tip %}
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/configuring-autolinks-to-reference-external-resources.md b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/configuring-autolinks-to-reference-external-resources.md
index 31edbd6a6369..fb302b1a1c99 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/configuring-autolinks-to-reference-external-resources.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/configuring-autolinks-to-reference-external-resources.md
@@ -11,6 +11,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Configure autolinks
+category:
+ - Customize and configure a repository
---
## About autolinks
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/configuring-tag-protection-rules.md b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/configuring-tag-protection-rules.md
index 692c766ff97f..b6e0823bde62 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/configuring-tag-protection-rules.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/configuring-tag-protection-rules.md
@@ -4,6 +4,8 @@ shortTitle: Tag protection rules
intro: You can configure tag protection rules for your repository to prevent contributors from creating or deleting tags.
versions:
ghes: '<3.16'
+category:
+ - Manage access and repository policies
---
>[!NOTE] Tag protection rules are {% data variables.release-phases.closing_down %} in {% data variables.product.prodname_ghe_server %} version 3.16 and later. Use rulesets instead. Any tag protection rules still in use will be auto-migrated. You can read more about this on the [{% data variables.product.prodname_blog %}](https://github.blog/changelog/2024-05-29-sunset-notice-tag-protections).
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/enabling-anonymous-git-read-access-for-a-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/enabling-anonymous-git-read-access-for-a-repository.md
index 863b749fa4c8..1cdac0f849c2 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/enabling-anonymous-git-read-access-for-a-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/enabling-anonymous-git-read-access-for-a-repository.md
@@ -8,6 +8,8 @@ redirect_from:
versions:
ghes: '*'
shortTitle: Anonymous Git read access
+category:
+ - Manage access and repository policies
---
Repository administrators can change the anonymous Git read access setting for a specific repository if:
* A site administrator has enabled private mode and anonymous Git read access.
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-auto-closing-issues.md b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-auto-closing-issues.md
index edf815d12c20..aef388185fdb 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-auto-closing-issues.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-auto-closing-issues.md
@@ -8,6 +8,8 @@ versions:
permissions: Repository administrators and maintainers can configure the automating closing of issues in the repository, once related pull requests are merged.
shortTitle: Manage auto-closing issues
allowTitleToDifferFromFilename: true
+category:
+ - Customize and configure a repository
---
## About auto-closing issues
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-git-lfs-objects-in-archives-of-your-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-git-lfs-objects-in-archives-of-your-repository.md
index abf2a1e50c0c..8cc25e2854d5 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-git-lfs-objects-in-archives-of-your-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-git-lfs-objects-in-archives-of-your-repository.md
@@ -9,6 +9,8 @@ versions:
redirect_from:
- /github/administering-a-repository/managing-git-lfs-objects-in-archives-of-your-repository
- /github/administering-a-repository/managing-repository-settings/managing-git-lfs-objects-in-archives-of-your-repository
+category:
+ - Store large files with Git LFS
---
## About {% data variables.large_files.product_name_short %} objects in archives
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-github-models-in-your-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-github-models-in-your-repository.md
index 85ed52849445..0b00ed37f302 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-github-models-in-your-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-github-models-in-your-repository.md
@@ -6,6 +6,8 @@ versions:
feature: github-models
permissions: 'Repository administrators'
allowTitleToDifferFromFilename: true
+category:
+ - Manage access and repository policies
---
{% data reusables.models.models-preview-note %}
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-pull-request-reviews-in-your-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-pull-request-reviews-in-your-repository.md
index 22e120fa0972..f68450b662ad 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-pull-request-reviews-in-your-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-pull-request-reviews-in-your-repository.md
@@ -5,6 +5,8 @@ versions:
feature: pull-request-approval-limit
permissions: Repository administrators can limit which users can approve or request changes to a pull request in a public repository.
shortTitle: Manage pull request reviews
+category:
+ - Configure merges and pull requests
---
## About code review limits
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-teams-and-people-with-access-to-your-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-teams-and-people-with-access-to-your-repository.md
index 54899ab2d85a..fe4119893413 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-teams-and-people-with-access-to-your-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-teams-and-people-with-access-to-your-repository.md
@@ -11,6 +11,8 @@ versions:
ghec: '*'
ghes: '*'
shortTitle: Teams & people
+category:
+ - Manage access and repository policies
---
## About access management for repositories
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-commit-signoff-policy-for-your-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-commit-signoff-policy-for-your-repository.md
index 4d77c9ea101a..a1f74a2e230b 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-commit-signoff-policy-for-your-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-commit-signoff-policy-for-your-repository.md
@@ -7,6 +7,8 @@ versions:
ghes: '*'
permissions: Organization owners and repository administrators can require all commits to a repository to be signed off by the commit author.
shortTitle: Manage the commit signoff policy
+category:
+ - Configure merges and pull requests
---
## About commit signoffs
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-default-branch-name-for-your-repositories.md b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-default-branch-name-for-your-repositories.md
index 5191328198d0..e2b4979c0f27 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-default-branch-name-for-your-repositories.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-default-branch-name-for-your-repositories.md
@@ -14,6 +14,8 @@ redirect_from:
- /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-the-default-branch-name-for-your-repositories
shortTitle: Manage default branch name
contentType: other
+category:
+ - Manage access and repository policies
---
## About management of the default branch name
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-forking-policy-for-your-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-forking-policy-for-your-repository.md
index 6deed271ec57..8b162aa63446 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-forking-policy-for-your-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-forking-policy-for-your-repository.md
@@ -12,6 +12,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Manage the forking policy
+category:
+ - Manage access and repository policies
---
An organization owner must allow forks of private{% ifversion ghes or ghec %} and internal{% endif %} repositories on the organization level before you can allow or disallow forks for a specific repository. For more information, see [AUTOTITLE](/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization).
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-push-policy-for-your-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-push-policy-for-your-repository.md
index f83497a0f71d..cf51b930fba3 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-push-policy-for-your-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-the-push-policy-for-your-repository.md
@@ -7,6 +7,8 @@ versions:
ghes: '*'
permissions: People with admin permissions for a repository can manage the push policy for the repository.
shortTitle: Manage the push policy
+category:
+ - Manage access and repository policies
---
## About the push policy
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/setting-repository-visibility.md b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/setting-repository-visibility.md
index d5fc2314e2dd..17554c46517c 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/setting-repository-visibility.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/setting-repository-visibility.md
@@ -13,6 +13,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Repository visibility
+category:
+ - Manage access and repository policies
---
## About repository visibility changes
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/inviting-collaborators-to-a-personal-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/inviting-collaborators-to-a-personal-repository.md
index 974a84e3b702..d5c9b7906e5c 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/inviting-collaborators-to-a-personal-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/inviting-collaborators-to-a-personal-repository.md
@@ -17,6 +17,8 @@ versions:
ghec: '*'
shortTitle: Invite collaborators
contentType: other
+category:
+ - Manage access and repository policies
---
## Inviting a collaborator to a personal repository
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/maintaining-ownership-continuity-of-your-personal-accounts-repositories.md b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/maintaining-ownership-continuity-of-your-personal-accounts-repositories.md
index 898c5ae51b97..466fe9a0f133 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/maintaining-ownership-continuity-of-your-personal-accounts-repositories.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/maintaining-ownership-continuity-of-your-personal-accounts-repositories.md
@@ -12,6 +12,8 @@ redirect_from:
- /account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-access-to-your-personal-repositories/maintaining-ownership-continuity-of-your-personal-accounts-repositories
shortTitle: Ownership continuity
contentType: other
+category:
+ - Manage access and repository policies
---
## Inviting a successor
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/permission-levels-for-a-personal-account-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/permission-levels-for-a-personal-account-repository.md
index 6e2a7cf6d08e..cb4a097f7679 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/permission-levels-for-a-personal-account-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/permission-levels-for-a-personal-account-repository.md
@@ -15,6 +15,8 @@ versions:
ghec: '*'
shortTitle: Repository permissions
contentType: other
+category:
+ - Manage access and repository policies
---
> [!TIP]
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/removing-a-collaborator-from-a-personal-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/removing-a-collaborator-from-a-personal-repository.md
index 48c20c5bf12c..18444475ad61 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/removing-a-collaborator-from-a-personal-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/removing-a-collaborator-from-a-personal-repository.md
@@ -20,6 +20,8 @@ versions:
ghec: '*'
shortTitle: Remove a collaborator
contentType: other
+category:
+ - Manage access and repository policies
---
## Removing collaborator permissions from a person contributing to a repository
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/removing-yourself-from-a-collaborators-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/removing-yourself-from-a-collaborators-repository.md
index 4c222e9e8141..8f3e41001b0f 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/removing-yourself-from-a-collaborators-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/repository-access-and-collaboration/removing-yourself-from-a-collaborators-repository.md
@@ -18,6 +18,8 @@ versions:
ghec: '*'
shortTitle: Remove yourself
contentType: other
+category:
+ - Manage access and repository policies
---
{% data reusables.user-settings.access_settings %}
1. In the "Code, planning, and automation" section of the sidebar, click **{% octicon "repo" aria-hidden="true" aria-label="repo" %} Repositories**.
diff --git a/content/repositories/releasing-projects-on-github/about-releases.md b/content/repositories/releasing-projects-on-github/about-releases.md
index 7e2ad2289f42..de694d44eb81 100644
--- a/content/repositories/releasing-projects-on-github/about-releases.md
+++ b/content/repositories/releasing-projects-on-github/about-releases.md
@@ -13,6 +13,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Release software
---
## About releases
diff --git a/content/repositories/releasing-projects-on-github/automatically-generated-release-notes.md b/content/repositories/releasing-projects-on-github/automatically-generated-release-notes.md
index d7c5e0b15811..571f361c7539 100644
--- a/content/repositories/releasing-projects-on-github/automatically-generated-release-notes.md
+++ b/content/repositories/releasing-projects-on-github/automatically-generated-release-notes.md
@@ -10,6 +10,8 @@ shortTitle: Automated release notes
communityRedirect:
name: Provide GitHub Feedback
href: 'https://github.com/orgs/community/discussions/categories/general'
+category:
+ - Release software
---
## About automatically generated release notes
diff --git a/content/repositories/releasing-projects-on-github/automation-for-release-forms-with-query-parameters.md b/content/repositories/releasing-projects-on-github/automation-for-release-forms-with-query-parameters.md
index 80140e6de5cf..fe8cc32f683a 100644
--- a/content/repositories/releasing-projects-on-github/automation-for-release-forms-with-query-parameters.md
+++ b/content/repositories/releasing-projects-on-github/automation-for-release-forms-with-query-parameters.md
@@ -10,6 +10,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Automate release forms
+category:
+ - Release software
---
Query parameters are optional parts of a URL you can customize to share a specific web page view, such as search filter results, an issue template, or the release form page on {% data variables.product.prodname_dotcom %}. To create your own query parameters, you must match the key and value pair.
diff --git a/content/repositories/releasing-projects-on-github/comparing-releases.md b/content/repositories/releasing-projects-on-github/comparing-releases.md
index 9340726a9482..46d3ba86c7e0 100644
--- a/content/repositories/releasing-projects-on-github/comparing-releases.md
+++ b/content/repositories/releasing-projects-on-github/comparing-releases.md
@@ -9,6 +9,8 @@ versions:
redirect_from:
- /github/administering-a-repository/comparing-releases
- /github/administering-a-repository/releasing-projects-on-github/comparing-releases
+category:
+ - Release software
---
{% data reusables.repositories.navigate-to-repo %}
{% data reusables.repositories.releases %}
diff --git a/content/repositories/releasing-projects-on-github/linking-to-releases.md b/content/repositories/releasing-projects-on-github/linking-to-releases.md
index f9a2c370cf6a..c92c0d018b0d 100644
--- a/content/repositories/releasing-projects-on-github/linking-to-releases.md
+++ b/content/repositories/releasing-projects-on-github/linking-to-releases.md
@@ -9,6 +9,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Release software
---
## Linking to the latest release
diff --git a/content/repositories/releasing-projects-on-github/managing-releases-in-a-repository.md b/content/repositories/releasing-projects-on-github/managing-releases-in-a-repository.md
index 75f61e70216a..69e22f0e7506 100644
--- a/content/repositories/releasing-projects-on-github/managing-releases-in-a-repository.md
+++ b/content/repositories/releasing-projects-on-github/managing-releases-in-a-repository.md
@@ -16,6 +16,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Manage releases
+category:
+ - Release software
---
## About release management
diff --git a/content/repositories/releasing-projects-on-github/searching-a-repositorys-releases.md b/content/repositories/releasing-projects-on-github/searching-a-repositorys-releases.md
index b520caedab9e..76277faaae56 100644
--- a/content/repositories/releasing-projects-on-github/searching-a-repositorys-releases.md
+++ b/content/repositories/releasing-projects-on-github/searching-a-repositorys-releases.md
@@ -7,6 +7,8 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
+category:
+ - Release software
---
## Searching for releases in a repository
diff --git a/content/repositories/releasing-projects-on-github/viewing-your-repositorys-releases-and-tags.md b/content/repositories/releasing-projects-on-github/viewing-your-repositorys-releases-and-tags.md
index 2ceaae814858..fa9747e8a304 100644
--- a/content/repositories/releasing-projects-on-github/viewing-your-repositorys-releases-and-tags.md
+++ b/content/repositories/releasing-projects-on-github/viewing-your-repositorys-releases-and-tags.md
@@ -12,6 +12,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: View releases & tags
+category:
+ - Release software
---
> [!TIP]
diff --git a/content/repositories/viewing-activity-and-data-for-your-repository/about-repository-graphs.md b/content/repositories/viewing-activity-and-data-for-your-repository/about-repository-graphs.md
index 8fa5731b45ef..900ec8cb2210 100644
--- a/content/repositories/viewing-activity-and-data-for-your-repository/about-repository-graphs.md
+++ b/content/repositories/viewing-activity-and-data-for-your-repository/about-repository-graphs.md
@@ -10,6 +10,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Track repository activity
---
A repository's graphs give you information on {% ifversion fpt or ghec %} traffic, projects that depend on the repository,{% endif %} contributors and commits to the repository, and a repository's forks and network. If you maintain a repository, you can use this data to get a better understanding of who's using your repository and why they're using it.
diff --git a/content/repositories/viewing-activity-and-data-for-your-repository/analyzing-changes-to-a-repositorys-content.md b/content/repositories/viewing-activity-and-data-for-your-repository/analyzing-changes-to-a-repositorys-content.md
index 1088b37f44d9..09336ac43c52 100644
--- a/content/repositories/viewing-activity-and-data-for-your-repository/analyzing-changes-to-a-repositorys-content.md
+++ b/content/repositories/viewing-activity-and-data-for-your-repository/analyzing-changes-to-a-repositorys-content.md
@@ -18,6 +18,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Analyze changes
+category:
+ - Track repository activity
---
## Visualizing commits in a repository
diff --git a/content/repositories/viewing-activity-and-data-for-your-repository/understanding-connections-between-repositories.md b/content/repositories/viewing-activity-and-data-for-your-repository/understanding-connections-between-repositories.md
index fd944cfc3205..472c4283b1d6 100644
--- a/content/repositories/viewing-activity-and-data-for-your-repository/understanding-connections-between-repositories.md
+++ b/content/repositories/viewing-activity-and-data-for-your-repository/understanding-connections-between-repositories.md
@@ -19,6 +19,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Connections between repositories
+category:
+ - Track repository activity
---
## Viewing a repository's network
diff --git a/content/repositories/viewing-activity-and-data-for-your-repository/using-pulse-to-view-a-summary-of-repository-activity.md b/content/repositories/viewing-activity-and-data-for-your-repository/using-pulse-to-view-a-summary-of-repository-activity.md
index e919776ffcc6..64b60918c0a0 100644
--- a/content/repositories/viewing-activity-and-data-for-your-repository/using-pulse-to-view-a-summary-of-repository-activity.md
+++ b/content/repositories/viewing-activity-and-data-for-your-repository/using-pulse-to-view-a-summary-of-repository-activity.md
@@ -12,6 +12,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Using Pulse
+category:
+ - Track repository activity
---
## About Pulse
diff --git a/content/repositories/viewing-activity-and-data-for-your-repository/using-the-activity-view-to-see-changes-to-a-repository.md b/content/repositories/viewing-activity-and-data-for-your-repository/using-the-activity-view-to-see-changes-to-a-repository.md
index ac736f111bbc..0da513afcf19 100644
--- a/content/repositories/viewing-activity-and-data-for-your-repository/using-the-activity-view-to-see-changes-to-a-repository.md
+++ b/content/repositories/viewing-activity-and-data-for-your-repository/using-the-activity-view-to-see-changes-to-a-repository.md
@@ -6,6 +6,8 @@ versions:
ghec: '*'
ghes: '*'
shortTitle: Using the activity view
+category:
+ - Track repository activity
---
## About the activity view
diff --git a/content/repositories/viewing-activity-and-data-for-your-repository/viewing-a-projects-contributors.md b/content/repositories/viewing-activity-and-data-for-your-repository/viewing-a-projects-contributors.md
index 96d2e0508d07..c6ce937a7601 100644
--- a/content/repositories/viewing-activity-and-data-for-your-repository/viewing-a-projects-contributors.md
+++ b/content/repositories/viewing-activity-and-data-for-your-repository/viewing-a-projects-contributors.md
@@ -13,6 +13,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: View project contributors
+category:
+ - Track repository activity
---
## About contributors
diff --git a/content/repositories/viewing-activity-and-data-for-your-repository/viewing-deployment-activity-for-your-repository.md b/content/repositories/viewing-activity-and-data-for-your-repository/viewing-deployment-activity-for-your-repository.md
index 2a2df732721e..66d62649ef71 100644
--- a/content/repositories/viewing-activity-and-data-for-your-repository/viewing-deployment-activity-for-your-repository.md
+++ b/content/repositories/viewing-activity-and-data-for-your-repository/viewing-deployment-activity-for-your-repository.md
@@ -10,6 +10,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: View deployment activity
+category:
+ - Track repository activity
---
> [!NOTE]
diff --git a/content/repositories/viewing-activity-and-data-for-your-repository/viewing-traffic-to-a-repository.md b/content/repositories/viewing-activity-and-data-for-your-repository/viewing-traffic-to-a-repository.md
index c17506431b2c..bce480941f0f 100644
--- a/content/repositories/viewing-activity-and-data-for-your-repository/viewing-traffic-to-a-repository.md
+++ b/content/repositories/viewing-activity-and-data-for-your-repository/viewing-traffic-to-a-repository.md
@@ -10,6 +10,8 @@ versions:
fpt: '*'
ghec: '*'
shortTitle: View repository traffic
+category:
+ - Track repository activity
---
You can navigate to referring sites, excluding search engines and {% data variables.product.github %} itself, from the links the specific paths were referred from. The popular content links to the specific content that generated traffic.
diff --git a/content/repositories/working-with-files/managing-files/adding-a-file-to-a-repository.md b/content/repositories/working-with-files/managing-files/adding-a-file-to-a-repository.md
index eb772df1a947..ae68557d1f16 100644
--- a/content/repositories/working-with-files/managing-files/adding-a-file-to-a-repository.md
+++ b/content/repositories/working-with-files/managing-files/adding-a-file-to-a-repository.md
@@ -15,6 +15,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Add a file
+category:
+ - Work with files
---
## Adding a file to a repository on {% data variables.product.github %}
diff --git a/content/repositories/working-with-files/managing-files/creating-new-files.md b/content/repositories/working-with-files/managing-files/creating-new-files.md
index 3ee93901bf8e..95e54cff7de5 100644
--- a/content/repositories/working-with-files/managing-files/creating-new-files.md
+++ b/content/repositories/working-with-files/managing-files/creating-new-files.md
@@ -9,6 +9,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Work with files
---
When creating a file on {% data variables.product.github %}, consider the following:
diff --git a/content/repositories/working-with-files/managing-files/customizing-how-changed-files-appear-on-github.md b/content/repositories/working-with-files/managing-files/customizing-how-changed-files-appear-on-github.md
index 83e3d2ec729a..068a1ce8ce5d 100644
--- a/content/repositories/working-with-files/managing-files/customizing-how-changed-files-appear-on-github.md
+++ b/content/repositories/working-with-files/managing-files/customizing-how-changed-files-appear-on-github.md
@@ -10,6 +10,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: How changed files appear
+category:
+ - Work with files
---
Use a _.gitattributes_ file to mark files that match a given "pattern" with the specified attributes. A _.gitattributes_ file uses the same rules for matching as _.gitignore_ files. For more information, see [PATTERN FORMAT](https://www.git-scm.com/docs/gitignore#_pattern_format) in the Git documentation.
diff --git a/content/repositories/working-with-files/managing-files/deleting-files-in-a-repository.md b/content/repositories/working-with-files/managing-files/deleting-files-in-a-repository.md
index 3de3e502b12f..5925b329a210 100644
--- a/content/repositories/working-with-files/managing-files/deleting-files-in-a-repository.md
+++ b/content/repositories/working-with-files/managing-files/deleting-files-in-a-repository.md
@@ -13,6 +13,8 @@ versions:
ghec: '*'
permissions: 'People with write permissions can delete files or directories in a repository.'
shortTitle: Delete files
+category:
+ - Work with files
---
## About file and directory deletion
diff --git a/content/repositories/working-with-files/managing-files/editing-files.md b/content/repositories/working-with-files/managing-files/editing-files.md
index d69d3e03c371..b974afaaa0b0 100644
--- a/content/repositories/working-with-files/managing-files/editing-files.md
+++ b/content/repositories/working-with-files/managing-files/editing-files.md
@@ -14,6 +14,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Edit files
+category:
+ - Work with files
---
## Editing files in your repository
diff --git a/content/repositories/working-with-files/managing-files/moving-a-file-to-a-new-location.md b/content/repositories/working-with-files/managing-files/moving-a-file-to-a-new-location.md
index 8da0dc2264b5..c676cc0e3a59 100644
--- a/content/repositories/working-with-files/managing-files/moving-a-file-to-a-new-location.md
+++ b/content/repositories/working-with-files/managing-files/moving-a-file-to-a-new-location.md
@@ -13,6 +13,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Move a file
+category:
+ - Work with files
---
In addition to changing the file location, you can also [update the contents of your file](/repositories/working-with-files/managing-files/editing-files), or [give it a new name](/repositories/working-with-files/managing-files/renaming-a-file) in the same commit.
diff --git a/content/repositories/working-with-files/managing-files/renaming-a-file.md b/content/repositories/working-with-files/managing-files/renaming-a-file.md
index 06f6c0c6fa68..846da93d3d44 100644
--- a/content/repositories/working-with-files/managing-files/renaming-a-file.md
+++ b/content/repositories/working-with-files/managing-files/renaming-a-file.md
@@ -12,6 +12,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Work with files
---
## Renaming a file on {% data variables.product.github %}
diff --git a/content/repositories/working-with-files/managing-large-files/about-git-large-file-storage.md b/content/repositories/working-with-files/managing-large-files/about-git-large-file-storage.md
index 4c26db7e360e..c501e969ef5c 100644
--- a/content/repositories/working-with-files/managing-large-files/about-git-large-file-storage.md
+++ b/content/repositories/working-with-files/managing-large-files/about-git-large-file-storage.md
@@ -11,6 +11,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Git Large File Storage
+category:
+ - Store large files with Git LFS
---
## About {% data variables.large_files.product_name_long %}
diff --git a/content/repositories/working-with-files/managing-large-files/about-large-files-on-github.md b/content/repositories/working-with-files/managing-large-files/about-large-files-on-github.md
index 9ce473e78917..cdb80438d2de 100644
--- a/content/repositories/working-with-files/managing-large-files/about-large-files-on-github.md
+++ b/content/repositories/working-with-files/managing-large-files/about-large-files-on-github.md
@@ -21,6 +21,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Large files
+category:
+ - Store large files with Git LFS
---
## About size limits on {% data variables.product.github %}
diff --git a/content/repositories/working-with-files/managing-large-files/collaboration-with-git-large-file-storage.md b/content/repositories/working-with-files/managing-large-files/collaboration-with-git-large-file-storage.md
index d272a12e397e..c9f505e0497e 100644
--- a/content/repositories/working-with-files/managing-large-files/collaboration-with-git-large-file-storage.md
+++ b/content/repositories/working-with-files/managing-large-files/collaboration-with-git-large-file-storage.md
@@ -11,6 +11,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Collaboration
+category:
+ - Store large files with Git LFS
---
If collaborators on your repository don't have {% data variables.large_files.product_name_short %} installed, they won't have access to the original large file. If they attempt to clone your repository, they will only fetch the pointer files, and won't have access to any of the actual data.
diff --git a/content/repositories/working-with-files/managing-large-files/configuring-git-large-file-storage.md b/content/repositories/working-with-files/managing-large-files/configuring-git-large-file-storage.md
index 1ab3d42cf659..c9ec49f2f320 100644
--- a/content/repositories/working-with-files/managing-large-files/configuring-git-large-file-storage.md
+++ b/content/repositories/working-with-files/managing-large-files/configuring-git-large-file-storage.md
@@ -11,6 +11,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Configure Git LFS
+category:
+ - Store large files with Git LFS
---
If there are existing files in your repository that you'd like to use with {% data variables.product.github %}, you need to first remove them from the repository and then add them to {% data variables.large_files.product_name_short %} locally. For more information, see [AUTOTITLE](/repositories/working-with-files/managing-large-files/moving-a-file-in-your-repository-to-git-large-file-storage).
diff --git a/content/repositories/working-with-files/managing-large-files/installing-git-large-file-storage.md b/content/repositories/working-with-files/managing-large-files/installing-git-large-file-storage.md
index 3368f4de50d7..5aeecdc572bd 100644
--- a/content/repositories/working-with-files/managing-large-files/installing-git-large-file-storage.md
+++ b/content/repositories/working-with-files/managing-large-files/installing-git-large-file-storage.md
@@ -11,6 +11,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Install Git LFS
+category:
+ - Store large files with Git LFS
---
{% mac %}
diff --git a/content/repositories/working-with-files/managing-large-files/moving-a-file-in-your-repository-to-git-large-file-storage.md b/content/repositories/working-with-files/managing-large-files/moving-a-file-in-your-repository-to-git-large-file-storage.md
index 1816ad4a63d7..99465d9af14a 100644
--- a/content/repositories/working-with-files/managing-large-files/moving-a-file-in-your-repository-to-git-large-file-storage.md
+++ b/content/repositories/working-with-files/managing-large-files/moving-a-file-in-your-repository-to-git-large-file-storage.md
@@ -10,6 +10,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Move a file to Git LFS
+category:
+ - Store large files with Git LFS
---
After installing {% data variables.large_files.product_name_short %} and configuring {% data variables.large_files.product_name_short %} tracking, you can move files from Git's regular tracking to {% data variables.large_files.product_name_short %}. For more information, see [AUTOTITLE](/repositories/working-with-files/managing-large-files/installing-git-large-file-storage) and [AUTOTITLE](/repositories/working-with-files/managing-large-files/configuring-git-large-file-storage).
diff --git a/content/repositories/working-with-files/managing-large-files/removing-files-from-git-large-file-storage.md b/content/repositories/working-with-files/managing-large-files/removing-files-from-git-large-file-storage.md
index 07399fd12279..c9012c593c49 100644
--- a/content/repositories/working-with-files/managing-large-files/removing-files-from-git-large-file-storage.md
+++ b/content/repositories/working-with-files/managing-large-files/removing-files-from-git-large-file-storage.md
@@ -10,6 +10,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Remove files
+category:
+ - Store large files with Git LFS
---
## Removing a single file
diff --git a/content/repositories/working-with-files/managing-large-files/resolving-git-large-file-storage-upload-failures.md b/content/repositories/working-with-files/managing-large-files/resolving-git-large-file-storage-upload-failures.md
index 6194411f6f5c..5201c2ebd3f0 100644
--- a/content/repositories/working-with-files/managing-large-files/resolving-git-large-file-storage-upload-failures.md
+++ b/content/repositories/working-with-files/managing-large-files/resolving-git-large-file-storage-upload-failures.md
@@ -10,6 +10,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Resolve upload failures
+category:
+ - Store large files with Git LFS
---
The {% data variables.large_files.product_name_short %} integrity check ensures that all referenced {% data variables.large_files.product_name_short %} files in a push have been uploaded properly. If the check detects referenced files that have not been uploaded, you will receive an error message and your push will be blocked.
diff --git a/content/repositories/working-with-files/using-files/downloading-source-code-archives.md b/content/repositories/working-with-files/using-files/downloading-source-code-archives.md
index 663ab5f0b248..508b59d382f0 100644
--- a/content/repositories/working-with-files/using-files/downloading-source-code-archives.md
+++ b/content/repositories/working-with-files/using-files/downloading-source-code-archives.md
@@ -6,6 +6,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Source code archives
+category:
+ - Work with files
---
## Overview of source code archives
diff --git a/content/repositories/working-with-files/using-files/getting-permanent-links-to-files.md b/content/repositories/working-with-files/using-files/getting-permanent-links-to-files.md
index da2e21609745..12421e69bb05 100644
--- a/content/repositories/working-with-files/using-files/getting-permanent-links-to-files.md
+++ b/content/repositories/working-with-files/using-files/getting-permanent-links-to-files.md
@@ -12,6 +12,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Permanent links to files
+category:
+ - Work with files
---
> [!TIP]
diff --git a/content/repositories/working-with-files/using-files/navigating-code-on-github.md b/content/repositories/working-with-files/using-files/navigating-code-on-github.md
index 314f95a1b094..94ab1b9871a8 100644
--- a/content/repositories/working-with-files/using-files/navigating-code-on-github.md
+++ b/content/repositories/working-with-files/using-files/navigating-code-on-github.md
@@ -8,6 +8,8 @@ redirect_from:
versions:
fpt: '*'
ghec: '*'
+category:
+ - Work with files
---
diff --git a/content/repositories/working-with-files/using-files/viewing-and-understanding-files.md b/content/repositories/working-with-files/using-files/viewing-and-understanding-files.md
index ab30847249bb..c2cd70f9f0c9 100644
--- a/content/repositories/working-with-files/using-files/viewing-and-understanding-files.md
+++ b/content/repositories/working-with-files/using-files/viewing-and-understanding-files.md
@@ -14,6 +14,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: View and understand files
+category:
+ - Work with files
---
{% data variables.product.github %} provides tools to view raw content, trace changes to specific lines, and explore how a file’s content has evolved over time. These insights reveal how code was developed, its current purpose, and its structure, helping you contribute effectively.
diff --git a/content/repositories/working-with-files/using-files/working-with-non-code-files.md b/content/repositories/working-with-files/using-files/working-with-non-code-files.md
index 24af54072edd..d9d8bb7cbf78 100644
--- a/content/repositories/working-with-files/using-files/working-with-non-code-files.md
+++ b/content/repositories/working-with-files/using-files/working-with-non-code-files.md
@@ -30,6 +30,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Working with non-code files
+category:
+ - Work with files
---
## Rendering and diffing images
From 2fabb882218723a6993241186e0f70f1b8d95515 Mon Sep 17 00:00:00 2001
From: Ben Ahmady <32935794+subatoi@users.noreply.github.com>
Date: Thu, 12 Mar 2026 17:16:31 +0000
Subject: [PATCH 3/8] Update default API version date (#60184)
---
content/rest/about-the-rest-api/api-versions.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/content/rest/about-the-rest-api/api-versions.md b/content/rest/about-the-rest-api/api-versions.md
index dccb031bd9dd..fc5d21eec411 100644
--- a/content/rest/about-the-rest-api/api-versions.md
+++ b/content/rest/about-the-rest-api/api-versions.md
@@ -32,7 +32,7 @@ You should use the `X-GitHub-Api-Version` header to specify an API version. For
curl {% data reusables.rest-api.version-header %} https://api.github.com/zen
```
-Requests without the `X-GitHub-Api-Version` header will default to use the `{{ initialRestVersioningReleaseDate }}` version.
+Requests without the `X-GitHub-Api-Version` header will default to use the `2022-11-28` version.
If you specify an API version that is no longer supported, you will receive a `400` error.
From d090b935c2d7e3a199532350d1612edbaaaa35b3 Mon Sep 17 00:00:00 2001
From: Joe Clark <31087804+jc-clark@users.noreply.github.com>
Date: Thu, 12 Mar 2026 10:31:15 -0700
Subject: [PATCH 4/8] Add landing page categories for content/actions (#60095)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
content/actions/concepts/billing-and-usage.md | 2 +
content/actions/concepts/metrics.md | 2 +
.../runners/actions-runner-controller.md | 2 +
.../concepts/runners/github-hosted-runners.md | 2 +
.../concepts/runners/larger-runners.md | 2 +
.../concepts/runners/private-networking.md | 2 +
.../actions/concepts/runners/runner-groups.md | 2 +
.../concepts/runners/runner-scale-sets.md | 2 +
.../concepts/runners/self-hosted-runners.md | 2 +
.../concepts/runners/support-for-arc.md | 2 +
.../security/artifact-attestations.md | 2 +
.../concepts/security/compromised-runners.md | 2 +
.../actions/concepts/security/github_token.md | 2 +
.../kubernetes-admissions-controller.md | 2 +
.../concepts/security/openid-connect.md | 2 +
.../concepts/security/script-injections.md | 2 +
content/actions/concepts/security/secrets.md | 2 +
.../workflows-and-actions/concurrency.md | 2 +
.../workflows-and-actions/contexts.md | 2 +
.../workflows-and-actions/custom-actions.md | 2 +
.../dependency-caching.md | 2 +
.../deployment-environments.md | 2 +
.../workflows-and-actions/expressions.md | 2 +
.../notifications-for-workflow-runs.md | 2 +
.../reusing-workflow-configurations.md | 2 +
.../workflows-and-actions/variables.md | 2 +
.../workflow-artifacts.md | 2 +
.../workflows-and-actions/workflows.md | 2 +
.../actions/get-started/actions-vs-apps.md | 2 +
.../get-started/continuous-deployment.md | 2 +
.../get-started/continuous-integration.md | 2 +
content/actions/get-started/quickstart.md | 2 +
.../get-started/understand-github-actions.md | 2 +
.../administer/reuse-namespaces-on-ghecom.md | 2 +
.../how-tos/administer/view-metrics.md | 2 +
.../create-a-cli-action.md | 2 +
.../manage-custom-actions.md | 2 +
.../publish-in-github-marketplace.md | 2 +
.../release-and-maintain-actions.md | 2 +
.../set-exit-codes.md | 2 +
...nd-tags-to-manage-your-actions-releases.md | 2 +
.../configure-custom-protection-rules.md | 2 +
.../control-deployments.md | 2 +
.../create-custom-protection-rules.md | 2 +
.../manage-environments.md | 2 +
.../review-deployments.md | 2 +
.../view-deployment-history.md | 2 +
.../amazon-elastic-container-service.md | 2 +
.../azure-kubernetes-service.md | 2 +
.../azure-static-web-app.md | 2 +
.../docker-to-azure-app-service.md | 2 +
.../google-kubernetes-engine.md | 2 +
.../java-to-azure-app-service.md | 2 +
.../net-to-azure-app-service.md | 2 +
.../nodejs-to-azure-app-service.md | 2 +
.../php-to-azure-app-service.md | 2 +
.../python-to-azure-app-service.md | 2 +
.../sign-xcode-applications.md | 2 +
content/actions/how-tos/get-support.md | 2 +
.../connect-with-oidc.md | 2 +
.../connect-with-wireguard.md | 2 +
.../customize-runners.md | 2 +
.../use-github-hosted-runners.md | 2 +
.../view-current-jobs.md | 2 +
.../larger-runners/control-access.md | 2 +
.../larger-runners/manage-larger-runners.md | 2 +
.../larger-runners/use-custom-images.md | 2 +
.../larger-runners/use-larger-runners.md | 2 +
.../self-hosted-runners/add-runners.md | 2 +
.../self-hosted-runners/apply-labels.md | 2 +
.../configure-the-application.md | 2 +
.../customize-containers.md | 2 +
.../self-hosted-runners/manage-access.md | 2 +
.../monitor-and-troubleshoot.md | 2 +
.../self-hosted-runners/remove-runners.md | 2 +
.../self-hosted-runners/run-scripts.md | 2 +
.../self-hosted-runners/use-in-a-workflow.md | 2 +
.../manage-runners/use-proxy-servers.md | 2 +
.../approve-runs-from-forks.md | 2 +
.../cancel-a-workflow-run.md | 2 +
.../delete-a-workflow-run.md | 2 +
.../disable-and-enable-workflows.md | 2 +
.../download-workflow-artifacts.md | 2 +
.../manage-workflow-runs/manage-caches.md | 2 +
.../manually-run-a-workflow.md | 2 +
.../re-run-workflows-and-jobs.md | 2 +
.../remove-workflow-artifacts.md | 2 +
.../skip-workflow-runs.md | 2 +
.../monitor-workflows/add-a-status-badge.md | 2 +
.../monitor-workflows/enable-debug-logging.md | 2 +
.../use-the-visualization-graph.md | 2 +
.../use-workflow-run-logs.md | 2 +
.../view-job-condition-logs.md | 2 +
.../view-job-execution-time.md | 2 +
.../view-workflow-run-history.md | 2 +
.../create-workflow-templates.md | 2 +
.../reuse-automations/reuse-workflows.md | 2 +
.../share-across-private-repositories.md | 2 +
.../share-with-your-enterprise.md | 2 +
.../share-with-your-organization.md | 2 +
.../oidc-in-aws.md | 2 +
.../oidc-in-azure.md | 2 +
.../oidc-in-cloud-providers.md | 2 +
.../oidc-in-google-cloud-platform.md | 2 +
.../oidc-in-hashicorp-vault.md | 2 +
.../oidc-in-jfrog.md | 2 +
.../oidc-in-octopus-deploy.md | 2 +
.../oidc-in-pypi.md | 2 +
.../oidc-with-reusable-workflows.md | 2 +
.../enforce-artifact-attestations.md | 2 +
.../increase-security-rating.md | 2 +
.../manage-attestations.md | 2 +
.../use-artifact-attestations.md | 2 +
.../verify-attestations-offline.md | 2 +
.../actions/how-tos/troubleshoot-workflows.md | 2 +
.../choose-what-workflows-do/add-scripts.md | 2 +
.../deploy-to-environment.md | 2 +
.../find-and-customize-actions.md | 2 +
.../pass-job-outputs.md | 2 +
.../run-job-variations.md | 2 +
.../set-default-values-for-jobs.md | 2 +
.../use-github-cli.md | 2 +
.../choose-what-workflows-do/use-jobs.md | 2 +
.../choose-what-workflows-do/use-secrets.md | 2 +
.../choose-what-workflows-do/use-variables.md | 2 +
.../control-jobs-with-conditions.md | 2 +
.../control-workflow-concurrency.md | 2 +
.../trigger-a-workflow.md | 2 +
.../choose-the-runner-for-a-job.md | 2 +
.../run-jobs-in-a-container.md | 2 +
.../write-workflows/use-workflow-templates.md | 2 +
content/actions/index.md | 40 ++++++++++++-------
.../custom-transformers.md | 2 +
.../supplemental-arguments-and-settings.md | 2 +
content/actions/reference/limits.md | 2 +
.../runners/github-hosted-runners.md | 2 +
.../reference/runners/larger-runners.md | 2 +
.../reference/runners/self-hosted-runners.md | 2 +
content/actions/reference/security/oidc.md | 2 +
content/actions/reference/security/secrets.md | 2 +
.../actions/reference/security/secure-use.md | 2 +
.../workflows-and-actions/contexts.md | 2 +
.../dependency-caching.md | 2 +
.../deployments-and-environments.md | 2 +
.../dockerfile-support.md | 2 +
.../events-that-trigger-workflows.md | 2 +
.../workflows-and-actions/expressions.md | 2 +
.../workflows-and-actions/metadata-syntax.md | 2 +
.../reusing-workflow-configurations.md | 2 +
.../workflows-and-actions/variables.md | 2 +
.../workflow-cancellation.md | 2 +
.../workflow-commands.md | 2 +
.../workflows-and-actions/workflow-syntax.md | 2 +
.../authenticate-with-github_token.md | 2 +
.../tutorials/build-and-test-code/go.md | 2 +
.../build-and-test-code/java-with-ant.md | 2 +
.../build-and-test-code/java-with-gradle.md | 2 +
.../build-and-test-code/java-with-maven.md | 2 +
.../tutorials/build-and-test-code/net.md | 2 +
.../tutorials/build-and-test-code/nodejs.md | 2 +
.../build-and-test-code/powershell.md | 2 +
.../tutorials/build-and-test-code/python.md | 2 +
.../tutorials/build-and-test-code/ruby.md | 2 +
.../tutorials/build-and-test-code/rust.md | 2 +
.../tutorials/build-and-test-code/swift.md | 2 +
.../build-and-test-code/xamarin-apps.md | 2 +
.../create-a-composite-action.md | 2 +
.../create-a-javascript-action.md | 2 +
.../tutorials/create-an-example-workflow.md | 2 +
.../add-comments-with-labels.md | 2 +
.../manage-your-work/add-labels-to-issues.md | 2 +
.../manage-your-work/close-inactive-issues.md | 2 +
.../schedule-issue-creation.md | 2 +
.../azure-devops-migration.md | 2 +
.../automated-migrations/bamboo-migration.md | 2 +
.../bitbucket-pipelines-migration.md | 2 +
.../circleci-migration.md | 2 +
.../automated-migrations/gitlab-migration.md | 2 +
.../automated-migrations/jenkins-migration.md | 2 +
.../travis-ci-migration.md | 2 +
.../use-github-actions-importer.md | 2 +
.../migrate-from-azure-pipelines.md | 2 +
.../migrate-from-circleci.md | 2 +
.../migrate-from-gitlab-cicd.md | 2 +
.../manual-migrations/migrate-from-jenkins.md | 2 +
.../migrate-from-travis-ci.md | 2 +
.../tutorials/migrate-to-github-runners.md | 2 +
.../publish-packages/publish-docker-images.md | 2 +
.../publish-java-packages-with-gradle.md | 2 +
.../publish-java-packages-with-maven.md | 2 +
.../publish-nodejs-packages.md | 2 +
.../actions/tutorials/store-and-share-data.md | 2 +
.../authenticate-to-the-api.md | 2 +
.../deploy-runner-scale-sets.md | 2 +
.../use-actions-runner-controller/index.md | 13 +++++-
.../quickstart.md | 2 +
.../troubleshoot.md | 2 +
.../use-arc-in-a-workflow.md | 2 +
.../create-a-docker-container-action.md | 2 +
.../create-postgresql-service-containers.md | 2 +
.../create-redis-service-containers.md | 2 +
.../use-docker-service-containers.md | 2 +
202 files changed, 438 insertions(+), 15 deletions(-)
diff --git a/content/actions/concepts/billing-and-usage.md b/content/actions/concepts/billing-and-usage.md
index dd4129872902..1986bd372733 100644
--- a/content/actions/concepts/billing-and-usage.md
+++ b/content/actions/concepts/billing-and-usage.md
@@ -11,6 +11,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Administer GitHub Actions
---
## About billing for {% data variables.product.prodname_actions %}
diff --git a/content/actions/concepts/metrics.md b/content/actions/concepts/metrics.md
index 1f1484c076cf..fcd296ea9085 100644
--- a/content/actions/concepts/metrics.md
+++ b/content/actions/concepts/metrics.md
@@ -7,6 +7,8 @@ versions:
feature: actions-metrics
redirect_from:
- /actions/concepts/about-github-actions-metrics
+category:
+ - Administer GitHub Actions
---
{% data reusables.actions.about-actions-metrics %}
diff --git a/content/actions/concepts/runners/actions-runner-controller.md b/content/actions/concepts/runners/actions-runner-controller.md
index d44fe3a634fb..5295796b70b4 100644
--- a/content/actions/concepts/runners/actions-runner-controller.md
+++ b/content/actions/concepts/runners/actions-runner-controller.md
@@ -8,6 +8,8 @@ versions:
redirect_from:
- /actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/about-actions-runner-controller
- /actions/concepts/runners/about-actions-runner-controller
+category:
+ - Set up runners
---
## About {% data variables.product.prodname_actions_runner_controller %}
diff --git a/content/actions/concepts/runners/github-hosted-runners.md b/content/actions/concepts/runners/github-hosted-runners.md
index 78298ccfbac9..67d4309179ee 100644
--- a/content/actions/concepts/runners/github-hosted-runners.md
+++ b/content/actions/concepts/runners/github-hosted-runners.md
@@ -18,6 +18,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Set up runners
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/concepts/runners/larger-runners.md b/content/actions/concepts/runners/larger-runners.md
index e624d65bab73..8eadd4cf9b6f 100644
--- a/content/actions/concepts/runners/larger-runners.md
+++ b/content/actions/concepts/runners/larger-runners.md
@@ -10,6 +10,8 @@ redirect_from:
- /actions/using-github-hosted-runners/about-larger-runners/about-larger-runners
- /actions/using-github-hosted-runners/using-larger-runners/about-larger-runners
- /actions/concepts/runners/about-larger-runners
+category:
+ - Set up runners
---
{% ifversion ghes %}
diff --git a/content/actions/concepts/runners/private-networking.md b/content/actions/concepts/runners/private-networking.md
index eaaf772fed99..1a0213199223 100644
--- a/content/actions/concepts/runners/private-networking.md
+++ b/content/actions/concepts/runners/private-networking.md
@@ -10,6 +10,8 @@ redirect_from:
- /actions/using-github-hosted-runners/connecting-to-a-private-network/about-private-networking-with-github-hosted-runners
- /actions/concepts/runners/about-private-networking-with-github-hosted-runners
- /actions/concepts/runners/private-networking-with-github-hosted-runners
+category:
+ - Set up runners
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/concepts/runners/runner-groups.md b/content/actions/concepts/runners/runner-groups.md
index 5c943ddfa07e..be208d77cc4e 100644
--- a/content/actions/concepts/runners/runner-groups.md
+++ b/content/actions/concepts/runners/runner-groups.md
@@ -7,6 +7,8 @@ versions:
ghes: '*'
redirect_from:
- /actions/concepts/runners/about-runner-groups
+category:
+ - Set up runners
---
## About runner groups
diff --git a/content/actions/concepts/runners/runner-scale-sets.md b/content/actions/concepts/runners/runner-scale-sets.md
index 28183303ee60..970e67fba490 100644
--- a/content/actions/concepts/runners/runner-scale-sets.md
+++ b/content/actions/concepts/runners/runner-scale-sets.md
@@ -8,6 +8,8 @@ versions:
ghes: '*'
redirect_from:
- /actions/concepts/runners/about-runner-scale-sets
+category:
+ - Set up runners
---
## About runner scale sets
diff --git a/content/actions/concepts/runners/self-hosted-runners.md b/content/actions/concepts/runners/self-hosted-runners.md
index 9228131a9113..d0628461267d 100644
--- a/content/actions/concepts/runners/self-hosted-runners.md
+++ b/content/actions/concepts/runners/self-hosted-runners.md
@@ -13,6 +13,8 @@ versions:
ghes: '*'
ghec: '*'
contentType: concepts
+category:
+ - Set up runners
---
A self-hosted runner is a system that you deploy and manage to execute jobs from {% data variables.product.prodname_actions %} on {% data variables.product.github %}.
diff --git a/content/actions/concepts/runners/support-for-arc.md b/content/actions/concepts/runners/support-for-arc.md
index 73012a336038..3c7523fda58b 100644
--- a/content/actions/concepts/runners/support-for-arc.md
+++ b/content/actions/concepts/runners/support-for-arc.md
@@ -10,6 +10,8 @@ redirect_from:
- /actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/about-support-for-actions-runner-controller
- /actions/concepts/runners/about-support-for-actions-runner-controller
- /actions/concepts/runners/support-for-actions-runner-controller
+category:
+ - Set up runners
---
## Overview
diff --git a/content/actions/concepts/security/artifact-attestations.md b/content/actions/concepts/security/artifact-attestations.md
index bdc7f680d2e0..3f6d25383286 100644
--- a/content/actions/concepts/security/artifact-attestations.md
+++ b/content/actions/concepts/security/artifact-attestations.md
@@ -4,6 +4,8 @@ intro: 'Understand the usage and security benefits of artifact attestations.'
versions:
fpt: '*'
ghec: '*'
+category:
+ - Secure your workflows
---
## Overview
diff --git a/content/actions/concepts/security/compromised-runners.md b/content/actions/concepts/security/compromised-runners.md
index 9e813d064af3..c06fe7cc388c 100644
--- a/content/actions/concepts/security/compromised-runners.md
+++ b/content/actions/concepts/security/compromised-runners.md
@@ -7,6 +7,8 @@ versions:
ghec: '*'
redirect_from:
- /actions/concepts/security/compromised-runner
+category:
+ - Secure your workflows
---
## Potential impact of a compromised runner
diff --git a/content/actions/concepts/security/github_token.md b/content/actions/concepts/security/github_token.md
index edfc7d24030a..771cebec89d6 100644
--- a/content/actions/concepts/security/github_token.md
+++ b/content/actions/concepts/security/github_token.md
@@ -5,6 +5,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Secure your workflows
---
## About the `GITHUB_TOKEN`
diff --git a/content/actions/concepts/security/kubernetes-admissions-controller.md b/content/actions/concepts/security/kubernetes-admissions-controller.md
index 426ad30c8e50..d3f1e78233df 100644
--- a/content/actions/concepts/security/kubernetes-admissions-controller.md
+++ b/content/actions/concepts/security/kubernetes-admissions-controller.md
@@ -4,6 +4,8 @@ intro: Understand how you can use an admissions controller to enforce artifact a
versions:
fpt: '*'
ghec: '*'
+category:
+ - Secure your workflows
---
## About Kubernetes admission controller
diff --git a/content/actions/concepts/security/openid-connect.md b/content/actions/concepts/security/openid-connect.md
index d0fb16da9979..006209a28132 100644
--- a/content/actions/concepts/security/openid-connect.md
+++ b/content/actions/concepts/security/openid-connect.md
@@ -10,6 +10,8 @@ redirect_from:
- /actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect
- /actions/security-for-github-actions/security-hardening-your-deployments/about-security-hardening-with-openid-connect
- /actions/concepts/security/about-security-hardening-with-openid-connect
+category:
+ - Secure your workflows
---
## Overview of OpenID Connect (OIDC)
diff --git a/content/actions/concepts/security/script-injections.md b/content/actions/concepts/security/script-injections.md
index a93a9d2ecb81..ad69277721c1 100644
--- a/content/actions/concepts/security/script-injections.md
+++ b/content/actions/concepts/security/script-injections.md
@@ -5,6 +5,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Secure your workflows
---
## Understanding the risk of script injections
diff --git a/content/actions/concepts/security/secrets.md b/content/actions/concepts/security/secrets.md
index ca2db4136dc9..4fec45054d62 100644
--- a/content/actions/concepts/security/secrets.md
+++ b/content/actions/concepts/security/secrets.md
@@ -8,6 +8,8 @@ versions:
redirect_from:
- /actions/security-for-github-actions/security-guides/about-secrets
- /actions/concepts/security/about-secrets
+category:
+ - Secure your workflows
---
## About secrets
diff --git a/content/actions/concepts/workflows-and-actions/concurrency.md b/content/actions/concepts/workflows-and-actions/concurrency.md
index a1209aa3f836..5a1fbc2cd375 100644
--- a/content/actions/concepts/workflows-and-actions/concurrency.md
+++ b/content/actions/concepts/workflows-and-actions/concurrency.md
@@ -6,6 +6,8 @@ versions:
ghes: '*'
ghec: '*'
type: overview
+category:
+ - Write workflows
---
By default, {% data variables.product.prodname_actions %} allows multiple jobs within the same workflow, multiple workflow runs within the same repository, and multiple workflow runs across a repository owner's account to run concurrently. This means that multiple instances of the same workflow or job can run at the same time, performing the same steps.
diff --git a/content/actions/concepts/workflows-and-actions/contexts.md b/content/actions/concepts/workflows-and-actions/contexts.md
index 0b7dd72d56d7..153fe92c0218 100644
--- a/content/actions/concepts/workflows-and-actions/contexts.md
+++ b/content/actions/concepts/workflows-and-actions/contexts.md
@@ -6,6 +6,8 @@ versions:
ghes: '*'
ghec: '*'
type: overview
+category:
+ - Write workflows
---
## About contexts
diff --git a/content/actions/concepts/workflows-and-actions/custom-actions.md b/content/actions/concepts/workflows-and-actions/custom-actions.md
index f680f14d825e..6a0fb6228af0 100644
--- a/content/actions/concepts/workflows-and-actions/custom-actions.md
+++ b/content/actions/concepts/workflows-and-actions/custom-actions.md
@@ -16,6 +16,8 @@ versions:
ghes: '*'
ghec: '*'
type: overview
+category:
+ - Reuse and share automations
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/concepts/workflows-and-actions/dependency-caching.md b/content/actions/concepts/workflows-and-actions/dependency-caching.md
index 042cdba50140..19222e3d6af7 100644
--- a/content/actions/concepts/workflows-and-actions/dependency-caching.md
+++ b/content/actions/concepts/workflows-and-actions/dependency-caching.md
@@ -6,6 +6,8 @@ versions:
ghes: '*'
ghec: '*'
type: overview
+category:
+ - Write workflows
---
## About workflow dependency caching
diff --git a/content/actions/concepts/workflows-and-actions/deployment-environments.md b/content/actions/concepts/workflows-and-actions/deployment-environments.md
index 6a7f9c9ed8fe..058446027c5f 100644
--- a/content/actions/concepts/workflows-and-actions/deployment-environments.md
+++ b/content/actions/concepts/workflows-and-actions/deployment-environments.md
@@ -6,6 +6,8 @@ versions:
ghes: '*'
ghec: '*'
type: overview
+category:
+ - Deploy to environments
---
{% data reusables.actions.about-environments %}
diff --git a/content/actions/concepts/workflows-and-actions/expressions.md b/content/actions/concepts/workflows-and-actions/expressions.md
index ab8ee5045a70..8ca999d61a76 100644
--- a/content/actions/concepts/workflows-and-actions/expressions.md
+++ b/content/actions/concepts/workflows-and-actions/expressions.md
@@ -6,6 +6,8 @@ versions:
ghes: '*'
ghec: '*'
type: overview
+category:
+ - Write workflows
---
## About expressions
diff --git a/content/actions/concepts/workflows-and-actions/notifications-for-workflow-runs.md b/content/actions/concepts/workflows-and-actions/notifications-for-workflow-runs.md
index bab61ae01bd7..d77d4380747b 100644
--- a/content/actions/concepts/workflows-and-actions/notifications-for-workflow-runs.md
+++ b/content/actions/concepts/workflows-and-actions/notifications-for-workflow-runs.md
@@ -8,6 +8,8 @@ versions:
redirect_from:
- /actions/monitoring-and-troubleshooting-workflows/notifications-for-workflow-runs
- /actions/monitoring-and-troubleshooting-workflows/monitoring-workflows/notifications-for-workflow-runs
+category:
+ - Write workflows
---
If you enable email or web notifications for {% data variables.product.prodname_actions %}, you'll receive a notification when any workflow runs that you've triggered have completed. The notification will include the workflow run's status (including successful, failed, neutral, and canceled runs). You can also choose to receive a notification only when a workflow run has failed. For more information about enabling or disabling notifications, see [AUTOTITLE](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/about-notifications).
diff --git a/content/actions/concepts/workflows-and-actions/reusing-workflow-configurations.md b/content/actions/concepts/workflows-and-actions/reusing-workflow-configurations.md
index 99827ecf3b68..3b6d68073f53 100644
--- a/content/actions/concepts/workflows-and-actions/reusing-workflow-configurations.md
+++ b/content/actions/concepts/workflows-and-actions/reusing-workflow-configurations.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/sharing-automations/avoiding-duplication
- /actions/concepts/workflows-and-actions/avoiding-duplication
- /actions/concepts/workflows-and-actions/reusable-workflows
+category:
+ - Reuse and share automations
---
## Reusable workflows
diff --git a/content/actions/concepts/workflows-and-actions/variables.md b/content/actions/concepts/workflows-and-actions/variables.md
index 0a5daae8a2c6..1aad17f729f0 100644
--- a/content/actions/concepts/workflows-and-actions/variables.md
+++ b/content/actions/concepts/workflows-and-actions/variables.md
@@ -6,6 +6,8 @@ versions:
ghes: '*'
ghec: '*'
type: overview
+category:
+ - Write workflows
---
## About
diff --git a/content/actions/concepts/workflows-and-actions/workflow-artifacts.md b/content/actions/concepts/workflows-and-actions/workflow-artifacts.md
index 4119ac1cd869..a820b0254baa 100644
--- a/content/actions/concepts/workflows-and-actions/workflow-artifacts.md
+++ b/content/actions/concepts/workflows-and-actions/workflow-artifacts.md
@@ -6,6 +6,8 @@ versions:
ghes: '*'
ghec: '*'
type: overview
+category:
+ - Write workflows
---
## About workflow artifacts
diff --git a/content/actions/concepts/workflows-and-actions/workflows.md b/content/actions/concepts/workflows-and-actions/workflows.md
index 9d641cb44bd3..fd2bbda0a951 100644
--- a/content/actions/concepts/workflows-and-actions/workflows.md
+++ b/content/actions/concepts/workflows-and-actions/workflows.md
@@ -15,6 +15,8 @@ redirect_from:
- /actions/concepts/use-cases/using-github-actions-for-project-management
- /actions/concepts/workflows-and-actions/about-workflows
layout: inline
+category:
+ - Write workflows
---
## About workflows
diff --git a/content/actions/get-started/actions-vs-apps.md b/content/actions/get-started/actions-vs-apps.md
index 6b022887ae51..dd3c3c84969c 100644
--- a/content/actions/get-started/actions-vs-apps.md
+++ b/content/actions/get-started/actions-vs-apps.md
@@ -10,6 +10,8 @@ type: overview
redirect_from:
- /actions/concepts/overview/github-actions-vs-github-apps
- /actions/get-started/github-actions-vs-github-apps
+category:
+ - Get started with GitHub Actions
---
{% data variables.product.prodname_marketplace %} offers both {% data variables.product.prodname_actions %} and {% data variables.product.prodname_github_apps %}, each of which can be valuable automation and workflow tools. Understanding the differences and the benefits of each option will allow you to select the best fit for your job.
diff --git a/content/actions/get-started/continuous-deployment.md b/content/actions/get-started/continuous-deployment.md
index ebce55e0f778..9d63e91781f6 100644
--- a/content/actions/get-started/continuous-deployment.md
+++ b/content/actions/get-started/continuous-deployment.md
@@ -14,6 +14,8 @@ redirect_from:
- /actions/about-github-actions/about-continuous-deployment-with-github-actions
- /actions/concepts/overview/about-continuous-deployment-with-github-actions
- /actions/concepts/overview/continuous-deployment
+category:
+ - Get started with GitHub Actions
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/get-started/continuous-integration.md b/content/actions/get-started/continuous-integration.md
index 545a7bdfa296..bec70d2bcb87 100644
--- a/content/actions/get-started/continuous-integration.md
+++ b/content/actions/get-started/continuous-integration.md
@@ -17,6 +17,8 @@ versions:
ghes: '*'
ghec: '*'
type: overview
+category:
+ - Get started with GitHub Actions
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/get-started/quickstart.md b/content/actions/get-started/quickstart.md
index 81bfced7e843..7e69d217b197 100644
--- a/content/actions/get-started/quickstart.md
+++ b/content/actions/get-started/quickstart.md
@@ -13,6 +13,8 @@ versions:
ghec: '*'
type: quick_start
shortTitle: Quickstart
+category:
+ - Get started with GitHub Actions
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/get-started/understand-github-actions.md b/content/actions/get-started/understand-github-actions.md
index 3fba6d9eec35..c85c7566e094 100644
--- a/content/actions/get-started/understand-github-actions.md
+++ b/content/actions/get-started/understand-github-actions.md
@@ -17,6 +17,8 @@ versions:
ghes: '*'
ghec: '*'
type: overview
+category:
+ - Get started with GitHub Actions
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/administer/reuse-namespaces-on-ghecom.md b/content/actions/how-tos/administer/reuse-namespaces-on-ghecom.md
index 8631f35db3c2..187b2c4aed47 100644
--- a/content/actions/how-tos/administer/reuse-namespaces-on-ghecom.md
+++ b/content/actions/how-tos/administer/reuse-namespaces-on-ghecom.md
@@ -9,6 +9,8 @@ permissions: Enterprise owners
redirect_from:
- /actions/administering-github-actions/making-retired-namespaces-available-on-ghecom
- /actions/how-tos/administering-github-actions/making-retired-namespaces-available-on-ghecom
+category:
+ - Administer GitHub Actions
---
## Overview
diff --git a/content/actions/how-tos/administer/view-metrics.md b/content/actions/how-tos/administer/view-metrics.md
index 7018fa72e543..1d0d689c6e1c 100644
--- a/content/actions/how-tos/administer/view-metrics.md
+++ b/content/actions/how-tos/administer/view-metrics.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/administering-github-actions/viewing-github-actions-metrics-for-your-organization
- /actions/administering-github-actions/viewing-github-actions-metrics
- /actions/how-tos/administering-github-actions/viewing-github-actions-metrics
+category:
+ - Administer GitHub Actions
---
## Viewing {% data variables.product.prodname_actions %} metrics for your organization
diff --git a/content/actions/how-tos/create-and-publish-actions/create-a-cli-action.md b/content/actions/how-tos/create-and-publish-actions/create-a-cli-action.md
index 9764ef0e77b6..9a2cbe1c1a03 100644
--- a/content/actions/how-tos/create-and-publish-actions/create-a-cli-action.md
+++ b/content/actions/how-tos/create-and-publish-actions/create-a-cli-action.md
@@ -10,6 +10,8 @@ redirect_from:
versions:
fpt: '*'
ghec: '*'
+category:
+ - Reuse and share automations
---
## Introduction
diff --git a/content/actions/how-tos/create-and-publish-actions/manage-custom-actions.md b/content/actions/how-tos/create-and-publish-actions/manage-custom-actions.md
index 51594200b697..fffa28877ecb 100644
--- a/content/actions/how-tos/create-and-publish-actions/manage-custom-actions.md
+++ b/content/actions/how-tos/create-and-publish-actions/manage-custom-actions.md
@@ -10,6 +10,8 @@ type: overview
redirect_from:
- /actions/how-tos/administering-github-actions/managing-custom-actions
- /actions/how-tos/creating-and-publishing-actions/managing-custom-actions
+category:
+ - Reuse and share automations
---
## Choosing a location for your action
diff --git a/content/actions/how-tos/create-and-publish-actions/publish-in-github-marketplace.md b/content/actions/how-tos/create-and-publish-actions/publish-in-github-marketplace.md
index a6586f86af7f..20534f67d7cf 100644
--- a/content/actions/how-tos/create-and-publish-actions/publish-in-github-marketplace.md
+++ b/content/actions/how-tos/create-and-publish-actions/publish-in-github-marketplace.md
@@ -13,6 +13,8 @@ versions:
fpt: '*'
ghec: '*'
shortTitle: Publish in GitHub Marketplace
+category:
+ - Reuse and share automations
---
## Prerequisites
diff --git a/content/actions/how-tos/create-and-publish-actions/release-and-maintain-actions.md b/content/actions/how-tos/create-and-publish-actions/release-and-maintain-actions.md
index 0e9de1509cca..bb9491f7e601 100644
--- a/content/actions/how-tos/create-and-publish-actions/release-and-maintain-actions.md
+++ b/content/actions/how-tos/create-and-publish-actions/release-and-maintain-actions.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/sharing-automations/creating-actions/releasing-and-maintaining-actions
- /actions/how-tos/sharing-automations/creating-actions/releasing-and-maintaining-actions
- /actions/how-tos/creating-and-publishing-actions/releasing-and-maintaining-actions
+category:
+ - Reuse and share automations
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/create-and-publish-actions/set-exit-codes.md b/content/actions/how-tos/create-and-publish-actions/set-exit-codes.md
index 9c7f4ebc7ce4..882c9486e5b3 100644
--- a/content/actions/how-tos/create-and-publish-actions/set-exit-codes.md
+++ b/content/actions/how-tos/create-and-publish-actions/set-exit-codes.md
@@ -12,6 +12,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Reuse and share automations
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/create-and-publish-actions/using-immutable-releases-and-tags-to-manage-your-actions-releases.md b/content/actions/how-tos/create-and-publish-actions/using-immutable-releases-and-tags-to-manage-your-actions-releases.md
index 9f95414cdc1a..d8ab5d0bfa1f 100644
--- a/content/actions/how-tos/create-and-publish-actions/using-immutable-releases-and-tags-to-manage-your-actions-releases.md
+++ b/content/actions/how-tos/create-and-publish-actions/using-immutable-releases-and-tags-to-manage-your-actions-releases.md
@@ -4,6 +4,8 @@ shortTitle: Use immutable releases
intro: 'Learn how you can use a combination of immutable releases on {% data variables.product.github %} and Git tags to manage your action''s releases.'
versions:
feature: immutable-releases
+category:
+ - Reuse and share automations
---
If you enable immutable releases on your action's repository, you can manage your action's releases as follows:
diff --git a/content/actions/how-tos/deploy/configure-and-manage-deployments/configure-custom-protection-rules.md b/content/actions/how-tos/deploy/configure-and-manage-deployments/configure-custom-protection-rules.md
index 01ea3a559f5b..07ca7fe1bd4b 100644
--- a/content/actions/how-tos/deploy/configure-and-manage-deployments/configure-custom-protection-rules.md
+++ b/content/actions/how-tos/deploy/configure-and-manage-deployments/configure-custom-protection-rules.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/deployment/protecting-deployments/configuring-custom-deployment-protection-rules
- /actions/managing-workflow-runs-and-deployments/managing-deployments/configuring-custom-deployment-protection-rules
- /actions/how-tos/managing-workflow-runs-and-deployments/managing-deployments/configuring-custom-deployment-protection-rules
+category:
+ - Deploy to environments
---
{% data reusables.actions.custom-deployment-protection-rules-beta-note %}
diff --git a/content/actions/how-tos/deploy/configure-and-manage-deployments/control-deployments.md b/content/actions/how-tos/deploy/configure-and-manage-deployments/control-deployments.md
index 664ff0e3f41d..786002457bcc 100644
--- a/content/actions/how-tos/deploy/configure-and-manage-deployments/control-deployments.md
+++ b/content/actions/how-tos/deploy/configure-and-manage-deployments/control-deployments.md
@@ -13,6 +13,8 @@ redirect_from:
- /actions/use-cases-and-examples/deploying/deploying-with-github-actions
- /actions/concepts/use-cases/deploying-with-github-actions
- /actions/tutorials/deploying-with-github-actions
+category:
+ - Deploy to environments
---
## Prerequisites
diff --git a/content/actions/how-tos/deploy/configure-and-manage-deployments/create-custom-protection-rules.md b/content/actions/how-tos/deploy/configure-and-manage-deployments/create-custom-protection-rules.md
index 38f309a53b2a..37225acbd187 100644
--- a/content/actions/how-tos/deploy/configure-and-manage-deployments/create-custom-protection-rules.md
+++ b/content/actions/how-tos/deploy/configure-and-manage-deployments/create-custom-protection-rules.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/deployment/protecting-deployments/creating-custom-deployment-protection-rules
- /actions/managing-workflow-runs-and-deployments/managing-deployments/creating-custom-deployment-protection-rules
- /actions/how-tos/managing-workflow-runs-and-deployments/managing-deployments/creating-custom-deployment-protection-rules
+category:
+ - Deploy to environments
---
## Prerequisites
diff --git a/content/actions/how-tos/deploy/configure-and-manage-deployments/manage-environments.md b/content/actions/how-tos/deploy/configure-and-manage-deployments/manage-environments.md
index 5e1dfc1d8b56..8c89ed5bbd53 100644
--- a/content/actions/how-tos/deploy/configure-and-manage-deployments/manage-environments.md
+++ b/content/actions/how-tos/deploy/configure-and-manage-deployments/manage-environments.md
@@ -19,6 +19,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Deploy to environments
---
## Prerequisites
diff --git a/content/actions/how-tos/deploy/configure-and-manage-deployments/review-deployments.md b/content/actions/how-tos/deploy/configure-and-manage-deployments/review-deployments.md
index eb8bb534d717..57212581f96c 100644
--- a/content/actions/how-tos/deploy/configure-and-manage-deployments/review-deployments.md
+++ b/content/actions/how-tos/deploy/configure-and-manage-deployments/review-deployments.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/managing-workflow-runs/reviewing-deployments
- /actions/managing-workflow-runs-and-deployments/managing-deployments/reviewing-deployments
- /actions/how-tos/managing-workflow-runs-and-deployments/managing-deployments/reviewing-deployments
+category:
+ - Deploy to environments
---
## Approving or rejecting a job
diff --git a/content/actions/how-tos/deploy/configure-and-manage-deployments/view-deployment-history.md b/content/actions/how-tos/deploy/configure-and-manage-deployments/view-deployment-history.md
index 32c19b9e340d..f511161416f6 100644
--- a/content/actions/how-tos/deploy/configure-and-manage-deployments/view-deployment-history.md
+++ b/content/actions/how-tos/deploy/configure-and-manage-deployments/view-deployment-history.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/deployment/managing-your-deployments/viewing-deployment-history
- /actions/managing-workflow-runs-and-deployments/managing-deployments/viewing-deployment-history
- /actions/how-tos/managing-workflow-runs-and-deployments/managing-deployments/viewing-deployment-history
+category:
+ - Deploy to environments
---
## Viewing your repository's deployment history
diff --git a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/amazon-elastic-container-service.md b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/amazon-elastic-container-service.md
index 2e65bd1a3482..bc042b052600 100644
--- a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/amazon-elastic-container-service.md
+++ b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/amazon-elastic-container-service.md
@@ -13,6 +13,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Deploy to environments
---
## Prerequisites
diff --git a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/azure-kubernetes-service.md b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/azure-kubernetes-service.md
index 928eac7a7b75..b9847788bb33 100644
--- a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/azure-kubernetes-service.md
+++ b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/azure-kubernetes-service.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/use-cases-and-examples/deploying/deploying-to-azure-kubernetes-service
- /actions/how-tos/use-cases-and-examples/deploying/deploying-to-azure-kubernetes-service
- /actions/how-tos/managing-workflow-runs-and-deployments/deploying-to-third-party-platforms/deploying-to-azure-kubernetes-service
+category:
+ - Deploy to environments
---
## Prerequisites
diff --git a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/azure-static-web-app.md b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/azure-static-web-app.md
index a4eedf61ea70..518b9b15a023 100644
--- a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/azure-static-web-app.md
+++ b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/azure-static-web-app.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/use-cases-and-examples/deploying/deploying-to-azure-static-web-app
- /actions/how-tos/use-cases-and-examples/deploying/deploying-to-azure-static-web-app
- /actions/how-tos/managing-workflow-runs-and-deployments/deploying-to-third-party-platforms/deploying-to-azure-static-web-app
+category:
+ - Deploy to environments
---
## Prerequisites
diff --git a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/docker-to-azure-app-service.md b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/docker-to-azure-app-service.md
index cb4bf007bf27..b30b2b44589b 100644
--- a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/docker-to-azure-app-service.md
+++ b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/docker-to-azure-app-service.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/use-cases-and-examples/deploying/deploying-docker-to-azure-app-service
- /actions/how-tos/use-cases-and-examples/deploying/deploying-docker-to-azure-app-service
- /actions/how-tos/managing-workflow-runs-and-deployments/deploying-to-third-party-platforms/deploying-docker-to-azure-app-service
+category:
+ - Deploy to environments
---
## Prerequisites
diff --git a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/google-kubernetes-engine.md b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/google-kubernetes-engine.md
index 81fcabc3cd50..85b3b6b4c966 100644
--- a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/google-kubernetes-engine.md
+++ b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/google-kubernetes-engine.md
@@ -14,6 +14,8 @@ versions:
ghes: '*'
ghec: '*'
type: tutorial
+category:
+ - Deploy to environments
---
## Prerequisites
diff --git a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/java-to-azure-app-service.md b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/java-to-azure-app-service.md
index 8bc11f07572b..46f164a43cd3 100644
--- a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/java-to-azure-app-service.md
+++ b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/java-to-azure-app-service.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/use-cases-and-examples/deploying/deploying-java-to-azure-app-service
- /actions/how-tos/use-cases-and-examples/deploying/deploying-java-to-azure-app-service
- /actions/how-tos/managing-workflow-runs-and-deployments/deploying-to-third-party-platforms/deploying-java-to-azure-app-service
+category:
+ - Deploy to environments
---
## Prerequisites
diff --git a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/net-to-azure-app-service.md b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/net-to-azure-app-service.md
index f340f51c76c6..e66181f85395 100644
--- a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/net-to-azure-app-service.md
+++ b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/net-to-azure-app-service.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/use-cases-and-examples/deploying/deploying-net-to-azure-app-service
- /actions/how-tos/use-cases-and-examples/deploying/deploying-net-to-azure-app-service
- /actions/how-tos/managing-workflow-runs-and-deployments/deploying-to-third-party-platforms/deploying-net-to-azure-app-service
+category:
+ - Deploy to environments
---
## Prerequisites
diff --git a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/nodejs-to-azure-app-service.md b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/nodejs-to-azure-app-service.md
index afbd16797340..deaa277575d8 100644
--- a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/nodejs-to-azure-app-service.md
+++ b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/nodejs-to-azure-app-service.md
@@ -14,6 +14,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Deploy to environments
---
## Prerequisites
diff --git a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/php-to-azure-app-service.md b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/php-to-azure-app-service.md
index 73206236d8da..9a23ff237f2e 100644
--- a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/php-to-azure-app-service.md
+++ b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/php-to-azure-app-service.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/use-cases-and-examples/deploying/deploying-php-to-azure-app-service
- /actions/how-tos/use-cases-and-examples/deploying/deploying-php-to-azure-app-service
- /actions/how-tos/managing-workflow-runs-and-deployments/deploying-to-third-party-platforms/deploying-php-to-azure-app-service
+category:
+ - Deploy to environments
---
## Prerequisites
diff --git a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/python-to-azure-app-service.md b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/python-to-azure-app-service.md
index 9f9f4aa83351..67ecbf96a490 100644
--- a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/python-to-azure-app-service.md
+++ b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/python-to-azure-app-service.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/use-cases-and-examples/deploying/deploying-python-to-azure-app-service
- /actions/how-tos/use-cases-and-examples/deploying/deploying-python-to-azure-app-service
- /actions/how-tos/managing-workflow-runs-and-deployments/deploying-to-third-party-platforms/deploying-python-to-azure-app-service
+category:
+ - Deploy to environments
---
## Prerequisites
diff --git a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/sign-xcode-applications.md b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/sign-xcode-applications.md
index 6878aa4b8c39..395d756ccb89 100644
--- a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/sign-xcode-applications.md
+++ b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/sign-xcode-applications.md
@@ -14,6 +14,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Deploy to environments
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/get-support.md b/content/actions/how-tos/get-support.md
index 9a951b1fb3e3..bc67e5dd776c 100644
--- a/content/actions/how-tos/get-support.md
+++ b/content/actions/how-tos/get-support.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/monitoring-and-troubleshooting-workflows/troubleshooting-workflows/working-with-support-for-github-actions
- /actions/how-tos/monitoring-and-troubleshooting-workflows/troubleshooting-workflows/working-with-support-for-github-actions
- /actions/how-tos/getting-help-from-github-support-about-github-actions
+category:
+ - Administer GitHub Actions
---
You can [contact {% data variables.contact.github_support %}](/support/contacting-github-support) for assistance with {% data variables.product.prodname_actions %}.
diff --git a/content/actions/how-tos/manage-runners/github-hosted-runners/connect-to-a-private-network/connect-with-oidc.md b/content/actions/how-tos/manage-runners/github-hosted-runners/connect-to-a-private-network/connect-with-oidc.md
index fddbb14cf6e8..29b9dcaa8b52 100644
--- a/content/actions/how-tos/manage-runners/github-hosted-runners/connect-to-a-private-network/connect-with-oidc.md
+++ b/content/actions/how-tos/manage-runners/github-hosted-runners/connect-to-a-private-network/connect-with-oidc.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/using-github-hosted-runners/using-github-hosted-runners/using-an-api-gateway-with-oidc
- /actions/using-github-hosted-runners/connecting-to-a-private-network/using-an-api-gateway-with-oidc
- /actions/how-tos/using-github-hosted-runners/connecting-to-a-private-network/using-an-api-gateway-with-oidc
+category:
+ - Use and manage runners
---
## Using an API gateway with OIDC
diff --git a/content/actions/how-tos/manage-runners/github-hosted-runners/connect-to-a-private-network/connect-with-wireguard.md b/content/actions/how-tos/manage-runners/github-hosted-runners/connect-to-a-private-network/connect-with-wireguard.md
index d56068fbfdfc..c7bb1910e9a9 100644
--- a/content/actions/how-tos/manage-runners/github-hosted-runners/connect-to-a-private-network/connect-with-wireguard.md
+++ b/content/actions/how-tos/manage-runners/github-hosted-runners/connect-to-a-private-network/connect-with-wireguard.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/using-github-hosted-runners/using-github-hosted-runners/using-wireguard-to-create-a-network-overlay
- /actions/using-github-hosted-runners/connecting-to-a-private-network/using-wireguard-to-create-a-network-overlay
- /actions/how-tos/using-github-hosted-runners/connecting-to-a-private-network/using-wireguard-to-create-a-network-overlay
+category:
+ - Use and manage runners
---
## Using WireGuard to create a network overlay
diff --git a/content/actions/how-tos/manage-runners/github-hosted-runners/customize-runners.md b/content/actions/how-tos/manage-runners/github-hosted-runners/customize-runners.md
index 4c570e7dd63d..c27249bd3bc3 100644
--- a/content/actions/how-tos/manage-runners/github-hosted-runners/customize-runners.md
+++ b/content/actions/how-tos/manage-runners/github-hosted-runners/customize-runners.md
@@ -13,6 +13,8 @@ redirect_from:
- /actions/using-github-hosted-runners/using-github-hosted-runners/customizing-github-hosted-runners
- /actions/how-tos/using-github-hosted-runners/using-github-hosted-runners/customizing-github-hosted-runners
- /actions/how-tos/using-github-hosted-runners/customizing-github-hosted-runners
+category:
+ - Set up runners
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/manage-runners/github-hosted-runners/use-github-hosted-runners.md b/content/actions/how-tos/manage-runners/github-hosted-runners/use-github-hosted-runners.md
index aecaa7f6ebdc..0e23d578de1c 100644
--- a/content/actions/how-tos/manage-runners/github-hosted-runners/use-github-hosted-runners.md
+++ b/content/actions/how-tos/manage-runners/github-hosted-runners/use-github-hosted-runners.md
@@ -9,6 +9,8 @@ versions:
redirect_from:
- /actions/how-tos/using-github-hosted-runners/using-github-hosted-runners
- /actions/using-github-hosted-runners/using-github-hosted-runners
+category:
+ - Use and manage runners
---
{% ifversion ghes %}
diff --git a/content/actions/how-tos/manage-runners/github-hosted-runners/view-current-jobs.md b/content/actions/how-tos/manage-runners/github-hosted-runners/view-current-jobs.md
index 4e3541fa0e35..3c106380fa7d 100644
--- a/content/actions/how-tos/manage-runners/github-hosted-runners/view-current-jobs.md
+++ b/content/actions/how-tos/manage-runners/github-hosted-runners/view-current-jobs.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/how-tos/using-github-hosted-runners/monitoring-your-current-jobs#viewing-active-jobs-in-your-organization-or-enterprise
- /actions/how-tos/using-github-hosted-runners/monitoring-your-current-jobs
- /actions/how-tos/using-github-hosted-runners/viewing-your-current-jobs
+category:
+ - Use and manage runners
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/manage-runners/larger-runners/control-access.md b/content/actions/how-tos/manage-runners/larger-runners/control-access.md
index e61536163238..b5ebb2948d3b 100644
--- a/content/actions/how-tos/manage-runners/larger-runners/control-access.md
+++ b/content/actions/how-tos/manage-runners/larger-runners/control-access.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/using-github-hosted-runners/using-larger-runners/controlling-access-to-larger-runners
- /actions/how-tos/using-github-hosted-runners/using-larger-runners/controlling-access-to-larger-runners
- /actions/how-tos/using-larger-runners/controlling-access-to-larger-runners
+category:
+ - Use and manage runners
---
> [!NOTE]
diff --git a/content/actions/how-tos/manage-runners/larger-runners/manage-larger-runners.md b/content/actions/how-tos/manage-runners/larger-runners/manage-larger-runners.md
index cb6609ae0af5..516d028e0de2 100644
--- a/content/actions/how-tos/manage-runners/larger-runners/manage-larger-runners.md
+++ b/content/actions/how-tos/manage-runners/larger-runners/manage-larger-runners.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/using-github-hosted-runners/using-larger-runners/managing-larger-runners
- /actions/how-tos/using-github-hosted-runners/using-larger-runners/managing-larger-runners
- /actions/how-tos/using-larger-runners/managing-larger-runners
+category:
+ - Set up runners
---
> [!NOTE]
diff --git a/content/actions/how-tos/manage-runners/larger-runners/use-custom-images.md b/content/actions/how-tos/manage-runners/larger-runners/use-custom-images.md
index 82544a91631b..562cb91fdebb 100644
--- a/content/actions/how-tos/manage-runners/larger-runners/use-custom-images.md
+++ b/content/actions/how-tos/manage-runners/larger-runners/use-custom-images.md
@@ -6,6 +6,8 @@ versions:
feature: actions-hosted-runners
product: '{% data variables.actions.github_hosted_larger_runners %} are only available for organizations and enterprises using the {% data variables.product.prodname_team %} or {% data variables.product.prodname_ghe_cloud %} plans. Sign up for {% data variables.product.prodname_actions %} {% octicon "link-external" height:16 %}'
+category:
+ - Set up runners
---
{% data reusables.actions.custom-images-public-preview-note %}
diff --git a/content/actions/how-tos/manage-runners/larger-runners/use-larger-runners.md b/content/actions/how-tos/manage-runners/larger-runners/use-larger-runners.md
index 5ac2bc8b4d28..92f0fbd93afa 100644
--- a/content/actions/how-tos/manage-runners/larger-runners/use-larger-runners.md
+++ b/content/actions/how-tos/manage-runners/larger-runners/use-larger-runners.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/using-github-hosted-runners/using-larger-runners/running-jobs-on-larger-runners
- /actions/how-tos/using-github-hosted-runners/using-larger-runners/running-jobs-on-larger-runners
- /actions/how-tos/using-larger-runners/running-jobs-on-larger-runners
+category:
+ - Use and manage runners
---
## Running jobs on your runner
diff --git a/content/actions/how-tos/manage-runners/self-hosted-runners/add-runners.md b/content/actions/how-tos/manage-runners/self-hosted-runners/add-runners.md
index 461f42246697..101350a2922d 100644
--- a/content/actions/how-tos/manage-runners/self-hosted-runners/add-runners.md
+++ b/content/actions/how-tos/manage-runners/self-hosted-runners/add-runners.md
@@ -13,6 +13,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Set up runners
---
> [!WARNING]
diff --git a/content/actions/how-tos/manage-runners/self-hosted-runners/apply-labels.md b/content/actions/how-tos/manage-runners/self-hosted-runners/apply-labels.md
index a6f9c89d397a..937423d2666d 100644
--- a/content/actions/how-tos/manage-runners/self-hosted-runners/apply-labels.md
+++ b/content/actions/how-tos/manage-runners/self-hosted-runners/apply-labels.md
@@ -11,6 +11,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Use and manage runners
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/manage-runners/self-hosted-runners/configure-the-application.md b/content/actions/how-tos/manage-runners/self-hosted-runners/configure-the-application.md
index 6acc98bd57f1..7766749f54d5 100644
--- a/content/actions/how-tos/manage-runners/self-hosted-runners/configure-the-application.md
+++ b/content/actions/how-tos/manage-runners/self-hosted-runners/configure-the-application.md
@@ -13,6 +13,8 @@ versions:
ghes: '*'
ghec: '*'
defaultPlatform: linux
+category:
+ - Set up runners
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/manage-runners/self-hosted-runners/customize-containers.md b/content/actions/how-tos/manage-runners/self-hosted-runners/customize-containers.md
index 547d147c8a53..eec0e0308213 100644
--- a/content/actions/how-tos/manage-runners/self-hosted-runners/customize-containers.md
+++ b/content/actions/how-tos/manage-runners/self-hosted-runners/customize-containers.md
@@ -9,6 +9,8 @@ redirect_from:
- /actions/how-tos/managing-self-hosted-runners/customizing-the-containers-used-by-jobs
versions:
feature: container-hooks
+category:
+ - Use and manage runners
---
> [!NOTE]
diff --git a/content/actions/how-tos/manage-runners/self-hosted-runners/manage-access.md b/content/actions/how-tos/manage-runners/self-hosted-runners/manage-access.md
index 896495016f0d..c896dd07c7b6 100644
--- a/content/actions/how-tos/manage-runners/self-hosted-runners/manage-access.md
+++ b/content/actions/how-tos/manage-runners/self-hosted-runners/manage-access.md
@@ -14,6 +14,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Use and manage runners
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/manage-runners/self-hosted-runners/monitor-and-troubleshoot.md b/content/actions/how-tos/manage-runners/self-hosted-runners/monitor-and-troubleshoot.md
index e7daec591b46..8f57d570e066 100644
--- a/content/actions/how-tos/manage-runners/self-hosted-runners/monitor-and-troubleshoot.md
+++ b/content/actions/how-tos/manage-runners/self-hosted-runners/monitor-and-troubleshoot.md
@@ -15,6 +15,8 @@ versions:
ghes: '*'
ghec: '*'
defaultPlatform: linux
+category:
+ - Use and manage runners
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/manage-runners/self-hosted-runners/remove-runners.md b/content/actions/how-tos/manage-runners/self-hosted-runners/remove-runners.md
index 15cfecfeca62..f95ff5190e31 100644
--- a/content/actions/how-tos/manage-runners/self-hosted-runners/remove-runners.md
+++ b/content/actions/how-tos/manage-runners/self-hosted-runners/remove-runners.md
@@ -13,6 +13,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Use and manage runners
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/manage-runners/self-hosted-runners/run-scripts.md b/content/actions/how-tos/manage-runners/self-hosted-runners/run-scripts.md
index 8493dbbd66b6..04df2c9ccb48 100644
--- a/content/actions/how-tos/manage-runners/self-hosted-runners/run-scripts.md
+++ b/content/actions/how-tos/manage-runners/self-hosted-runners/run-scripts.md
@@ -11,6 +11,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Use and manage runners
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/manage-runners/self-hosted-runners/use-in-a-workflow.md b/content/actions/how-tos/manage-runners/self-hosted-runners/use-in-a-workflow.md
index 0c482c92c609..7579955d9a9f 100644
--- a/content/actions/how-tos/manage-runners/self-hosted-runners/use-in-a-workflow.md
+++ b/content/actions/how-tos/manage-runners/self-hosted-runners/use-in-a-workflow.md
@@ -13,6 +13,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Use and manage runners
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/manage-runners/use-proxy-servers.md b/content/actions/how-tos/manage-runners/use-proxy-servers.md
index 7da3b7ee57f4..ee960f660c69 100644
--- a/content/actions/how-tos/manage-runners/use-proxy-servers.md
+++ b/content/actions/how-tos/manage-runners/use-proxy-servers.md
@@ -14,6 +14,8 @@ versions:
ghes: '*'
ghec: '*'
contentType: how-tos
+category:
+ - Set up runners
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/manage-workflow-runs/approve-runs-from-forks.md b/content/actions/how-tos/manage-workflow-runs/approve-runs-from-forks.md
index 6d93ce7cf4a0..a2088fa0e7e0 100644
--- a/content/actions/how-tos/manage-workflow-runs/approve-runs-from-forks.md
+++ b/content/actions/how-tos/manage-workflow-runs/approve-runs-from-forks.md
@@ -14,6 +14,8 @@ redirect_from:
- /actions/how-tos/managing-workflow-runs-and-deployments/managing-workflow-runs/approving-workflow-runs-from-forks
- /actions/managing-workflow-runs/approving-workflow-runs-from-private-forks
- /actions/managing-workflow-runs-and-deployments/managing-workflow-runs/approving-workflow-runs-from-private-forks
+category:
+ - Manage and monitor workflow runs
---
Workflow runs triggered by a contributor's pull request from a fork may require manual approval from a maintainer with write access. You can configure workflow approval requirements for a [repository](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-required-approval-for-workflows-from-public-forks), [organization](/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization#configuring-required-approval-for-workflows-from-public-forks), or [enterprise](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#enforcing-a-policy-for-fork-pull-requests-in-your-enterprise).
diff --git a/content/actions/how-tos/manage-workflow-runs/cancel-a-workflow-run.md b/content/actions/how-tos/manage-workflow-runs/cancel-a-workflow-run.md
index a22caa621776..7c8869f18cc5 100644
--- a/content/actions/how-tos/manage-workflow-runs/cancel-a-workflow-run.md
+++ b/content/actions/how-tos/manage-workflow-runs/cancel-a-workflow-run.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/managing-workflow-runs/canceling-a-workflow
- /actions/managing-workflow-runs-and-deployments/managing-workflow-runs/canceling-a-workflow
- /actions/how-tos/managing-workflow-runs-and-deployments/managing-workflow-runs/canceling-a-workflow
+category:
+ - Manage and monitor workflow runs
---
## Canceling a workflow run
diff --git a/content/actions/how-tos/manage-workflow-runs/delete-a-workflow-run.md b/content/actions/how-tos/manage-workflow-runs/delete-a-workflow-run.md
index 3fb4da23b2a3..9477a49deae1 100644
--- a/content/actions/how-tos/manage-workflow-runs/delete-a-workflow-run.md
+++ b/content/actions/how-tos/manage-workflow-runs/delete-a-workflow-run.md
@@ -10,6 +10,8 @@ redirect_from:
- /actions/managing-workflow-runs/deleting-a-workflow-run
- /actions/managing-workflow-runs-and-deployments/managing-workflow-runs/deleting-a-workflow-run
- /actions/how-tos/managing-workflow-runs-and-deployments/managing-workflow-runs/deleting-a-workflow-run
+category:
+ - Manage and monitor workflow runs
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/manage-workflow-runs/disable-and-enable-workflows.md b/content/actions/how-tos/manage-workflow-runs/disable-and-enable-workflows.md
index d5eb60f6c05b..6ee29713bfb6 100644
--- a/content/actions/how-tos/manage-workflow-runs/disable-and-enable-workflows.md
+++ b/content/actions/how-tos/manage-workflow-runs/disable-and-enable-workflows.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/using-workflows/disabling-and-enabling-a-workflow
- /actions/managing-workflow-runs-and-deployments/managing-workflow-runs/disabling-and-enabling-a-workflow
- /actions/how-tos/managing-workflow-runs-and-deployments/managing-workflow-runs/disabling-and-enabling-a-workflow
+category:
+ - Manage and monitor workflow runs
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/manage-workflow-runs/download-workflow-artifacts.md b/content/actions/how-tos/manage-workflow-runs/download-workflow-artifacts.md
index c6910513c61b..58827d4dab41 100644
--- a/content/actions/how-tos/manage-workflow-runs/download-workflow-artifacts.md
+++ b/content/actions/how-tos/manage-workflow-runs/download-workflow-artifacts.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/managing-workflow-runs-and-deployments/managing-workflow-runs/downloading-workflow-artifacts
- /actions/how-tos/managing-workflow-runs-and-deployments/managing-workflow-runs/downloading-workflow-artifacts
- /actions/how-tos/manage-workflow-runs/downloading-workflow-artifacts
+category:
+ - Manage and monitor workflow runs
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/manage-workflow-runs/manage-caches.md b/content/actions/how-tos/manage-workflow-runs/manage-caches.md
index 1fcdfa9577e1..d68843a7bb19 100644
--- a/content/actions/how-tos/manage-workflow-runs/manage-caches.md
+++ b/content/actions/how-tos/manage-workflow-runs/manage-caches.md
@@ -9,6 +9,8 @@ shortTitle: Manage caches
allowTitleToDifferFromFilename: true
redirect_from:
- /actions/how-tos/managing-workflow-runs-and-deployments/managing-workflow-runs/manage-caches
+category:
+ - Manage and monitor workflow runs
---
This article describes managing caches with the {% data variables.product.prodname_dotcom %} web interface, but you can also manage them:
diff --git a/content/actions/how-tos/manage-workflow-runs/manually-run-a-workflow.md b/content/actions/how-tos/manage-workflow-runs/manually-run-a-workflow.md
index ef0dc91a3f84..d70a51be9e3e 100644
--- a/content/actions/how-tos/manage-workflow-runs/manually-run-a-workflow.md
+++ b/content/actions/how-tos/manage-workflow-runs/manually-run-a-workflow.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/managing-workflow-runs-and-deployments/managing-workflow-runs/manually-running-a-workflow
- /articles/configuring-a-workflow
- /actions/how-tos/managing-workflow-runs-and-deployments/managing-workflow-runs/manually-running-a-workflow
+category:
+ - Manage and monitor workflow runs
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/manage-workflow-runs/re-run-workflows-and-jobs.md b/content/actions/how-tos/manage-workflow-runs/re-run-workflows-and-jobs.md
index 1a4d8f3c96b2..f905381d0a72 100644
--- a/content/actions/how-tos/manage-workflow-runs/re-run-workflows-and-jobs.md
+++ b/content/actions/how-tos/manage-workflow-runs/re-run-workflows-and-jobs.md
@@ -12,6 +12,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Manage and monitor workflow runs
---
> [!NOTE]
diff --git a/content/actions/how-tos/manage-workflow-runs/remove-workflow-artifacts.md b/content/actions/how-tos/manage-workflow-runs/remove-workflow-artifacts.md
index aa445df87ed0..63d4268c34b4 100644
--- a/content/actions/how-tos/manage-workflow-runs/remove-workflow-artifacts.md
+++ b/content/actions/how-tos/manage-workflow-runs/remove-workflow-artifacts.md
@@ -10,6 +10,8 @@ redirect_from:
- /actions/managing-workflow-runs/removing-workflow-artifacts
- /actions/managing-workflow-runs-and-deployments/managing-workflow-runs/removing-workflow-artifacts
- /actions/how-tos/managing-workflow-runs-and-deployments/managing-workflow-runs/removing-workflow-artifacts
+category:
+ - Manage and monitor workflow runs
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/manage-workflow-runs/skip-workflow-runs.md b/content/actions/how-tos/manage-workflow-runs/skip-workflow-runs.md
index 759d8ef7ad28..081f74cf28fa 100644
--- a/content/actions/how-tos/manage-workflow-runs/skip-workflow-runs.md
+++ b/content/actions/how-tos/manage-workflow-runs/skip-workflow-runs.md
@@ -10,6 +10,8 @@ redirect_from:
- /actions/managing-workflow-runs/skipping-workflow-runs
- /actions/managing-workflow-runs-and-deployments/managing-workflow-runs/skipping-workflow-runs
- /actions/how-tos/managing-workflow-runs-and-deployments/managing-workflow-runs/skipping-workflow-runs
+category:
+ - Manage and monitor workflow runs
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/monitor-workflows/add-a-status-badge.md b/content/actions/how-tos/monitor-workflows/add-a-status-badge.md
index c523513100d5..a90c10ee4066 100644
--- a/content/actions/how-tos/monitor-workflows/add-a-status-badge.md
+++ b/content/actions/how-tos/monitor-workflows/add-a-status-badge.md
@@ -12,6 +12,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Manage and monitor workflow runs
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/monitor-workflows/enable-debug-logging.md b/content/actions/how-tos/monitor-workflows/enable-debug-logging.md
index 2cc65a5679fa..4eed2068c444 100644
--- a/content/actions/how-tos/monitor-workflows/enable-debug-logging.md
+++ b/content/actions/how-tos/monitor-workflows/enable-debug-logging.md
@@ -12,6 +12,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Manage and monitor workflow runs
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/monitor-workflows/use-the-visualization-graph.md b/content/actions/how-tos/monitor-workflows/use-the-visualization-graph.md
index 3295ddbf9641..17d1452fe887 100644
--- a/content/actions/how-tos/monitor-workflows/use-the-visualization-graph.md
+++ b/content/actions/how-tos/monitor-workflows/use-the-visualization-graph.md
@@ -12,6 +12,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Manage and monitor workflow runs
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/monitor-workflows/use-workflow-run-logs.md b/content/actions/how-tos/monitor-workflows/use-workflow-run-logs.md
index 283835ba36c2..bfcf8ca2b3c9 100644
--- a/content/actions/how-tos/monitor-workflows/use-workflow-run-logs.md
+++ b/content/actions/how-tos/monitor-workflows/use-workflow-run-logs.md
@@ -12,6 +12,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Manage and monitor workflow runs
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/monitor-workflows/view-job-condition-logs.md b/content/actions/how-tos/monitor-workflows/view-job-condition-logs.md
index 10ffe79d9bfa..e76fd9207360 100644
--- a/content/actions/how-tos/monitor-workflows/view-job-condition-logs.md
+++ b/content/actions/how-tos/monitor-workflows/view-job-condition-logs.md
@@ -6,6 +6,8 @@ versions:
fpt: '*'
ghec: '*'
contentType: how-tos
+category:
+ - Manage and monitor workflow runs
---
When a job's `if` condition is evaluated, {% data variables.product.prodname_actions %} logs the expression evaluation to help you understand the result. This is useful for debugging both why a job was skipped and why a job ran when you expected it to be skipped.
diff --git a/content/actions/how-tos/monitor-workflows/view-job-execution-time.md b/content/actions/how-tos/monitor-workflows/view-job-execution-time.md
index b4c8267becf3..f34eb1a369a2 100644
--- a/content/actions/how-tos/monitor-workflows/view-job-execution-time.md
+++ b/content/actions/how-tos/monitor-workflows/view-job-execution-time.md
@@ -11,6 +11,8 @@ redirect_from:
versions:
fpt: '*'
ghec: '*'
+category:
+ - Manage and monitor workflow runs
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/monitor-workflows/view-workflow-run-history.md b/content/actions/how-tos/monitor-workflows/view-workflow-run-history.md
index a03130102e61..8f2b7005b675 100644
--- a/content/actions/how-tos/monitor-workflows/view-workflow-run-history.md
+++ b/content/actions/how-tos/monitor-workflows/view-workflow-run-history.md
@@ -12,6 +12,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Manage and monitor workflow runs
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/reuse-automations/create-workflow-templates.md b/content/actions/how-tos/reuse-automations/create-workflow-templates.md
index 87dbf462f4ab..831f29a399bd 100644
--- a/content/actions/how-tos/reuse-automations/create-workflow-templates.md
+++ b/content/actions/how-tos/reuse-automations/create-workflow-templates.md
@@ -14,6 +14,8 @@ versions:
ghes: '*'
ghec: '*'
type: tutorial
+category:
+ - Reuse and share automations
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/reuse-automations/reuse-workflows.md b/content/actions/how-tos/reuse-automations/reuse-workflows.md
index 5bee09030726..0332fc2dd8f3 100644
--- a/content/actions/how-tos/reuse-automations/reuse-workflows.md
+++ b/content/actions/how-tos/reuse-automations/reuse-workflows.md
@@ -11,6 +11,8 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
+category:
+ - Reuse and share automations
---
## Creating a reusable workflow
diff --git a/content/actions/how-tos/reuse-automations/share-across-private-repositories.md b/content/actions/how-tos/reuse-automations/share-across-private-repositories.md
index fa45ed0127a7..5706ec85c850 100644
--- a/content/actions/how-tos/reuse-automations/share-across-private-repositories.md
+++ b/content/actions/how-tos/reuse-automations/share-across-private-repositories.md
@@ -8,6 +8,8 @@ redirect_from:
- /actions/creating-actions/sharing-actions-and-workflows-from-your-private-repository
- /actions/sharing-automations/sharing-actions-and-workflows-from-your-private-repository
- /actions/how-tos/sharing-automations/sharing-actions-and-workflows-from-your-private-repository
+category:
+ - Reuse and share automations
---
> [!WARNING]
diff --git a/content/actions/how-tos/reuse-automations/share-with-your-enterprise.md b/content/actions/how-tos/reuse-automations/share-with-your-enterprise.md
index 35a17ae57d2f..5fb04cb5e474 100644
--- a/content/actions/how-tos/reuse-automations/share-with-your-enterprise.md
+++ b/content/actions/how-tos/reuse-automations/share-with-your-enterprise.md
@@ -10,6 +10,8 @@ redirect_from:
- /actions/creating-actions/sharing-actions-and-workflows-with-your-enterprise
- /actions/sharing-automations/sharing-actions-and-workflows-with-your-enterprise
- /actions/how-tos/sharing-automations/sharing-actions-and-workflows-with-your-enterprise
+category:
+ - Reuse and share automations
---
## Overview
diff --git a/content/actions/how-tos/reuse-automations/share-with-your-organization.md b/content/actions/how-tos/reuse-automations/share-with-your-organization.md
index 772488ec3092..e55b90e4181e 100644
--- a/content/actions/how-tos/reuse-automations/share-with-your-organization.md
+++ b/content/actions/how-tos/reuse-automations/share-with-your-organization.md
@@ -9,6 +9,8 @@ redirect_from:
- /actions/sharing-automations/sharing-actions-and-workflows-with-your-organization
- /actions/how-tos/sharing-automations/sharing-actions-and-workflows-with-your-organization
- /actions/administering-github-actions/sharing-workflows-secrets-and-runners-with-your-organization
+category:
+ - Reuse and share automations
---
> [!WARNING]
diff --git a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-aws.md b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-aws.md
index 6b132b935fb9..21af14db1c10 100644
--- a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-aws.md
+++ b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-aws.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/deployment/security-hardening-your-deployments/configuring-openid-connect-in-amazon-web-services
- /actions/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-amazon-web-services
- /actions/how-tos/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-amazon-web-services
+category:
+ - Secure your workflows
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-azure.md b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-azure.md
index 772d3ec0252d..076f8364e54f 100644
--- a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-azure.md
+++ b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-azure.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/security-for-github-actions/security-guides/security-hardening-your-deployments/configuring-openid-connect-in-azure
- /actions/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-azure
- /actions/how-tos/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-azure
+category:
+ - Secure your workflows
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-cloud-providers.md b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-cloud-providers.md
index 5071f6a8db96..04a3836cd282 100644
--- a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-cloud-providers.md
+++ b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-cloud-providers.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/deployment/security-hardening-your-deployments/configuring-openid-connect-in-cloud-providers
- /actions/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-cloud-providers
- /actions/how-tos/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-cloud-providers
+category:
+ - Secure your workflows
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-google-cloud-platform.md b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-google-cloud-platform.md
index edfe63da2d1b..3b108b86f96a 100644
--- a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-google-cloud-platform.md
+++ b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-google-cloud-platform.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/deployment/security-hardening-your-deployments/configuring-openid-connect-in-google-cloud-platform
- /actions/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-google-cloud-platform
- /actions/how-tos/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-google-cloud-platform
+category:
+ - Secure your workflows
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-hashicorp-vault.md b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-hashicorp-vault.md
index bafd5f633504..4a047ffadcaf 100644
--- a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-hashicorp-vault.md
+++ b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-hashicorp-vault.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/deployment/security-hardening-your-deployments/configuring-openid-connect-in-hashicorp-vault
- /actions/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-hashicorp-vault
- /actions/how-tos/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-hashicorp-vault
+category:
+ - Secure your workflows
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-jfrog.md b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-jfrog.md
index 0006c372149b..4e3b414e8812 100644
--- a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-jfrog.md
+++ b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-jfrog.md
@@ -10,6 +10,8 @@ redirect_from:
- /actions/deployment/security-hardening-your-deployments/configuring-openid-connect-in-jfrog
- /actions/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-jfrog
- /actions/how-tos/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-jfrog
+category:
+ - Secure your workflows
---
## Overview
diff --git a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-octopus-deploy.md b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-octopus-deploy.md
index 60a7b229830d..fddda94aedc4 100644
--- a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-octopus-deploy.md
+++ b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-octopus-deploy.md
@@ -6,6 +6,8 @@ versions:
fpt: '*'
ghec: '*'
type: tutorial
+category:
+ - Secure your workflows
---
## Overview
diff --git a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-pypi.md b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-pypi.md
index 62c23a84ffcf..64fdd1efa0a4 100644
--- a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-pypi.md
+++ b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-pypi.md
@@ -10,6 +10,8 @@ redirect_from:
- /actions/deployment/security-hardening-your-deployments/configuring-openid-connect-in-pypi
- /actions/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-pypi
- /actions/how-tos/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-pypi
+category:
+ - Secure your workflows
---
## Overview
diff --git a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-with-reusable-workflows.md b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-with-reusable-workflows.md
index 2632be9a7fa7..ecfbf10a3488 100644
--- a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-with-reusable-workflows.md
+++ b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-with-reusable-workflows.md
@@ -12,6 +12,8 @@ versions:
ghec: '*'
ghes: '*'
type: how_to
+category:
+ - Secure your workflows
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/secure-your-work/use-artifact-attestations/enforce-artifact-attestations.md b/content/actions/how-tos/secure-your-work/use-artifact-attestations/enforce-artifact-attestations.md
index e9b47a8e2858..9c12c151efa2 100644
--- a/content/actions/how-tos/secure-your-work/use-artifact-attestations/enforce-artifact-attestations.md
+++ b/content/actions/how-tos/secure-your-work/use-artifact-attestations/enforce-artifact-attestations.md
@@ -9,6 +9,8 @@ redirect_from:
- /actions/security-guides/enforcing-artifact-attestations-with-a-kubernetes-admission-controller
- /actions/security-for-github-actions/using-artifact-attestations/enforcing-artifact-attestations-with-a-kubernetes-admission-controller
- /actions/how-tos/security-for-github-actions/using-artifact-attestations/enforcing-artifact-attestations-with-a-kubernetes-admission-controller
+category:
+ - Secure your workflows
---
>[!NOTE] Before proceeding, ensure you have enabled build provenance for container images, including setting the `push-to-registry` attribute in the [`attest-build-provenance` action](https://github.com/actions/attest-build-provenance) as documented in [Generating build provenance for container images](/actions/security-guides/using-artifact-attestations-to-establish-provenance-for-builds#generating-build-provenance-for-container-images). This is required for the Policy Controller to verify the attestation.
diff --git a/content/actions/how-tos/secure-your-work/use-artifact-attestations/increase-security-rating.md b/content/actions/how-tos/secure-your-work/use-artifact-attestations/increase-security-rating.md
index a599e20639b1..f2e5fa0b7d40 100644
--- a/content/actions/how-tos/secure-your-work/use-artifact-attestations/increase-security-rating.md
+++ b/content/actions/how-tos/secure-your-work/use-artifact-attestations/increase-security-rating.md
@@ -9,6 +9,8 @@ redirect_from:
- /actions/security-guides/using-artifact-attestations-and-reusable-workflows-to-achieve-slsa-v1-build-level-3
- /actions/security-for-github-actions/using-artifact-attestations/using-artifact-attestations-and-reusable-workflows-to-achieve-slsa-v1-build-level-3
- /actions/how-tos/security-for-github-actions/using-artifact-attestations/using-artifact-attestations-and-reusable-workflows-to-achieve-slsa-v1-build-level-3
+category:
+ - Secure your workflows
---
## Prerequisites
diff --git a/content/actions/how-tos/secure-your-work/use-artifact-attestations/manage-attestations.md b/content/actions/how-tos/secure-your-work/use-artifact-attestations/manage-attestations.md
index ef3bd904fdb8..b6ff74b79876 100644
--- a/content/actions/how-tos/secure-your-work/use-artifact-attestations/manage-attestations.md
+++ b/content/actions/how-tos/secure-your-work/use-artifact-attestations/manage-attestations.md
@@ -7,6 +7,8 @@ versions:
ghec: '*'
redirect_from:
- /actions/how-tos/security-for-github-actions/using-artifact-attestations/managing-the-lifecycle-of-artifact-attestations
+category:
+ - Secure your workflows
---
{% data reusables.actions.lifecycle-of-attestations %}
diff --git a/content/actions/how-tos/secure-your-work/use-artifact-attestations/use-artifact-attestations.md b/content/actions/how-tos/secure-your-work/use-artifact-attestations/use-artifact-attestations.md
index 03613a07a560..c374ab5bef91 100644
--- a/content/actions/how-tos/secure-your-work/use-artifact-attestations/use-artifact-attestations.md
+++ b/content/actions/how-tos/secure-your-work/use-artifact-attestations/use-artifact-attestations.md
@@ -10,6 +10,8 @@ redirect_from:
- /actions/security-guides/using-artifact-attestations-to-establish-provenance-for-builds
- /actions/security-for-github-actions/using-artifact-attestations/using-artifact-attestations-to-establish-provenance-for-builds
- /actions/how-tos/security-for-github-actions/using-artifact-attestations/using-artifact-attestations-to-establish-provenance-for-builds
+category:
+ - Secure your workflows
---
## Prerequisites
diff --git a/content/actions/how-tos/secure-your-work/use-artifact-attestations/verify-attestations-offline.md b/content/actions/how-tos/secure-your-work/use-artifact-attestations/verify-attestations-offline.md
index 639a90897fb8..3333908b47ae 100644
--- a/content/actions/how-tos/secure-your-work/use-artifact-attestations/verify-attestations-offline.md
+++ b/content/actions/how-tos/secure-your-work/use-artifact-attestations/verify-attestations-offline.md
@@ -9,6 +9,8 @@ redirect_from:
- /actions/security-guides/verifying-attestations-offline
- /actions/security-for-github-actions/using-artifact-attestations/verifying-attestations-offline
- /actions/how-tos/security-for-github-actions/using-artifact-attestations/verifying-attestations-offline
+category:
+ - Secure your workflows
---
## Prerequisites
diff --git a/content/actions/how-tos/troubleshoot-workflows.md b/content/actions/how-tos/troubleshoot-workflows.md
index 8f13dd0cd575..dcc5ea21f538 100644
--- a/content/actions/how-tos/troubleshoot-workflows.md
+++ b/content/actions/how-tos/troubleshoot-workflows.md
@@ -13,6 +13,8 @@ redirect_from:
- /actions/how-tos/troubleshooting-workflows
- /actions/monitoring-and-troubleshooting-workflows/troubleshooting-workflows/using-copilot-to-troubleshoot-workflows
- /actions/monitoring-and-troubleshooting-workflows/troubleshooting-workflows
+category:
+ - Manage and monitor workflow runs
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/write-workflows/choose-what-workflows-do/add-scripts.md b/content/actions/how-tos/write-workflows/choose-what-workflows-do/add-scripts.md
index 79a4bb9d33d9..2037fd1713e1 100644
--- a/content/actions/how-tos/write-workflows/choose-what-workflows-do/add-scripts.md
+++ b/content/actions/how-tos/write-workflows/choose-what-workflows-do/add-scripts.md
@@ -9,6 +9,8 @@ versions:
redirect_from:
- /actions/writing-workflows/choosing-what-your-workflow-does/adding-scripts-to-your-workflow
- /actions/how-tos/writing-workflows/choosing-what-your-workflow-does/adding-scripts-to-your-workflow
+category:
+ - Write workflows
---
You can use a {% data variables.product.prodname_actions %} workflow to run scripts and shell commands, which are then executed on the assigned runner. This example demonstrates how to use the `run` keyword to execute the command `npm install -g bats` on the runner.
diff --git a/content/actions/how-tos/write-workflows/choose-what-workflows-do/deploy-to-environment.md b/content/actions/how-tos/write-workflows/choose-what-workflows-do/deploy-to-environment.md
index b4bfe5753c07..05b5b59504f5 100644
--- a/content/actions/how-tos/write-workflows/choose-what-workflows-do/deploy-to-environment.md
+++ b/content/actions/how-tos/write-workflows/choose-what-workflows-do/deploy-to-environment.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/writing-workflows/choosing-what-your-workflow-does/using-environments-for-deployment
- /actions/how-tos/writing-workflows/choosing-what-your-workflow-does/using-environments-for-deployment
- /actions/how-tos/writing-workflows/choosing-what-your-workflow-does/deploying-to-a-specific-environment
+category:
+ - Deploy to environments
---
## Prerequisites
diff --git a/content/actions/how-tos/write-workflows/choose-what-workflows-do/find-and-customize-actions.md b/content/actions/how-tos/write-workflows/choose-what-workflows-do/find-and-customize-actions.md
index 90d3bf4c7e7e..f48f4c83e149 100644
--- a/content/actions/how-tos/write-workflows/choose-what-workflows-do/find-and-customize-actions.md
+++ b/content/actions/how-tos/write-workflows/choose-what-workflows-do/find-and-customize-actions.md
@@ -16,6 +16,8 @@ versions:
ghes: '*'
ghec: '*'
type: how_to
+category:
+ - Write workflows
---
{% data reusables.actions.enterprise-marketplace-actions %}
diff --git a/content/actions/how-tos/write-workflows/choose-what-workflows-do/pass-job-outputs.md b/content/actions/how-tos/write-workflows/choose-what-workflows-do/pass-job-outputs.md
index 06f54ce4c288..bccd25c90a7b 100644
--- a/content/actions/how-tos/write-workflows/choose-what-workflows-do/pass-job-outputs.md
+++ b/content/actions/how-tos/write-workflows/choose-what-workflows-do/pass-job-outputs.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/writing-workflows/choosing-what-your-workflow-does/defining-outputs-for-jobs
- /actions/writing-workflows/choosing-what-your-workflow-does/passing-information-between-jobs
- /actions/how-tos/writing-workflows/choosing-what-your-workflow-does/passing-information-between-jobs
+category:
+ - Write workflows
---
## Defining and using job outputs
diff --git a/content/actions/how-tos/write-workflows/choose-what-workflows-do/run-job-variations.md b/content/actions/how-tos/write-workflows/choose-what-workflows-do/run-job-variations.md
index 01dd2aea3234..24d150c1ff3a 100644
--- a/content/actions/how-tos/write-workflows/choose-what-workflows-do/run-job-variations.md
+++ b/content/actions/how-tos/write-workflows/choose-what-workflows-do/run-job-variations.md
@@ -13,6 +13,8 @@ redirect_from:
- /actions/writing-workflows/choosing-what-your-workflow-does/using-a-matrix-for-your-jobs
- /actions/writing-workflows/choosing-what-your-workflow-does/running-variations-of-jobs-in-a-workflow
- /actions/how-tos/writing-workflows/choosing-what-your-workflow-does/running-variations-of-jobs-in-a-workflow
+category:
+ - Write workflows
---
## About matrix strategies
diff --git a/content/actions/how-tos/write-workflows/choose-what-workflows-do/set-default-values-for-jobs.md b/content/actions/how-tos/write-workflows/choose-what-workflows-do/set-default-values-for-jobs.md
index 0459494a5ed2..643a64aa2a11 100644
--- a/content/actions/how-tos/write-workflows/choose-what-workflows-do/set-default-values-for-jobs.md
+++ b/content/actions/how-tos/write-workflows/choose-what-workflows-do/set-default-values-for-jobs.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/writing-workflows/choosing-what-your-workflow-does/setting-default-values-for-jobs
- /actions/writing-workflows/choosing-what-your-workflow-does/setting-a-default-shell-and-working-directory
- /actions/how-tos/writing-workflows/choosing-what-your-workflow-does/setting-a-default-shell-and-working-directory
+category:
+ - Write workflows
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/write-workflows/choose-what-workflows-do/use-github-cli.md b/content/actions/how-tos/write-workflows/choose-what-workflows-do/use-github-cli.md
index 47658a9ecaca..4ece29159018 100644
--- a/content/actions/how-tos/write-workflows/choose-what-workflows-do/use-github-cli.md
+++ b/content/actions/how-tos/write-workflows/choose-what-workflows-do/use-github-cli.md
@@ -14,6 +14,8 @@ versions:
ghes: '*'
ghec: '*'
type: how_to
+category:
+ - Write workflows
---
diff --git a/content/actions/how-tos/write-workflows/choose-what-workflows-do/use-jobs.md b/content/actions/how-tos/write-workflows/choose-what-workflows-do/use-jobs.md
index 917c57db104f..5ad95a4eac15 100644
--- a/content/actions/how-tos/write-workflows/choose-what-workflows-do/use-jobs.md
+++ b/content/actions/how-tos/write-workflows/choose-what-workflows-do/use-jobs.md
@@ -10,6 +10,8 @@ redirect_from:
- /actions/using-jobs/using-jobs-in-a-workflow
- /actions/writing-workflows/choosing-what-your-workflow-does/using-jobs-in-a-workflow
- /actions/how-tos/writing-workflows/choosing-what-your-workflow-does/using-jobs-in-a-workflow
+category:
+ - Write workflows
---
## Prerequisites
diff --git a/content/actions/how-tos/write-workflows/choose-what-workflows-do/use-secrets.md b/content/actions/how-tos/write-workflows/choose-what-workflows-do/use-secrets.md
index 8da765aac983..958d0a107433 100644
--- a/content/actions/how-tos/write-workflows/choose-what-workflows-do/use-secrets.md
+++ b/content/actions/how-tos/write-workflows/choose-what-workflows-do/use-secrets.md
@@ -20,6 +20,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Secure your workflows
---
## Creating secrets for a repository
diff --git a/content/actions/how-tos/write-workflows/choose-what-workflows-do/use-variables.md b/content/actions/how-tos/write-workflows/choose-what-workflows-do/use-variables.md
index 6c94cbe0f77b..cae73fcaee64 100644
--- a/content/actions/how-tos/write-workflows/choose-what-workflows-do/use-variables.md
+++ b/content/actions/how-tos/write-workflows/choose-what-workflows-do/use-variables.md
@@ -17,6 +17,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Write workflows
---
## Defining environment variables for a single workflow
diff --git a/content/actions/how-tos/write-workflows/choose-when-workflows-run/control-jobs-with-conditions.md b/content/actions/how-tos/write-workflows/choose-when-workflows-run/control-jobs-with-conditions.md
index da8210168003..e74a1824e790 100644
--- a/content/actions/how-tos/write-workflows/choose-when-workflows-run/control-jobs-with-conditions.md
+++ b/content/actions/how-tos/write-workflows/choose-when-workflows-run/control-jobs-with-conditions.md
@@ -10,6 +10,8 @@ redirect_from:
- /actions/using-jobs/using-conditions-to-control-job-execution
- /actions/writing-workflows/choosing-when-your-workflow-runs/using-conditions-to-control-job-execution
- /actions/how-tos/writing-workflows/choosing-when-your-workflow-runs/using-conditions-to-control-job-execution
+category:
+ - Write workflows
---
You can use the `jobs..if` conditional to prevent a job from running unless a condition is met. {% data reusables.actions.if-supported-contexts %}
diff --git a/content/actions/how-tos/write-workflows/choose-when-workflows-run/control-workflow-concurrency.md b/content/actions/how-tos/write-workflows/choose-when-workflows-run/control-workflow-concurrency.md
index 36b38bc1258a..bf137deacd41 100644
--- a/content/actions/how-tos/write-workflows/choose-when-workflows-run/control-workflow-concurrency.md
+++ b/content/actions/how-tos/write-workflows/choose-when-workflows-run/control-workflow-concurrency.md
@@ -13,6 +13,8 @@ redirect_from:
- /actions/writing-workflows/choosing-what-your-workflow-does/control-the-concurrency-of-workflows-and-jobs
- /actions/how-tos/writing-workflows/choosing-what-your-workflow-does/control-the-concurrency-of-workflows-and-jobs
- /actions/how-tos/writing-workflows/choosing-when-your-workflow-runs/control-the-concurrency-of-workflows-and-jobs
+category:
+ - Write workflows
---
## Using concurrency in different scenarios
diff --git a/content/actions/how-tos/write-workflows/choose-when-workflows-run/trigger-a-workflow.md b/content/actions/how-tos/write-workflows/choose-when-workflows-run/trigger-a-workflow.md
index 60ba4f532ca0..24e434aed80d 100644
--- a/content/actions/how-tos/write-workflows/choose-when-workflows-run/trigger-a-workflow.md
+++ b/content/actions/how-tos/write-workflows/choose-when-workflows-run/trigger-a-workflow.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/using-workflows/triggering-a-workflow
- /actions/writing-workflows/choosing-when-your-workflow-runs/triggering-a-workflow
- /actions/how-tos/writing-workflows/choosing-when-your-workflow-runs/triggering-a-workflow
+category:
+ - Write workflows
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/write-workflows/choose-where-workflows-run/choose-the-runner-for-a-job.md b/content/actions/how-tos/write-workflows/choose-where-workflows-run/choose-the-runner-for-a-job.md
index e5f9b89d16d8..2f9ea904acc0 100644
--- a/content/actions/how-tos/write-workflows/choose-where-workflows-run/choose-the-runner-for-a-job.md
+++ b/content/actions/how-tos/write-workflows/choose-where-workflows-run/choose-the-runner-for-a-job.md
@@ -10,6 +10,8 @@ redirect_from:
- /actions/using-jobs/choosing-the-runner-for-a-job
- /actions/writing-workflows/choosing-where-your-workflow-runs/choosing-the-runner-for-a-job
- /actions/how-tos/writing-workflows/choosing-where-your-workflow-runs/choosing-the-runner-for-a-job
+category:
+ - Write workflows
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/write-workflows/choose-where-workflows-run/run-jobs-in-a-container.md b/content/actions/how-tos/write-workflows/choose-where-workflows-run/run-jobs-in-a-container.md
index 5ffd10e89c4b..8a9cd74144b9 100644
--- a/content/actions/how-tos/write-workflows/choose-where-workflows-run/run-jobs-in-a-container.md
+++ b/content/actions/how-tos/write-workflows/choose-where-workflows-run/run-jobs-in-a-container.md
@@ -10,6 +10,8 @@ redirect_from:
- /actions/using-jobs/running-jobs-in-a-container
- /actions/writing-workflows/choosing-where-your-workflow-runs/running-jobs-in-a-container
- /actions/how-tos/writing-workflows/choosing-where-your-workflow-runs/running-jobs-in-a-container
+category:
+ - Write workflows
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/how-tos/write-workflows/use-workflow-templates.md b/content/actions/how-tos/write-workflows/use-workflow-templates.md
index 07fafa4aae3d..2eef6d09b1c9 100644
--- a/content/actions/how-tos/write-workflows/use-workflow-templates.md
+++ b/content/actions/how-tos/write-workflows/use-workflow-templates.md
@@ -19,6 +19,8 @@ versions:
ghes: '*'
ghec: '*'
type: tutorial
+category:
+ - Write workflows
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/index.md b/content/actions/index.md
index d9f1443b7051..689f1980af20 100644
--- a/content/actions/index.md
+++ b/content/actions/index.md
@@ -5,19 +5,6 @@ intro: 'Automate, customize, and execute your software development workflows rig
introLinks:
overview: /actions/get-started/understand-github-actions
quickstart: /actions/get-started/quickstart
-featuredLinks:
- startHere:
- - /actions/how-tos/write-workflows
- - /actions/tutorials
- - /actions/get-started/continuous-integration
- - /packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions
- guideCards:
- - /actions/how-tos/write-workflows/use-workflow-templates
- - /actions/tutorials/publish-packages/publish-nodejs-packages
- - /actions/tutorials/build-and-test-code/powershell
- popular:
- - /actions/reference/workflows-and-actions/workflow-syntax
- - /actions/how-tos/write-workflows
changelog:
label: actions
redirect_from:
@@ -27,11 +14,36 @@ redirect_from:
- /actions/automating-your-workflow-with-github-actions
- /categories/automating-your-workflow-with-github-actions
- /marketplace/actions
-layout: product-landing
+layout: discovery-landing
+heroImage: /assets/images/banner-images/hero-3
+contentType: landing
+carousels:
+ recommended:
+ - /actions/get-started/quickstart
+ - /actions/get-started/understand-github-actions
+ - /actions/tutorials/use-actions-runner-controller
+ - /actions/reference/workflows-and-actions/workflow-syntax
+ - /actions/reference/workflows-and-actions/events-that-trigger-workflows
+ - /actions/how-tos/secure-your-work/use-artifact-attestations/use-artifact-attestations
+ - /actions/tutorials/migrate-to-github-actions
+ - /actions/how-tos/reuse-automations/reuse-workflows
+ - /actions/how-tos/administer/view-metrics
versions:
fpt: '*'
ghes: '*'
ghec: '*'
+includedCategories:
+ - Get started with GitHub Actions
+ - Migrate to GitHub Actions
+ - Write workflows
+ - Build and test code
+ - Deploy to environments
+ - Set up runners
+ - Use and manage runners
+ - Secure your workflows
+ - Reuse and share automations
+ - Manage and monitor workflow runs
+ - Administer GitHub Actions
children:
- /get-started
- /concepts
diff --git a/content/actions/reference/github-actions-importer/custom-transformers.md b/content/actions/reference/github-actions-importer/custom-transformers.md
index 63dae39591df..d97be008c7ac 100644
--- a/content/actions/reference/github-actions-importer/custom-transformers.md
+++ b/content/actions/reference/github-actions-importer/custom-transformers.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/extending-github-actions-importer-with-custom-transformers
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/extending-github-actions-importer-with-custom-transformers
- /actions/reference/extending-github-actions-importer-with-custom-transformers
+category:
+ - Migrate to GitHub Actions
---
## About custom transformers
diff --git a/content/actions/reference/github-actions-importer/supplemental-arguments-and-settings.md b/content/actions/reference/github-actions-importer/supplemental-arguments-and-settings.md
index cde97315e5e8..7a226e2a0b8d 100644
--- a/content/actions/reference/github-actions-importer/supplemental-arguments-and-settings.md
+++ b/content/actions/reference/github-actions-importer/supplemental-arguments-and-settings.md
@@ -10,6 +10,8 @@ redirect_from:
- /actions/migrating-to-github-actions/automated-migrations/supplemental-arguments-and-settings
- /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/supplemental-arguments-and-settings
- /actions/reference/supplemental-arguments-and-settings
+category:
+ - Migrate to GitHub Actions
---
This article provides general information for configuring {% data variables.product.prodname_actions_importer %}'s supplemental arguments and settings, such as optional parameters, path arguments, and network settings.
diff --git a/content/actions/reference/limits.md b/content/actions/reference/limits.md
index 2d2a5f42f7ec..598a1a906935 100644
--- a/content/actions/reference/limits.md
+++ b/content/actions/reference/limits.md
@@ -11,6 +11,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Limits
+category:
+ - Administer GitHub Actions
---
You may be rate limited by {% data variables.product.prodname_actions %} when you scale your usage. Some limits can be increased by contacting {% data variables.contact.contact_support %}.
diff --git a/content/actions/reference/runners/github-hosted-runners.md b/content/actions/reference/runners/github-hosted-runners.md
index f7ad145edda9..08400975dda5 100644
--- a/content/actions/reference/runners/github-hosted-runners.md
+++ b/content/actions/reference/runners/github-hosted-runners.md
@@ -8,6 +8,8 @@ versions:
ghec: '*'
redirect_from:
- /actions/reference/github-hosted-runners-reference
+category:
+ - Set up runners
---
{% ifversion ghes %}
diff --git a/content/actions/reference/runners/larger-runners.md b/content/actions/reference/runners/larger-runners.md
index 225fd5543a3f..217f2e85d234 100644
--- a/content/actions/reference/runners/larger-runners.md
+++ b/content/actions/reference/runners/larger-runners.md
@@ -8,6 +8,8 @@ versions:
ghec: '*'
redirect_from:
- /actions/reference/larger-runners-reference
+category:
+ - Set up runners
---
{% ifversion ghes %}
diff --git a/content/actions/reference/runners/self-hosted-runners.md b/content/actions/reference/runners/self-hosted-runners.md
index fad39165099e..b977f2bda6a6 100644
--- a/content/actions/reference/runners/self-hosted-runners.md
+++ b/content/actions/reference/runners/self-hosted-runners.md
@@ -16,6 +16,8 @@ versions:
ghes: '*'
ghec: '*'
type: overview
+category:
+ - Set up runners
---
## Requirements for self-hosted runner machines
diff --git a/content/actions/reference/security/oidc.md b/content/actions/reference/security/oidc.md
index 7566adc7c384..7a956b793ce5 100644
--- a/content/actions/reference/security/oidc.md
+++ b/content/actions/reference/security/oidc.md
@@ -8,6 +8,8 @@ versions:
ghes: '*'
redirect_from:
- /actions/reference/openid-connect-reference
+category:
+ - Secure your workflows
---
## OIDC token claims
diff --git a/content/actions/reference/security/secrets.md b/content/actions/reference/security/secrets.md
index 448a7def324e..b3062d6fb2c4 100644
--- a/content/actions/reference/security/secrets.md
+++ b/content/actions/reference/security/secrets.md
@@ -8,6 +8,8 @@ versions:
ghes: '*'
redirect_from:
- /actions/reference/secrets-reference
+category:
+ - Secure your workflows
---
## Naming your secrets
diff --git a/content/actions/reference/security/secure-use.md b/content/actions/reference/security/secure-use.md
index cc8f0e6d68bd..d516978a7008 100644
--- a/content/actions/reference/security/secure-use.md
+++ b/content/actions/reference/security/secure-use.md
@@ -16,6 +16,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Secure your workflows
---
Find information about security best practices when you are writing workflows and using {% data variables.product.prodname_actions %} security features.
diff --git a/content/actions/reference/workflows-and-actions/contexts.md b/content/actions/reference/workflows-and-actions/contexts.md
index fda0416bc373..04947ea97438 100644
--- a/content/actions/reference/workflows-and-actions/contexts.md
+++ b/content/actions/reference/workflows-and-actions/contexts.md
@@ -17,6 +17,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Write workflows
---
## Available contexts
diff --git a/content/actions/reference/workflows-and-actions/dependency-caching.md b/content/actions/reference/workflows-and-actions/dependency-caching.md
index fa8a65d8a347..ea188753fd25 100644
--- a/content/actions/reference/workflows-and-actions/dependency-caching.md
+++ b/content/actions/reference/workflows-and-actions/dependency-caching.md
@@ -17,6 +17,8 @@ versions:
ghes: '*'
ghec: '*'
type: overview
+category:
+ - Write workflows
---
## `cache` action usage
diff --git a/content/actions/reference/workflows-and-actions/deployments-and-environments.md b/content/actions/reference/workflows-and-actions/deployments-and-environments.md
index 21f214414dd3..3802f03914c4 100644
--- a/content/actions/reference/workflows-and-actions/deployments-and-environments.md
+++ b/content/actions/reference/workflows-and-actions/deployments-and-environments.md
@@ -8,6 +8,8 @@ versions:
ghec: '*'
redirect_from:
- /actions/reference/deployments-and-environments
+category:
+ - Deploy to environments
---
## Deployment protection rules
diff --git a/content/actions/reference/workflows-and-actions/dockerfile-support.md b/content/actions/reference/workflows-and-actions/dockerfile-support.md
index ff859e6cdb2e..2d7ecbbf8165 100644
--- a/content/actions/reference/workflows-and-actions/dockerfile-support.md
+++ b/content/actions/reference/workflows-and-actions/dockerfile-support.md
@@ -12,6 +12,8 @@ versions:
ghes: '*'
ghec: '*'
type: reference
+category:
+ - Write workflows
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/reference/workflows-and-actions/events-that-trigger-workflows.md b/content/actions/reference/workflows-and-actions/events-that-trigger-workflows.md
index 8addf2f0384f..b50094b2ca4a 100644
--- a/content/actions/reference/workflows-and-actions/events-that-trigger-workflows.md
+++ b/content/actions/reference/workflows-and-actions/events-that-trigger-workflows.md
@@ -13,6 +13,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Write workflows
---
## About events that trigger workflows
diff --git a/content/actions/reference/workflows-and-actions/expressions.md b/content/actions/reference/workflows-and-actions/expressions.md
index 0e06951605eb..9a15c2c9182d 100644
--- a/content/actions/reference/workflows-and-actions/expressions.md
+++ b/content/actions/reference/workflows-and-actions/expressions.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/writing-workflows/choosing-what-your-workflow-does/expressions
- /actions/writing-workflows/choosing-what-your-workflow-does/evaluate-expressions-in-workflows-and-actions
- /actions/reference/evaluate-expressions-in-workflows-and-actions
+category:
+ - Write workflows
---
## Literals
diff --git a/content/actions/reference/workflows-and-actions/metadata-syntax.md b/content/actions/reference/workflows-and-actions/metadata-syntax.md
index 274c12617f19..6b4123651e77 100644
--- a/content/actions/reference/workflows-and-actions/metadata-syntax.md
+++ b/content/actions/reference/workflows-and-actions/metadata-syntax.md
@@ -17,6 +17,8 @@ versions:
ghec: '*'
type: reference
allowTitleToDifferFromFilename: true
+category:
+ - Reuse and share automations
---
{% data reusables.actions.types-of-actions %}
diff --git a/content/actions/reference/workflows-and-actions/reusing-workflow-configurations.md b/content/actions/reference/workflows-and-actions/reusing-workflow-configurations.md
index bf9d93492f63..c3596f959897 100644
--- a/content/actions/reference/workflows-and-actions/reusing-workflow-configurations.md
+++ b/content/actions/reference/workflows-and-actions/reusing-workflow-configurations.md
@@ -9,6 +9,8 @@ versions:
redirect_from:
- /actions/reference/reusable-workflows-reference
- /actions/reference/workflows-and-actions/reusable-workflows
+category:
+ - Reuse and share automations
---
## Reusable workflows
diff --git a/content/actions/reference/workflows-and-actions/variables.md b/content/actions/reference/workflows-and-actions/variables.md
index a93f918b23a2..dc990c820263 100644
--- a/content/actions/reference/workflows-and-actions/variables.md
+++ b/content/actions/reference/workflows-and-actions/variables.md
@@ -8,6 +8,8 @@ versions:
ghec: '*'
redirect_from:
- /actions/reference/variables-reference
+category:
+ - Write workflows
---
This article lists the supported variables you can use in {% data variables.product.prodname_actions %} workflows, including environment variables, configuration variables, and default variables provided by {% data variables.product.github %}. Use this reference to look up variable names, naming conventions, limits, and supported contexts when configuring your workflows.
diff --git a/content/actions/reference/workflows-and-actions/workflow-cancellation.md b/content/actions/reference/workflows-and-actions/workflow-cancellation.md
index 89918b16eaf6..78c6b8718d56 100644
--- a/content/actions/reference/workflows-and-actions/workflow-cancellation.md
+++ b/content/actions/reference/workflows-and-actions/workflow-cancellation.md
@@ -8,6 +8,8 @@ versions:
ghec: '*'
redirect_from:
- /actions/reference/workflow-cancellation-reference
+category:
+ - Manage and monitor workflow runs
---
When canceling a workflow run, you may be running other software that uses resources related to the workflow run. To help you free up resources related to the workflow run, it may help to understand the steps {% data variables.product.prodname_dotcom %} performs to cancel a workflow run.
diff --git a/content/actions/reference/workflows-and-actions/workflow-commands.md b/content/actions/reference/workflows-and-actions/workflow-commands.md
index 29004a842f75..ef69b9babd0c 100644
--- a/content/actions/reference/workflows-and-actions/workflow-commands.md
+++ b/content/actions/reference/workflows-and-actions/workflow-commands.md
@@ -17,6 +17,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Write workflows
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/reference/workflows-and-actions/workflow-syntax.md b/content/actions/reference/workflows-and-actions/workflow-syntax.md
index b916b5c66a4e..a42ed050a697 100644
--- a/content/actions/reference/workflows-and-actions/workflow-syntax.md
+++ b/content/actions/reference/workflows-and-actions/workflow-syntax.md
@@ -15,6 +15,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+category:
+ - Write workflows
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/authenticate-with-github_token.md b/content/actions/tutorials/authenticate-with-github_token.md
index 9e2bea6a58d4..ec51f8dc266b 100644
--- a/content/actions/tutorials/authenticate-with-github_token.md
+++ b/content/actions/tutorials/authenticate-with-github_token.md
@@ -21,6 +21,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Authenticate with GITHUB_TOKEN
+category:
+ - Secure your workflows
---
This tutorial leads you through how to use the `GITHUB_TOKEN` for authentication in {% data variables.product.prodname_actions %} workflows, including examples for passing the token to actions, making API requests, and configuring permissions for secure automation.
diff --git a/content/actions/tutorials/build-and-test-code/go.md b/content/actions/tutorials/build-and-test-code/go.md
index d13d9296b3dc..cabcd8864ba5 100644
--- a/content/actions/tutorials/build-and-test-code/go.md
+++ b/content/actions/tutorials/build-and-test-code/go.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-go
- /actions/how-tos/writing-workflows/building-and-testing/building-and-testing-go
- /actions/tutorials/build-and-test-code/building-and-testing-go
+category:
+ - Build and test code
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/build-and-test-code/java-with-ant.md b/content/actions/tutorials/build-and-test-code/java-with-ant.md
index 5a8c73a466ab..ebcf30fc1bd9 100644
--- a/content/actions/tutorials/build-and-test-code/java-with-ant.md
+++ b/content/actions/tutorials/build-and-test-code/java-with-ant.md
@@ -13,6 +13,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Java with Ant
+category:
+ - Build and test code
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/build-and-test-code/java-with-gradle.md b/content/actions/tutorials/build-and-test-code/java-with-gradle.md
index 5ae827b9a214..702362d7d298 100644
--- a/content/actions/tutorials/build-and-test-code/java-with-gradle.md
+++ b/content/actions/tutorials/build-and-test-code/java-with-gradle.md
@@ -14,6 +14,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Java with Gradle
+category:
+ - Build and test code
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/build-and-test-code/java-with-maven.md b/content/actions/tutorials/build-and-test-code/java-with-maven.md
index 60a1e9bd60b9..869da64d9435 100644
--- a/content/actions/tutorials/build-and-test-code/java-with-maven.md
+++ b/content/actions/tutorials/build-and-test-code/java-with-maven.md
@@ -14,6 +14,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Java with Maven
+category:
+ - Build and test code
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/build-and-test-code/net.md b/content/actions/tutorials/build-and-test-code/net.md
index e6543c990003..7135e68f40a9 100644
--- a/content/actions/tutorials/build-and-test-code/net.md
+++ b/content/actions/tutorials/build-and-test-code/net.md
@@ -13,6 +13,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: .NET
+category:
+ - Build and test code
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/build-and-test-code/nodejs.md b/content/actions/tutorials/build-and-test-code/nodejs.md
index 504686a8ff9d..7e2e80870750 100644
--- a/content/actions/tutorials/build-and-test-code/nodejs.md
+++ b/content/actions/tutorials/build-and-test-code/nodejs.md
@@ -15,6 +15,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Node.js
+category:
+ - Build and test code
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/build-and-test-code/powershell.md b/content/actions/tutorials/build-and-test-code/powershell.md
index bbbb32cb02fe..52230080eb7c 100644
--- a/content/actions/tutorials/build-and-test-code/powershell.md
+++ b/content/actions/tutorials/build-and-test-code/powershell.md
@@ -15,6 +15,8 @@ versions:
authors:
- potatoqualitee
shortTitle: PowerShell
+category:
+ - Build and test code
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/build-and-test-code/python.md b/content/actions/tutorials/build-and-test-code/python.md
index 932567fa5ea8..efad77a34418 100644
--- a/content/actions/tutorials/build-and-test-code/python.md
+++ b/content/actions/tutorials/build-and-test-code/python.md
@@ -15,6 +15,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Python
+category:
+ - Build and test code
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/build-and-test-code/ruby.md b/content/actions/tutorials/build-and-test-code/ruby.md
index 0ab1cdc5a9c1..67e0f1a30b52 100644
--- a/content/actions/tutorials/build-and-test-code/ruby.md
+++ b/content/actions/tutorials/build-and-test-code/ruby.md
@@ -13,6 +13,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Ruby
+category:
+ - Build and test code
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/build-and-test-code/rust.md b/content/actions/tutorials/build-and-test-code/rust.md
index cf146029271b..a9d7affa47c5 100644
--- a/content/actions/tutorials/build-and-test-code/rust.md
+++ b/content/actions/tutorials/build-and-test-code/rust.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/how-tos/use-cases-and-examples/building-and-testing/building-and-testing-rust
- /actions/how-tos/writing-workflows/building-and-testing/building-and-testing-rust
- /actions/tutorials/build-and-test-code/building-and-testing-rust
+category:
+ - Build and test code
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/build-and-test-code/swift.md b/content/actions/tutorials/build-and-test-code/swift.md
index 5ceb18605346..d87b743600a0 100644
--- a/content/actions/tutorials/build-and-test-code/swift.md
+++ b/content/actions/tutorials/build-and-test-code/swift.md
@@ -13,6 +13,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Swift
+category:
+ - Build and test code
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/build-and-test-code/xamarin-apps.md b/content/actions/tutorials/build-and-test-code/xamarin-apps.md
index fb40e2bf3f93..e459bb7c06cb 100644
--- a/content/actions/tutorials/build-and-test-code/xamarin-apps.md
+++ b/content/actions/tutorials/build-and-test-code/xamarin-apps.md
@@ -13,6 +13,8 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Xamarin apps
+category:
+ - Build and test code
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/create-actions/create-a-composite-action.md b/content/actions/tutorials/create-actions/create-a-composite-action.md
index cf2524b60c1b..8204aa1cb91a 100644
--- a/content/actions/tutorials/create-actions/create-a-composite-action.md
+++ b/content/actions/tutorials/create-actions/create-a-composite-action.md
@@ -13,6 +13,8 @@ versions:
ghec: '*'
type: tutorial
defaultPlatform: linux
+category:
+ - Reuse and share automations
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/create-actions/create-a-javascript-action.md b/content/actions/tutorials/create-actions/create-a-javascript-action.md
index 39c8bbdb8fb2..e13d9849f170 100644
--- a/content/actions/tutorials/create-actions/create-a-javascript-action.md
+++ b/content/actions/tutorials/create-actions/create-a-javascript-action.md
@@ -15,6 +15,8 @@ versions:
ghes: '*'
ghec: '*'
type: tutorial
+category:
+ - Reuse and share automations
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/create-an-example-workflow.md b/content/actions/tutorials/create-an-example-workflow.md
index c63e0d52d09a..d01239bd06c9 100644
--- a/content/actions/tutorials/create-an-example-workflow.md
+++ b/content/actions/tutorials/create-an-example-workflow.md
@@ -11,6 +11,8 @@ layout: inline
redirect_from:
- /actions/use-cases-and-examples/creating-an-example-workflow
- /actions/tutorials/creating-an-example-workflow
+category:
+ - Get started with GitHub Actions
---
## Introduction
diff --git a/content/actions/tutorials/manage-your-work/add-comments-with-labels.md b/content/actions/tutorials/manage-your-work/add-comments-with-labels.md
index ba3b9d8de11e..2c768ad97585 100644
--- a/content/actions/tutorials/manage-your-work/add-comments-with-labels.md
+++ b/content/actions/tutorials/manage-your-work/add-comments-with-labels.md
@@ -13,6 +13,8 @@ versions:
ghec: '*'
type: tutorial
shortTitle: Add comments with labels
+category:
+ - Reuse and share automations
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/manage-your-work/add-labels-to-issues.md b/content/actions/tutorials/manage-your-work/add-labels-to-issues.md
index cf4a0c9b9893..98928ce2e1d6 100644
--- a/content/actions/tutorials/manage-your-work/add-labels-to-issues.md
+++ b/content/actions/tutorials/manage-your-work/add-labels-to-issues.md
@@ -13,6 +13,8 @@ versions:
ghes: '*'
ghec: '*'
type: tutorial
+category:
+ - Reuse and share automations
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/manage-your-work/close-inactive-issues.md b/content/actions/tutorials/manage-your-work/close-inactive-issues.md
index 559eb128d642..6615527458d8 100644
--- a/content/actions/tutorials/manage-your-work/close-inactive-issues.md
+++ b/content/actions/tutorials/manage-your-work/close-inactive-issues.md
@@ -13,6 +13,8 @@ versions:
ghes: '*'
ghec: '*'
type: tutorial
+category:
+ - Reuse and share automations
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/manage-your-work/schedule-issue-creation.md b/content/actions/tutorials/manage-your-work/schedule-issue-creation.md
index 5366226c8728..320d617c5e66 100644
--- a/content/actions/tutorials/manage-your-work/schedule-issue-creation.md
+++ b/content/actions/tutorials/manage-your-work/schedule-issue-creation.md
@@ -13,6 +13,8 @@ versions:
ghes: '*'
ghec: '*'
type: tutorial
+category:
+ - Reuse and share automations
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/azure-devops-migration.md b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/azure-devops-migration.md
index 5ec366842487..a2d8afa60026 100644
--- a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/azure-devops-migration.md
+++ b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/azure-devops-migration.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-azure-devops-with-github-actions-importer
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-azure-devops-with-github-actions-importer
- /actions/tutorials/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-azure-devops-with-github-actions-importer
+category:
+ - Migrate to GitHub Actions
---
## About migrating from Azure DevOps with GitHub Actions Importer
diff --git a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/bamboo-migration.md b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/bamboo-migration.md
index 9d2e62156723..28dc3a1ff51d 100644
--- a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/bamboo-migration.md
+++ b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/bamboo-migration.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-bamboo-with-github-actions-importer
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-bamboo-with-github-actions-importer
- /actions/tutorials/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-bamboo-with-github-actions-importer
+category:
+ - Migrate to GitHub Actions
---
## About migrating from Bamboo with GitHub Actions Importer
diff --git a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/bitbucket-pipelines-migration.md b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/bitbucket-pipelines-migration.md
index c097bff135ca..ab690af72204 100644
--- a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/bitbucket-pipelines-migration.md
+++ b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/bitbucket-pipelines-migration.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-bitbucket-pipelines-with-github-actions-importer
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-bitbucket-pipelines-with-github-actions-importer
- /actions/tutorials/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-bitbucket-pipelines-with-github-actions-importer
+category:
+ - Migrate to GitHub Actions
---
## About migrating from Bitbucket Pipelines with GitHub Actions Importer
diff --git a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/circleci-migration.md b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/circleci-migration.md
index c8e0142d4ef6..da912a537085 100644
--- a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/circleci-migration.md
+++ b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/circleci-migration.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-circleci-with-github-actions-importer
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-circleci-with-github-actions-importer
- /actions/tutorials/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-circleci-with-github-actions-importer
+category:
+ - Migrate to GitHub Actions
---
## About migrating from CircleCI with GitHub Actions Importer
diff --git a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/gitlab-migration.md b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/gitlab-migration.md
index 370b3ab1eac5..dd520385b44a 100644
--- a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/gitlab-migration.md
+++ b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/gitlab-migration.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-gitlab-with-github-actions-importer
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-gitlab-with-github-actions-importer
- /actions/tutorials/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-gitlab-with-github-actions-importer
+category:
+ - Migrate to GitHub Actions
---
## About migrating from GitLab with GitHub Actions Importer
diff --git a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/jenkins-migration.md b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/jenkins-migration.md
index e2e26e224ee3..13ff6fb35dab 100644
--- a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/jenkins-migration.md
+++ b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/jenkins-migration.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-jenkins-with-github-actions-importer
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-jenkins-with-github-actions-importer
- /actions/tutorials/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-jenkins-with-github-actions-importer
+category:
+ - Migrate to GitHub Actions
---
## About migrating from Jenkins with GitHub Actions Importer
diff --git a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/travis-ci-migration.md b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/travis-ci-migration.md
index ce15ca31e7cb..02b271fc2a66 100644
--- a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/travis-ci-migration.md
+++ b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/travis-ci-migration.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-travis-ci-with-github-actions-importer
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-travis-ci-with-github-actions-importer
- /actions/tutorials/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-travis-ci-with-github-actions-importer
+category:
+ - Migrate to GitHub Actions
---
## About migrating from Travis CI with GitHub Actions Importer
diff --git a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/use-github-actions-importer.md b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/use-github-actions-importer.md
index dc9c6587b622..00d0f99ce337 100644
--- a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/use-github-actions-importer.md
+++ b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/use-github-actions-importer.md
@@ -13,6 +13,8 @@ versions:
ghec: '*'
ghes: '*'
type: how_to
+category:
+ - Migrate to GitHub Actions
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-azure-pipelines.md b/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-azure-pipelines.md
index dba72aa0e25d..2bae9c4ee0dd 100644
--- a/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-azure-pipelines.md
+++ b/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-azure-pipelines.md
@@ -14,6 +14,8 @@ versions:
ghec: '*'
type: tutorial
shortTitle: Migrate from Azure Pipelines
+category:
+ - Migrate to GitHub Actions
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-circleci.md b/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-circleci.md
index b073d91280da..c829ea71a5bb 100644
--- a/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-circleci.md
+++ b/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-circleci.md
@@ -14,6 +14,8 @@ versions:
ghec: '*'
type: tutorial
shortTitle: Migrate from CircleCI
+category:
+ - Migrate to GitHub Actions
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-gitlab-cicd.md b/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-gitlab-cicd.md
index 9ffd7836bf3b..7747553b58d7 100644
--- a/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-gitlab-cicd.md
+++ b/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-gitlab-cicd.md
@@ -14,6 +14,8 @@ versions:
ghec: '*'
type: tutorial
shortTitle: Migrate from GitLab CI/CD
+category:
+ - Migrate to GitHub Actions
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-jenkins.md b/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-jenkins.md
index 69837463aeb3..9503bf520a86 100644
--- a/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-jenkins.md
+++ b/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-jenkins.md
@@ -14,6 +14,8 @@ versions:
ghec: '*'
type: tutorial
shortTitle: Migrate from Jenkins
+category:
+ - Migrate to GitHub Actions
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-travis-ci.md b/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-travis-ci.md
index ddbd39acdeaf..142c034a508f 100644
--- a/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-travis-ci.md
+++ b/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-travis-ci.md
@@ -14,6 +14,8 @@ versions:
ghec: '*'
type: tutorial
shortTitle: Migrate from Travis CI
+category:
+ - Migrate to GitHub Actions
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/migrate-to-github-runners.md b/content/actions/tutorials/migrate-to-github-runners.md
index e00eb86770d6..a11df80650db 100644
--- a/content/actions/tutorials/migrate-to-github-runners.md
+++ b/content/actions/tutorials/migrate-to-github-runners.md
@@ -8,6 +8,8 @@ versions:
contentType: tutorials
audience:
- driver
+category:
+ - Set up runners
---
You can run workflows on {% data variables.product.github %}-hosted or self-hosted runners, or use a mixture of runner types.
diff --git a/content/actions/tutorials/publish-packages/publish-docker-images.md b/content/actions/tutorials/publish-packages/publish-docker-images.md
index ae42a877c827..b6abaeadaa34 100644
--- a/content/actions/tutorials/publish-packages/publish-docker-images.md
+++ b/content/actions/tutorials/publish-packages/publish-docker-images.md
@@ -15,6 +15,8 @@ versions:
ghec: '*'
type: tutorial
layout: inline
+category:
+ - Build and test code
---
## Introduction
diff --git a/content/actions/tutorials/publish-packages/publish-java-packages-with-gradle.md b/content/actions/tutorials/publish-packages/publish-java-packages-with-gradle.md
index 2c27f0ea1022..a7066f77037c 100644
--- a/content/actions/tutorials/publish-packages/publish-java-packages-with-gradle.md
+++ b/content/actions/tutorials/publish-packages/publish-java-packages-with-gradle.md
@@ -14,6 +14,8 @@ versions:
ghes: '*'
ghec: '*'
type: tutorial
+category:
+ - Build and test code
---
## Introduction
diff --git a/content/actions/tutorials/publish-packages/publish-java-packages-with-maven.md b/content/actions/tutorials/publish-packages/publish-java-packages-with-maven.md
index 82deb7892b9b..c33fc3889b9a 100644
--- a/content/actions/tutorials/publish-packages/publish-java-packages-with-maven.md
+++ b/content/actions/tutorials/publish-packages/publish-java-packages-with-maven.md
@@ -14,6 +14,8 @@ versions:
ghes: '*'
ghec: '*'
type: tutorial
+category:
+ - Build and test code
---
## Introduction
diff --git a/content/actions/tutorials/publish-packages/publish-nodejs-packages.md b/content/actions/tutorials/publish-packages/publish-nodejs-packages.md
index 26921e9a8e0c..0c499f380347 100644
--- a/content/actions/tutorials/publish-packages/publish-nodejs-packages.md
+++ b/content/actions/tutorials/publish-packages/publish-nodejs-packages.md
@@ -15,6 +15,8 @@ versions:
ghes: '*'
ghec: '*'
type: tutorial
+category:
+ - Build and test code
---
## Introduction
diff --git a/content/actions/tutorials/store-and-share-data.md b/content/actions/tutorials/store-and-share-data.md
index d2da93f7a23a..822276ac8e68 100644
--- a/content/actions/tutorials/store-and-share-data.md
+++ b/content/actions/tutorials/store-and-share-data.md
@@ -19,6 +19,8 @@ versions:
ghec: '*'
type: tutorial
allowTitleToDifferFromFilename: true
+category:
+ - Write workflows
---
## Prerequisites
diff --git a/content/actions/tutorials/use-actions-runner-controller/authenticate-to-the-api.md b/content/actions/tutorials/use-actions-runner-controller/authenticate-to-the-api.md
index 65614c396e8e..574e2899d133 100644
--- a/content/actions/tutorials/use-actions-runner-controller/authenticate-to-the-api.md
+++ b/content/actions/tutorials/use-actions-runner-controller/authenticate-to-the-api.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/authenticating-to-the-github-api
- /actions/how-tos/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/authenticating-to-the-github-api#deploying-using-personal-access-token-classic-authentication
- /actions/tutorials/actions-runner-controller/authenticating-arc-to-the-github-api
+category:
+ - Use and manage runners
---
You can authenticate {% data variables.product.prodname_actions_runner_controller %} (ARC) to the {% data variables.product.prodname_dotcom %} API by using a {% data variables.product.prodname_github_app %} or by using a {% data variables.product.pat_v1 %}.
diff --git a/content/actions/tutorials/use-actions-runner-controller/deploy-runner-scale-sets.md b/content/actions/tutorials/use-actions-runner-controller/deploy-runner-scale-sets.md
index 39ae463b7990..2a247be21b0b 100644
--- a/content/actions/tutorials/use-actions-runner-controller/deploy-runner-scale-sets.md
+++ b/content/actions/tutorials/use-actions-runner-controller/deploy-runner-scale-sets.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller
- /actions/how-tos/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller
- /actions/tutorials/actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller
+category:
+ - Set up runners
---
## Deploying a runner scale set
diff --git a/content/actions/tutorials/use-actions-runner-controller/index.md b/content/actions/tutorials/use-actions-runner-controller/index.md
index cabacb213e9c..0137ac1f8171 100644
--- a/content/actions/tutorials/use-actions-runner-controller/index.md
+++ b/content/actions/tutorials/use-actions-runner-controller/index.md
@@ -5,10 +5,21 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
+layout: journey-landing
+journeyTracks:
+ - id: 'set_up_arc'
+ title: 'Set up Actions Runner Controller'
+ description: 'Install and configure Actions Runner Controller to run self-hosted runners at scale.'
+ guides:
+ - href: '/actions/tutorials/use-actions-runner-controller/quickstart'
+ - href: '/actions/tutorials/use-actions-runner-controller/deploy-runner-scale-sets'
+ - href: '/actions/tutorials/use-actions-runner-controller/authenticate-to-the-api'
+ - href: '/actions/tutorials/use-actions-runner-controller/use-arc-in-a-workflow'
+ - href: '/actions/tutorials/use-actions-runner-controller/troubleshoot'
children:
- /quickstart
- - /authenticate-to-the-api
- /deploy-runner-scale-sets
+ - /authenticate-to-the-api
- /use-arc-in-a-workflow
- /troubleshoot
redirect_from:
diff --git a/content/actions/tutorials/use-actions-runner-controller/quickstart.md b/content/actions/tutorials/use-actions-runner-controller/quickstart.md
index f5c577d843ef..87a7db552241 100644
--- a/content/actions/tutorials/use-actions-runner-controller/quickstart.md
+++ b/content/actions/tutorials/use-actions-runner-controller/quickstart.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/quickstart-for-actions-runner-controller
- /actions/tutorials/quickstart-for-actions-runner-controller
- /actions/tutorials/actions-runner-controller/quickstart-for-actions-runner-controller
+category:
+ - Set up runners
---
## Prerequisites
diff --git a/content/actions/tutorials/use-actions-runner-controller/troubleshoot.md b/content/actions/tutorials/use-actions-runner-controller/troubleshoot.md
index 31289ec3fb24..5b16dc9ff3d3 100644
--- a/content/actions/tutorials/use-actions-runner-controller/troubleshoot.md
+++ b/content/actions/tutorials/use-actions-runner-controller/troubleshoot.md
@@ -11,6 +11,8 @@ redirect_from:
- /actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/troubleshooting-actions-runner-controller-errors
- /actions/how-tos/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/troubleshooting-actions-runner-controller-errors
- /actions/tutorials/actions-runner-controller/troubleshooting-actions-runner-controller-errors
+category:
+ - Use and manage runners
---
## Logging
diff --git a/content/actions/tutorials/use-actions-runner-controller/use-arc-in-a-workflow.md b/content/actions/tutorials/use-actions-runner-controller/use-arc-in-a-workflow.md
index 376df5c9ad57..37c39acfee7b 100644
--- a/content/actions/tutorials/use-actions-runner-controller/use-arc-in-a-workflow.md
+++ b/content/actions/tutorials/use-actions-runner-controller/use-arc-in-a-workflow.md
@@ -12,6 +12,8 @@ redirect_from:
- /actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/using-actions-runner-controller-runners-in-a-workflow
- /actions/how-tos/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/using-actions-runner-controller-runners-in-a-workflow
- /actions/tutorials/actions-runner-controller/using-actions-runner-controller-runners-in-a-workflow
+category:
+ - Use and manage runners
---
## Using ARC runners in a workflow file
diff --git a/content/actions/tutorials/use-containerized-services/create-a-docker-container-action.md b/content/actions/tutorials/use-containerized-services/create-a-docker-container-action.md
index ad491e867c39..9c2f333e0af3 100644
--- a/content/actions/tutorials/use-containerized-services/create-a-docker-container-action.md
+++ b/content/actions/tutorials/use-containerized-services/create-a-docker-container-action.md
@@ -16,6 +16,8 @@ versions:
ghes: '*'
ghec: '*'
type: tutorial
+category:
+ - Build and test code
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/use-containerized-services/create-postgresql-service-containers.md b/content/actions/tutorials/use-containerized-services/create-postgresql-service-containers.md
index b23076bedec8..a9fefb709fee 100644
--- a/content/actions/tutorials/use-containerized-services/create-postgresql-service-containers.md
+++ b/content/actions/tutorials/use-containerized-services/create-postgresql-service-containers.md
@@ -15,6 +15,8 @@ versions:
ghes: '*'
ghec: '*'
type: tutorial
+category:
+ - Build and test code
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/use-containerized-services/create-redis-service-containers.md b/content/actions/tutorials/use-containerized-services/create-redis-service-containers.md
index 9202729f507d..02ea2664be86 100644
--- a/content/actions/tutorials/use-containerized-services/create-redis-service-containers.md
+++ b/content/actions/tutorials/use-containerized-services/create-redis-service-containers.md
@@ -15,6 +15,8 @@ versions:
ghes: '*'
ghec: '*'
type: tutorial
+category:
+ - Build and test code
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/actions/tutorials/use-containerized-services/use-docker-service-containers.md b/content/actions/tutorials/use-containerized-services/use-docker-service-containers.md
index 0b0596eb4597..b842110a33e9 100644
--- a/content/actions/tutorials/use-containerized-services/use-docker-service-containers.md
+++ b/content/actions/tutorials/use-containerized-services/use-docker-service-containers.md
@@ -16,6 +16,8 @@ versions:
ghes: '*'
ghec: '*'
type: overview
+category:
+ - Build and test code
---
## Communicating with Docker service containers
From bd17b2c2dc7253687257b2fd76b542699a7f8ca4 Mon Sep 17 00:00:00 2001
From: Sarah Schneider
Date: Thu, 12 Mar 2026 15:28:38 -0400
Subject: [PATCH 5/8] Convert 'type' frontmatter to 'contentType' (#60173)
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
---
content/README.md | 10 ++--
.../concepts/security/openid-connect.md | 2 +-
.../workflows-and-actions/concurrency.md | 4 +-
.../workflows-and-actions/contexts.md | 4 +-
.../workflows-and-actions/custom-actions.md | 4 +-
.../dependency-caching.md | 4 +-
.../deployment-environments.md | 4 +-
.../workflows-and-actions/expressions.md | 4 +-
.../workflows-and-actions/variables.md | 4 +-
.../workflow-artifacts.md | 4 +-
.../workflows-and-actions/workflows.md | 4 +-
.../actions/get-started/actions-vs-apps.md | 4 +-
.../get-started/continuous-deployment.md | 4 +-
.../get-started/continuous-integration.md | 4 +-
content/actions/get-started/quickstart.md | 4 +-
.../get-started/understand-github-actions.md | 4 +-
.../administer/reuse-namespaces-on-ghecom.md | 4 +-
.../manage-custom-actions.md | 4 +-
.../control-deployments.md | 2 +-
.../google-kubernetes-engine.md | 2 +-
content/actions/how-tos/get-support.md | 4 +-
.../connect-with-oidc.md | 2 +-
.../connect-with-wireguard.md | 2 +-
.../customize-runners.md | 2 +-
.../larger-runners/control-access.md | 4 +-
.../create-workflow-templates.md | 2 +-
.../share-with-your-enterprise.md | 2 +-
.../oidc-in-aws.md | 2 +-
.../oidc-in-azure.md | 2 +-
.../oidc-in-cloud-providers.md | 2 +-
.../oidc-in-google-cloud-platform.md | 2 +-
.../oidc-in-hashicorp-vault.md | 2 +-
.../oidc-in-jfrog.md | 2 +-
.../oidc-in-octopus-deploy.md | 4 +-
.../oidc-in-pypi.md | 2 +-
.../oidc-with-reusable-workflows.md | 2 +-
.../find-and-customize-actions.md | 2 +-
.../use-github-cli.md | 4 +-
.../trigger-a-workflow.md | 4 +-
.../write-workflows/use-workflow-templates.md | 2 +-
.../custom-transformers.md | 2 +-
.../supplemental-arguments-and-settings.md | 2 +-
.../reference/runners/self-hosted-runners.md | 2 +-
.../dependency-caching.md | 2 +-
.../dockerfile-support.md | 4 +-
.../workflows-and-actions/metadata-syntax.md | 2 +-
.../create-a-composite-action.md | 4 +-
.../create-a-javascript-action.md | 4 +-
.../tutorials/create-an-example-workflow.md | 4 +-
.../add-comments-with-labels.md | 4 +-
.../manage-your-work/add-labels-to-issues.md | 4 +-
.../manage-your-work/close-inactive-issues.md | 4 +-
.../schedule-issue-creation.md | 4 +-
.../azure-devops-migration.md | 4 +-
.../automated-migrations/bamboo-migration.md | 4 +-
.../bitbucket-pipelines-migration.md | 4 +-
.../circleci-migration.md | 4 +-
.../automated-migrations/gitlab-migration.md | 4 +-
.../automated-migrations/jenkins-migration.md | 4 +-
.../travis-ci-migration.md | 4 +-
.../use-github-actions-importer.md | 4 +-
.../migrate-from-azure-pipelines.md | 2 +-
.../migrate-from-circleci.md | 4 +-
.../migrate-from-gitlab-cicd.md | 2 +-
.../manual-migrations/migrate-from-jenkins.md | 2 +-
.../migrate-from-travis-ci.md | 2 +-
.../publish-packages/publish-docker-images.md | 4 +-
.../publish-java-packages-with-gradle.md | 4 +-
.../publish-java-packages-with-maven.md | 4 +-
.../publish-nodejs-packages.md | 4 +-
.../actions/tutorials/store-and-share-data.md | 2 +-
.../authenticate-to-the-api.md | 4 +-
.../deploy-runner-scale-sets.md | 4 +-
.../quickstart.md | 4 +-
.../troubleshoot.md | 4 +-
.../use-arc-in-a-workflow.md | 4 +-
.../create-a-docker-container-action.md | 4 +-
.../create-postgresql-service-containers.md | 2 +-
.../create-redis-service-containers.md | 2 +-
.../use-docker-service-containers.md | 4 +-
.../accessing-the-administrative-shell-ssh.md | 2 +-
...ring-your-instance-using-the-github-cli.md | 4 +-
.../command-line-utilities.md | 2 +-
.../index.md | 4 +-
.../about-the-management-console.md | 2 +-
.../accessing-the-management-console.md | 4 +-
.../index.md | 4 +-
...naging-access-to-the-management-console.md | 4 +-
...naging-search-indices-for-your-instance.md | 2 +-
...ooting-access-to-the-management-console.md | 4 +-
...nabling-and-scheduling-maintenance-mode.md | 4 +-
.../configuring-maintenance-mode/index.md | 4 +-
.../administering-your-instance/index.md | 5 +-
...up-service-for-github-enterprise-server.md | 4 +-
...ackup-from-replica-in-high-availability.md | 4 +-
.../backup-in-clustering-mode.md | 4 +-
.../backup-service-settings-reference.md | 4 +-
...configuring-remote-archives-for-backups.md | 4 +-
.../configuring-the-backup-service.md | 6 +--
.../creating-and-monitoring-backups.md | 4 +-
.../restoring-from-a-backup.md | 4 +-
.../restoring-with-github-actions-enabled.md | 4 +-
...derstanding-the-snapshot-file-structure.md | 4 +-
.../configuring-backups-on-your-instance.md | 4 +-
.../automations-in-your-enterprise.md | 4 +-
...e-ecosystem-support-for-your-enterprise.md | 6 +--
.../enabling-github-packages-with-aws.md | 4 +-
...github-packages-with-azure-blob-storage.md | 4 +-
.../enabling-github-packages-with-minio.md | 4 +-
...ith-github-packages-for-your-enterprise.md | 6 +--
.../about-github-connect.md | 2 +-
...c-user-license-sync-for-your-enterprise.md | 4 +-
...enabling-dependabot-for-your-enterprise.md | 6 +--
.../enabling-github-connect-for-githubcom.md | 4 +-
...ified-contributions-for-your-enterprise.md | 6 +--
...ling-unified-search-for-your-enterprise.md | 6 +--
.../configuring-github-connect/index.md | 4 +-
...changing-the-hostname-for-your-instance.md | 4 +-
...onfiguring-an-outbound-web-proxy-server.md | 6 +--
.../configuring-built-in-firewall-rules.md | 4 +-
.../configuring-dns-nameservers.md | 2 +-
...figuring-the-hostname-for-your-instance.md | 4 +-
...dress-using-the-virtual-machine-console.md | 4 +-
.../configuring-time-synchronization.md | 2 +-
.../network-ports.md | 4 +-
...-enterprise-server-with-a-load-balancer.md | 4 +-
.../validating-your-domain-settings.md | 4 +-
...ithub-hosted-runners-in-your-enterprise.md | 6 +--
...ted-compute-products-in-your-enterprise.md | 4 +-
...ithub-hosted-runners-in-your-enterprise.md | 4 +-
...ithub-hosted-runners-in-your-enterprise.md | 4 +-
.../configuring-applications.md | 4 +-
.../configuring-email-for-notifications.md | 4 +-
...guring-github-pages-for-your-enterprise.md | 4 +-
.../configuring-interactive-maps.md | 6 +--
.../configuring-rate-limits.md | 6 +--
.../configuring-web-commit-signing.md | 6 +--
...isabling-persistent-commit-verification.md | 6 +--
...aging-github-mobile-for-your-enterprise.md | 6 +--
...-approving-a-domain-for-your-enterprise.md | 4 +-
...configuring-host-keys-for-your-instance.md | 4 +-
...guring-ssh-connections-to-your-instance.md | 4 +-
...the-referrer-policy-for-your-enterprise.md | 4 +-
.../configuring-tls-and-ssh-ciphers.md | 4 +-
.../configuring-tls.md | 4 +-
.../enabling-private-mode.md | 4 +-
.../enabling-subdomain-isolation.md | 4 +-
...o-your-enterprise-with-an-ip-allow-list.md | 2 +-
.../troubleshooting-tls-errors.md | 4 +-
.../control-offboarding.md | 8 ++--
.../enforcing-policies-for-code-governance.md | 6 +--
...curity-and-analysis-for-your-enterprise.md | 6 +--
...s-for-github-actions-in-your-enterprise.md | 6 +--
...or-github-codespaces-in-your-enterprise.md | 6 +--
...s-for-github-copilot-in-your-enterprise.md | 6 +--
...-for-github-sponsors-in-your-enterprise.md | 4 +-
...olicies-for-projects-in-your-enterprise.md | 4 +-
...or-security-settings-in-your-enterprise.md | 4 +-
...-management-policies-in-your-enterprise.md | 4 +-
...email-notifications-for-your-enterprise.md | 2 +-
.../about-pre-receive-hooks.md | 2 +-
...creating-a-pre-receive-hook-environment.md | 4 +-
.../creating-a-pre-receive-hook-script.md | 2 +-
...ging-pre-receive-hooks-on-your-instance.md | 4 +-
.../index.md | 6 +--
...talling-github-enterprise-server-on-aws.md | 4 +-
...lling-github-enterprise-server-on-azure.md | 4 +-
...erprise-server-on-google-cloud-platform.md | 4 +-
...ing-github-enterprise-server-on-hyper-v.md | 4 +-
...thub-enterprise-server-on-openstack-kvm.md | 4 +-
...ling-github-enterprise-server-on-vmware.md | 4 +-
.../setting-up-a-staging-instance.md | 4 +-
.../configuring-custom-footers.md | 4 +-
...izing-user-messages-for-your-enterprise.md | 4 +-
...adding-organizations-to-your-enterprise.md | 4 +-
...-visibility-for-organization-membership.md | 2 +-
.../managing-projects-using-jira.md | 4 +-
.../managing-requests-for-copilot-business.md | 2 +-
...n-organization-owned-by-your-enterprise.md | 2 +-
...nting-users-from-creating-organizations.md | 2 +-
...ving-organizations-from-your-enterprise.md | 4 +-
...ctor-authentication-for-an-organization.md | 4 +-
.../restoring-a-deleted-organization.md | 8 ++--
...r-owned-repositories-in-your-enterprise.md | 6 +--
...-large-file-storage-for-your-enterprise.md | 2 +-
...bling-git-ssh-access-on-your-enterprise.md | 2 +-
...ple-use-repositories-in-your-enterprise.md | 4 +-
.../locking-a-repository.md | 4 +-
...r-owned-repositories-in-your-enterprise.md | 6 +--
.../assign-roles.md | 2 +-
.../create-custom-roles.md | 2 +-
...-usernames-for-github-enterprise-server.md | 2 +-
.../auditing-ssh-keys.md | 2 +-
.../auditing-users-across-your-enterprise.md | 4 +-
.../best-practices-for-user-security.md | 4 +-
.../create-enterprise-teams.md | 4 +-
.../deleting-users-from-your-instance.md | 4 +-
.../impersonating-a-user.md | 4 +-
.../invite-users-directly.md | 8 ++--
...viting-people-to-manage-your-enterprise.md | 6 +--
.../managing-dormant-users.md | 4 +-
...to-organizations-within-your-enterprise.md | 4 +-
...-a-legal-hold-on-a-user-or-organization.md | 2 +-
...moting-or-demoting-a-site-administrator.md | 4 +-
.../rebuilding-contributions-data.md | 2 +-
.../removing-a-member-from-your-enterprise.md | 2 +-
.../suspending-and-unsuspending-users.md | 4 +-
...d-security-features-for-your-enterprise.md | 8 ++--
...rise-server-with-github-actions-enabled.md | 4 +-
.../high-availability-for-github-actions.md | 4 +-
...ting-github-actions-for-your-enterprise.md | 6 +--
.../using-a-staging-environment.md | 4 +-
...g-github-actions-with-amazon-s3-storage.md | 6 +--
...-github-actions-with-azure-blob-storage.md | 6 +--
...ithub-actions-with-google-cloud-storage.md | 6 +--
...bling-github-actions-with-minio-storage.md | 6 +--
.../about-github-actions-for-enterprises.md | 2 +-
...hub-actions-for-github-enterprise-cloud.md | 6 +--
...ub-actions-for-github-enterprise-server.md | 6 +--
...self-hosted-runners-for-your-enterprise.md | 6 +--
...ucing-github-actions-to-your-enterprise.md | 4 +-
...ating-your-enterprise-to-github-actions.md | 4 +-
.../about-using-actions-in-your-enterprise.md | 2 +-
...-githubcom-actions-using-github-connect.md | 6 +--
...manually-syncing-actions-from-githubcom.md | 4 +-
...-hosted-runners-without-internet-access.md | 4 +-
...version-of-the-official-bundled-actions.md | 4 +-
...-github-app-managers-in-your-enterprise.md | 3 +-
...reating-github-apps-for-your-enterprise.md | 3 +-
...le-sign-on-for-enterprise-managed-users.md | 4 +-
...ovisioning-for-enterprise-managed-users.md | 6 +--
.../saml-configuration-reference.md | 4 +-
...siderations-for-external-authentication.md | 4 +-
...f-your-identity-provider-is-unavailable.md | 4 +-
...-accounts-single-sign-on-recovery-codes.md | 4 +-
...tication-and-provisioning-with-entra-id.md | 4 +-
...tion-and-provisioning-with-pingfederate.md | 4 +-
...configuring-scim-provisioning-with-okta.md | 4 +-
.../deprovisioning-and-reinstating-users.md | 6 +--
...mberships-with-identity-provider-groups.md | 4 +-
.../migrating-from-ldap-to-saml-with-scim.md | 10 ++--
...and-groups-with-scim-using-the-rest-api.md | 4 +-
...embership-with-identity-provider-groups.md | 4 +-
.../user-provisioning-with-scim-on-ghes.md | 8 ++--
.../respond-to-incidents/lock-down-sso.md | 8 ++--
.../revoke-authorizations-or-tokens.md | 8 ++--
...d-restrictions-of-managed-user-accounts.md | 4 +-
.../about-saml-for-enterprise-iam.md | 4 +-
...ication-for-users-outside-your-provider.md | 4 +-
.../changing-authentication-methods.md | 4 +-
...g-started-with-enterprise-managed-users.md | 6 +--
...d-access-management-for-your-enterprise.md | 2 +-
.../configuring-built-in-authentication.md | 6 +--
.../disabling-passkeys-for-your-instance.md | 2 +-
.../disabling-unauthenticated-sign-ups.md | 6 +--
.../inviting-people-to-use-your-instance.md | 6 +--
.../using-cas-for-enterprise-iam/using-cas.md | 4 +-
.../using-ldap.md | 4 +-
...-sign-on-for-your-enterprise-using-okta.md | 4 +-
...saml-single-sign-on-for-your-enterprise.md | 4 +-
...r-your-enterprise-or-your-organizations.md | 4 +-
...saml-single-sign-on-for-your-enterprise.md | 2 +-
.../enabling-encrypted-assertions.md | 4 +-
...on-for-organizations-in-your-enterprise.md | 4 +-
...n-organization-to-an-enterprise-account.md | 2 +-
.../troubleshooting-saml-authentication.md | 4 +-
.../updating-a-users-saml-nameid.md | 4 +-
.../changing-the-url-for-your-enterprise.md | 4 +-
.../creating-a-readme-for-an-enterprise.md | 4 +-
.../creating-an-enterprise-account.md | 4 +-
.../deleting-an-enterprise-account.md | 4 +-
.../log-forwarding.md | 2 +-
.../managing-global-webhooks.md | 2 +-
.../viewing-push-logs.md | 2 +-
...ssing-the-audit-log-for-your-enterprise.md | 4 +-
.../audit-log-events-for-your-enterprise.md | 4 +-
...uring-the-audit-log-for-your-enterprise.md | 2 +-
...es-in-the-audit-log-for-your-enterprise.md | 2 +-
...-audit-log-activity-for-your-enterprise.md | 2 +-
...ching-the-audit-log-for-your-enterprise.md | 4 +-
...aming-the-audit-log-for-your-enterprise.md | 4 +-
...g-the-audit-log-api-for-your-enterprise.md | 4 +-
.../configuring-additional-nodes.md | 2 +-
.../about-repository-caching.md | 2 +-
.../configuring-a-repository-cache.md | 4 +-
.../about-cluster-nodes.md | 4 +-
.../about-clustering.md | 4 +-
.../cluster-network-configuration.md | 4 +-
...-availability-replication-for-a-cluster.md | 4 +-
.../deferring-database-seeding.md | 2 +-
...een-clustering-and-high-availability-ha.md | 4 +-
.../initializing-the-cluster.md | 4 +-
...ting-a-failover-to-your-replica-cluster.md | 4 +-
...ter-nodes-with-node-eligibility-service.md | 6 +--
.../monitoring-the-health-of-your-cluster.md | 4 +-
.../rebalancing-cluster-workloads.md | 6 +--
.../replacing-a-cluster-node.md | 4 +-
.../upgrading-a-cluster.md | 4 +-
.../about-geo-replication.md | 4 +-
.../about-high-availability-configuration.md | 4 +-
.../creating-a-high-availability-replica.md | 4 +-
...ng-a-failover-to-your-replica-appliance.md | 4 +-
...oring-a-high-availability-configuration.md | 6 +--
...ering-a-high-availability-configuration.md | 4 +-
.../removing-a-high-availability-replica.md | 4 +-
.../about-system-logs.md | 4 +-
.../about-the-monitor-dashboards.md | 6 +--
.../about-collectd-metrics.md | 2 +-
...td-metrics-for-github-enterprise-server.md | 4 +-
...porting-and-scraping-prometheus-metrics.md | 4 +-
...ng-up-external-monitoring-with-collectd.md | 4 +-
...ting-a-health-check-for-your-enterprise.md | 4 +-
.../monitoring-using-snmp.md | 2 +-
.../about-opentelemetry-metrics.md | 4 +-
.../advanced-dashboards.md | 4 +-
...iguring-opentelemetry-for-your-instance.md | 4 +-
...-external-monitoring-with-opentelemetry.md | 4 +-
...rafana-to-analyze-opentelemetry-metrics.md | 3 +-
.../recommended-alert-thresholds.md | 4 +-
...leshooting-resource-allocation-problems.md | 2 +-
.../configuring-multiple-data-disks.md | 4 +-
.../changing-your-platform.md | 4 +-
.../increasing-cpu-or-memory-resources.md | 4 +-
.../increasing-storage-capacity.md | 4 +-
.../using-generation-2-virtual-machines.md | 4 +-
.../overview/about-github-enterprise-cloud.md | 4 +-
.../about-github-enterprise-server.md | 4 +-
.../overview/about-github-for-enterprises.md | 4 +-
.../about-upgrades-to-new-releases.md | 4 +-
...-compliance-reports-for-your-enterprise.md | 4 +-
...overnance-framework-for-your-enterprise.md | 4 +-
content/admin/overview/system-overview.md | 4 +-
...ng-from-github-enterprise-1110x-to-2123.md | 4 +-
...preparing-for-the-elasticsearch-upgrade.md | 6 +--
.../upgrading-with-a-hotpatch.md | 24 +++++-----
.../upgrading-with-an-upgrade-package.md | 24 +++++-----
.../enabling-automatic-update-checks.md | 4 +-
.../overview-of-the-upgrade-process.md | 48 +++++++++----------
.../preparing-to-upgrade/taking-a-snapshot.md | 24 +++++-----
.../upgrade-requirements.md | 4 +-
...n-issues-with-upgrades-to-your-instance.md | 4 +-
.../restoring-from-a-failed-upgrade.md | 24 +++++-----
content/apps/overview.md | 4 +-
.../managing-your-passkeys.md | 4 +-
.../signing-in-with-a-passkey.md | 4 +-
...g-and-managing-your-active-sso-sessions.md | 2 +-
.../switching-between-accounts.md | 4 +-
.../viewing-and-managing-your-sessions.md | 3 +-
.../risk-report-csv-contents.md | 1 -
.../about-codespaces/codespaces-features.md | 4 +-
.../codespaces/about-codespaces/deep-dive.md | 8 ++--
.../understanding-the-codespace-lifecycle.md | 4 +-
.../about-codespaces/what-are-codespaces.md | 8 ++--
...ing-the-machine-type-for-your-codespace.md | 4 +-
.../changing-the-shell-in-a-codespace.md | 2 +-
.../renaming-a-codespace.md | 4 +-
.../connecting-to-a-private-network.md | 4 +-
.../creating-a-codespace-for-a-repository.md | 2 +-
.../creating-a-codespace-from-a-template.md | 4 +-
...nvironment-variables-for-your-codespace.md | 2 +-
.../deleting-a-codespace.md | 2 +-
.../developing-in-a-codespace.md | 4 +-
.../forwarding-ports-in-your-codespace.md | 2 +-
...-github-codespaces-for-machine-learning.md | 4 +-
.../opening-an-existing-codespace.md | 2 +-
...vironment-variables-and-temporary-files.md | 2 +-
...rebuilding-the-container-in-a-codespace.md | 4 +-
.../stopping-and-starting-a-codespace.md | 2 +-
...ing-github-codespaces-for-pull-requests.md | 4 +-
...github-codespaces-in-visual-studio-code.md | 4 +-
...using-github-codespaces-with-github-cli.md | 4 +-
.../using-source-control-in-your-codespace.md | 2 +-
.../working-collaboratively-in-a-codespace.md | 4 +-
...ays-for-codespaces-in-your-organization.md | 10 ++--
...github-codespaces-for-your-organization.md | 8 ++--
...ing-the-codespaces-in-your-organization.md | 4 +-
...-github-codespaces-in-your-organization.md | 6 +--
.../restricting-access-to-machine-types.md | 4 +-
...stricting-the-base-image-for-codespaces.md | 4 +-
.../restricting-the-idle-timeout-period.md | 4 +-
...ion-billed-codespaces-a-user-can-create.md | 6 +--
...ing-the-retention-period-for-codespaces.md | 4 +-
...cting-the-visibility-of-forwarded-ports.md | 4 +-
...ations-audit-logs-for-github-codespaces.md | 4 +-
...-gpg-verification-for-github-codespaces.md | 4 +-
...-specific-secrets-for-github-codespaces.md | 4 +-
...a-prebuild-to-access-other-repositories.md | 4 +-
.../configuring-prebuilds.md | 2 +-
.../managing-prebuilds.md | 4 +-
.../testing-dev-container-changes.md | 4 +-
.../security-in-github-codespaces.md | 4 +-
...ing-github-copilot-in-github-codespaces.md | 4 +-
...e-vs-code-command-palette-in-codespaces.md | 4 +-
.../introduction-to-dev-containers.md | 4 +-
...g-up-your-dotnet-project-for-codespaces.md | 4 +-
...ing-up-your-java-project-for-codespaces.md | 4 +-
...g-up-your-nodejs-project-for-codespaces.md | 4 +-
...ting-up-your-php-project-for-codespaces.md | 4 +-
...g-up-your-python-project-for-codespaces.md | 4 +-
.../adding-features-to-a-devcontainer-file.md | 4 +-
...iles-in-the-codespaces-for-a-repository.md | 4 +-
...um-specification-for-codespace-machines.md | 4 +-
...ng-recommended-secrets-for-a-repository.md | 2 +-
...k-creation-and-resumption-of-codespaces.md | 4 +-
...mplate-repository-for-github-codespaces.md | 4 +-
.../choosing-the-stable-or-beta-host-image.md | 4 +-
...g-automatic-deletion-of-your-codespaces.md | 4 +-
...zing-github-codespaces-for-your-account.md | 4 +-
...ur-default-editor-for-github-codespaces.md | 2 +-
...ur-default-region-for-github-codespaces.md | 4 +-
...ur-timeout-period-for-github-codespaces.md | 4 +-
.../the-githubdev-web-based-editor.md | 4 +-
.../exporting-changes-to-a-branch.md | 2 +-
.../troubleshooting/github-codespaces-logs.md | 4 +-
...shooting-authentication-to-a-repository.md | 4 +-
...ing-creation-and-deletion-of-codespaces.md | 4 +-
...oubleshooting-github-codespaces-clients.md | 4 +-
...-gpg-verification-for-github-codespaces.md | 2 +-
.../troubleshooting-included-usage.md | 4 +-
...shooting-personalization-for-codespaces.md | 2 +-
...g-port-forwarding-for-github-codespaces.md | 2 +-
.../troubleshooting-prebuilds.md | 2 +-
...ng-your-connection-to-github-codespaces.md | 4 +-
...king-with-support-for-github-codespaces.md | 4 +-
.../writing-for-github-docs/templates.md | 12 ++---
.../copilot-usage-metrics.md | 2 +-
.../roll-out-at-scale/measure-success.md | 2 +-
.../about-github-classroom.md | 4 +-
.../about-assignments.md | 4 +-
.../using-github-classroom-with-github-cli.md | 6 +--
.../about-enterprise-billing.md | 4 +-
...ut-migrating-to-github-enterprise-cloud.md | 3 +-
...setting-up-a-trial-of-github-enterprise.md | 4 +-
.../about-github-actions-for-enterprises.md | 2 +-
.../actions-components.md | 3 +-
...hub-actions-for-github-enterprise-cloud.md | 4 +-
...ating-your-enterprise-to-github-actions.md | 4 +-
.../planning-a-rollout-of-github-actions.md | 5 +-
.../automations-in-your-enterprise.md | 4 +-
.../github-apps/create-enterprise-apps.md | 4 +-
.../github-apps/index.md | 7 +--
.../github-apps/install-enterprise-apps.md | 4 +-
.../about-enterprise-policies.md | 4 +-
.../about-enterprise-security.md | 3 +-
.../create-custom-properties.md | 4 +-
.../create-repository-policies.md | 4 +-
.../govern-people-and-repositories/index.md | 4 +-
.../protect-branches.md | 4 +-
...using-the-audit-log-for-your-enterprise.md | 3 +-
.../about-roles-in-an-enterprise.md | 4 +-
.../about-teams-in-an-enterprise.md | 4 +-
.../assigning-roles-to-teams-and-users.md | 4 +-
.../best-practices.md | 3 +-
.../creating-custom-roles.md | 4 +-
.../creating-teams.md | 4 +-
.../identify-role-requirements.md | 4 +-
.../setting-up-an-organization.md | 4 +-
.../managing-support-entitlements.md | 6 +--
.../understanding-support.md | 6 +--
.../using-the-support-portal.md | 6 +--
.../about-github-and-git.md | 4 +-
.../downloading-files-from-github.md | 4 +-
.../start-your-journey/hello-world.md | 4 +-
.../setting-up-your-profile.md | 2 +-
.../uploading-a-project-to-github.md | 4 +-
content/get-started/using-git/about-git.md | 4 +-
.../github-cli/github-cli/about-github-cli.md | 2 +-
.../github-cli/github-cli-reference.md | 4 +-
content/github-cli/github-cli/quickstart.md | 4 +-
content/github-models/quickstart.md | 4 +-
.../responsible-use-of-github-models.md | 4 +-
...nfiguring-automation-for-project-boards.md | 6 +--
.../creating-a-project-board.md | 4 +-
.../adding-items-automatically.md | 4 +-
.../archiving-items-automatically.md | 2 +-
.../automating-projects-using-actions.md | 6 +--
.../using-the-api-to-manage-projects.md | 4 +-
.../using-the-built-in-automations.md | 2 +-
.../copying-an-existing-project.md | 4 +-
.../creating-projects/creating-a-project.md | 4 +-
.../migrating-from-projects-classic.md | 6 +--
.../changing-the-layout-of-a-view.md | 4 +-
.../customizing-the-board-layout.md | 2 +-
.../customizing-the-roadmap-layout.md | 2 +-
.../customizing-the-table-layout.md | 4 +-
.../filtering-projects.md | 4 +-
.../managing-your-views.md | 4 +-
.../finding-your-projects.md | 6 +--
.../learning-about-projects/about-projects.md | 4 +-
.../best-practices-for-projects.md | 4 +-
.../quickstart-for-projects.md | 6 +--
.../adding-items-to-your-project.md | 6 +--
.../archiving-items-from-your-project.md | 6 +--
.../converting-draft-issues-to-issues.md | 2 +-
.../editing-items-in-your-project.md | 6 +--
.../adding-your-project-to-a-repository.md | 8 ++--
.../adding-your-project-to-a-team.md | 6 +--
.../closing-and-deleting-your-projects.md | 8 ++--
.../exporting-your-projects-data.md | 10 ++--
.../managing-access-to-your-projects.md | 8 ++--
...-project-templates-in-your-organization.md | 10 ++--
.../managing-visibility-of-your-projects.md | 10 ++--
.../sharing-project-updates.md | 6 +--
.../understanding-fields/about-date-fields.md | 2 +-
.../about-issue-fields.md | 2 +-
.../about-iteration-fields.md | 2 +-
...ent-issue-and-sub-issue-progress-fields.md | 4 +-
.../about-pull-request-fields.md | 4 +-
.../about-single-select-fields.md | 4 +-
.../about-text-and-number-fields.md | 2 +-
.../about-the-issue-type-field.md | 4 +-
.../deleting-custom-fields.md | 4 +-
.../renaming-custom-fields.md | 4 +-
.../about-insights-for-projects.md | 4 +-
.../configuring-charts.md | 2 +-
.../creating-charts.md | 2 +-
...-tracking-work-for-your-team-or-project.md | 4 +-
.../learning-about-issues/quickstart.md | 4 +-
.../adding-and-managing-issue-fields.md | 2 +-
.../using-issues/adding-sub-issues.md | 8 ++--
.../using-issues/browsing-sub-issues.md | 6 +--
.../using-issues/creating-an-issue.md | 6 +--
.../creating-issue-dependencies.md | 12 ++---
.../using-issues/editing-an-issue.md | 6 +--
...-and-searching-issues-and-pull-requests.md | 4 +-
...aging-issue-fields-in-your-organization.md | 2 +-
...managing-issue-types-in-an-organization.md | 8 ++--
...ng-all-of-your-issues-and-pull-requests.md | 4 +-
...milestones-for-issues-and-pull-requests.md | 2 +-
.../managing-labels.md | 4 +-
...l-systems-with-the-administrative-shell.md | 4 +-
...programmatically-importing-repositories.md | 4 +-
.../using-ghe-migrator/about-ghe-migrator.md | 4 +-
...tion-data-from-github-enterprise-server.md | 4 +-
...exporting-migration-data-from-githubcom.md | 4 +-
...rating-data-to-github-enterprise-server.md | 4 +-
...ompliance-reports-for-your-organization.md | 4 +-
...-in-the-audit-log-for-your-organization.md | 2 +-
...ail-notifications-for-your-organization.md | 4 +-
...hub-hosted-runners-in-your-organization.md | 4 +-
...d-compute-products-in-your-organization.md | 4 +-
...hub-hosted-runners-in-your-organization.md | 4 +-
...nouncement-banner-for-your-organization.md | 2 +-
...e-use-repositories-in-your-organization.md | 4 +-
...hub-hosted-runners-in-your-organization.md | 4 +-
...pproving-a-domain-for-your-organization.md | 4 +-
content/pages/quickstart.md | 4 +-
...ng-dependency-changes-in-a-pull-request.md | 4 +-
.../quickstart-for-repositories.md | 4 +-
.../viewing-all-your-repositories.md | 4 +-
...ithub-actions-settings-for-a-repository.md | 4 +-
...d-analysis-settings-for-your-repository.md | 4 +-
...ipting-with-the-rest-api-and-javascript.md | 2 +-
.../scripting-with-the-rest-api-and-ruby.md | 2 +-
.../about-github-sponsors.md | 2 +-
.../navigating-your-sponsors-dashboard.md | 4 +-
...art-for-finding-contributors-to-sponsor.md | 2 +-
...ks-for-events-in-your-sponsored-account.md | 2 +-
...g-started-with-the-sponsors-graphql-api.md | 4 +-
...b-sponsors-for-open-source-contributors.md | 4 +-
.../contacting-your-sponsors.md | 2 +-
.../disabling-your-github-sponsors-account.md | 4 +-
...our-profile-details-for-github-sponsors.md | 2 +-
.../enabling-sponsorships-through-patreon.md | 4 +-
...aging-your-payouts-from-github-sponsors.md | 4 +-
.../managing-your-sponsorship-goal.md | 2 +-
.../managing-your-sponsorship-tiers.md | 4 +-
...p-github-sponsors-for-your-organization.md | 6 +--
...thub-sponsors-for-your-personal-account.md | 4 +-
.../tax-information-for-github-sponsors.md | 4 +-
...count-from-your-github-sponsors-profile.md | 4 +-
...publishing-your-github-sponsors-profile.md | 4 +-
...host-to-receive-github-sponsors-payouts.md | 4 +-
.../viewing-your-sponsors-and-sponsorships.md | 2 +-
.../about-sponsorships-fees-and-taxes.md | 2 +-
...uting-sponsorships-to-your-organization.md | 2 +-
.../managing-your-sponsorship.md | 2 +-
.../paying-for-github-sponsors-by-invoice.md | 4 +-
...-open-source-contributor-through-github.md | 4 +-
...open-source-contributor-through-patreon.md | 4 +-
...inking-your-patreon-account-from-github.md | 4 +-
.../about-copilot-in-github-support.md | 2 +-
data/ui.yml | 8 ++--
src/app/lib/main-context-adapter.ts | 2 -
.../linting-rules/rai-app-card-structure.ts | 3 +-
.../lib/linting-rules/rai-reusable-usage.ts | 5 +-
.../tests/unit/rai-app-card-structure.ts | 7 ---
.../tests/unit/rai-resuable-usage.ts | 4 +-
.../scripts/add-content-type.ts | 32 +++----------
.../actions/category/subcategory/article.md | 2 +-
.../audit-log-events-for-your-enterprise.md | 2 +-
.../codeql-cli-manual/database-analyze.md | 2 +-
.../code-security/getting-started/index.md | 2 +-
.../getting-started/quickstart.md | 2 +-
.../securing-your-organization.md | 2 +-
.../supported-secret-scanning-patterns.md | 2 +-
.../get-started/empty-categories/only-ghec.md | 2 +-
.../get-started/foo/anchor-autotitling.md | 2 +-
.../content/get-started/foo/autotitling.md | 2 +-
.../get-started/foo/cross-version-linking.md | 2 +-
.../get-started/foo/typo-autotitling.md | 2 +-
.../get-started/images/images-in-lists.md | 2 +-
.../get-started/images/link-to-image.md | 2 +-
.../get-started/images/retina-image.md | 2 +-
.../get-started/images/single-image.md | 2 +-
.../content/get-started/liquid/danger.md | 2 +-
.../content/get-started/liquid/data.md | 2 +-
.../content/get-started/liquid/ifversion.md | 2 +-
.../get-started/liquid/links-with-liquid.md | 2 +-
.../content/get-started/liquid/notes.md | 2 +-
.../get-started/liquid/platform-specific.md | 2 +-
.../content/get-started/liquid/raw.md | 2 +-
.../get-started/liquid/table-row-headers.md | 2 +-
.../content/get-started/liquid/tips.md | 2 +-
.../get-started/liquid/tool-picker-issue.md | 2 +-
.../liquid/tool-platform-switcher.md | 2 +-
.../get-started/liquid/tool-specific.md | 2 +-
.../content/get-started/liquid/warnings.md | 2 +-
.../content/get-started/liquid/whitespace.md | 2 +-
.../content/get-started/markdown/alerts.md | 2 +-
.../get-started/markdown/code-annotations.md | 2 +-
.../get-started/markdown/html-comments.md | 2 +-
.../content/get-started/markdown/intro.md | 2 +-
.../get-started/markdown/permissions.md | 2 +-
.../get-started/minitocs/markup-heading.md | 2 +-
.../get-started/minitocs/multiple-headings.md | 2 +-
.../get-started/minitocs/no-heading.md | 2 +-
.../get-started/minitocs/one-heading.md | 2 +-
.../api-article-body-test-page.md | 2 +-
.../start-your-journey/dynamic-title.md | 2 +-
.../start-your-journey/hello-world.md | 2 +-
.../start-your-journey/link-rewriting.md | 2 +-
.../get-started/versioning/only-fpt.md | 2 +-
.../versioning/only-ghec-and-ghes.md | 2 +-
.../get-started/versioning/only-ghec.md | 2 +-
.../fixtures/content/pages/quickstart.md | 2 +-
src/fixtures/fixtures/data/ui.yml | 8 ++--
src/frame/components/DefaultLayout.tsx | 1 -
src/frame/components/context/MainContext.tsx | 2 -
src/frame/lib/frontmatter.ts | 15 +-----
src/frame/lib/page.ts | 13 +++--
src/landings/components/ArticleCards.tsx | 2 +-
.../components/ProductGuidesContext.tsx | 8 ++--
.../components/guides/LearningTrack.tsx | 4 +-
src/types/types.ts | 3 --
src/workflows/fm-utils.ts | 8 ++--
src/workflows/unallowed-contributions.ts | 2 +-
647 files changed, 1301 insertions(+), 1353 deletions(-)
diff --git a/content/README.md b/content/README.md
index 8a308e132625..32d51d0bc330 100644
--- a/content/README.md
+++ b/content/README.md
@@ -26,7 +26,7 @@ See the [contributing docs](https://docs.github.com/en/contributing) for general
- [`learningTracks`](#learningtracks)
- [`includeGuides`](#includeguides)
- [`journeyTracks`](#journeytracks)
- - [`type`](#type)
+ - [`contentType`](#contenttype)
- [`communityRedirect`](#communityRedirect)
- [`effectiveDate`](#effectiveDate)
- [Escaping single quotes](#escaping-single-quotes)
@@ -238,7 +238,7 @@ defaultTool: cli
**Note: the featured track is set by a specific property in the learning tracks YAML. See that [README](../data/learning-tracks/README.md) for details.*
### `includeGuides`
-- Purpose: Render a list of articles, filterable by `type` and `topics`. Only applicable when used with `layout: product-guides`.
+- Purpose: Render a list of articles, filterable by `contentType` and `topics`. Only applicable when used with `layout: product-guides`.
- Type: `Array`
- Optional.
@@ -284,9 +284,9 @@ journeyTracks:
- href: '/actions/deployment/deploying-with-github-actions'
```
-### `type`
+### `contentType`
- Purpose: Indicate the type of article.
-- Type: `String`, one of the `overview`, `quick_start`, `tutorial`, `how_to`, `reference`.
+- Type: `String`, one of `get-started`, `concepts`, `how-tos`, `reference`, `tutorials`, `rai`, `landing` (only applies to `content//index.md` files).
- Optional.
### `communityRedirect`
@@ -442,4 +442,4 @@ To create a product guides page (e.g. [Actions' Guide page](https://docs.github.
1. (optional) Define which articles to include with [`includeGuides`](#includeGuides).
If using learning tracks, they need to be defined in [`data/learning-tracks/*.yml`](../data/learning-tracks/README.md).
-If using `includeGuides`, make sure each of the articles in this list has [`type`](#type) in its frontmatter.
+If using `includeGuides`, make sure each of the articles in this list has [`contentType`](#contenttype) in its frontmatter.
diff --git a/content/actions/concepts/security/openid-connect.md b/content/actions/concepts/security/openid-connect.md
index 006209a28132..146f4e8f2713 100644
--- a/content/actions/concepts/security/openid-connect.md
+++ b/content/actions/concepts/security/openid-connect.md
@@ -5,11 +5,11 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
redirect_from:
- /actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect
- /actions/security-for-github-actions/security-hardening-your-deployments/about-security-hardening-with-openid-connect
- /actions/concepts/security/about-security-hardening-with-openid-connect
+contentType: tutorials
category:
- Secure your workflows
---
diff --git a/content/actions/concepts/workflows-and-actions/concurrency.md b/content/actions/concepts/workflows-and-actions/concurrency.md
index 5a1fbc2cd375..7e7f8cf19767 100644
--- a/content/actions/concepts/workflows-and-actions/concurrency.md
+++ b/content/actions/concepts/workflows-and-actions/concurrency.md
@@ -1,11 +1,11 @@
---
title: Concurrency
-intro: 'Learn about running workflows and jobs simultaneously.'
+intro: Learn about running workflows and jobs simultaneously.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
+contentType: concepts
category:
- Write workflows
---
diff --git a/content/actions/concepts/workflows-and-actions/contexts.md b/content/actions/concepts/workflows-and-actions/contexts.md
index 153fe92c0218..564c0c239025 100644
--- a/content/actions/concepts/workflows-and-actions/contexts.md
+++ b/content/actions/concepts/workflows-and-actions/contexts.md
@@ -1,11 +1,11 @@
---
title: Contexts
-intro: 'Learn about contexts in {% data variables.product.prodname_actions %}.'
+intro: Learn about contexts in {% data variables.product.prodname_actions %}.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
+contentType: concepts
category:
- Write workflows
---
diff --git a/content/actions/concepts/workflows-and-actions/custom-actions.md b/content/actions/concepts/workflows-and-actions/custom-actions.md
index 6a0fb6228af0..6ff2f93b0dbe 100644
--- a/content/actions/concepts/workflows-and-actions/custom-actions.md
+++ b/content/actions/concepts/workflows-and-actions/custom-actions.md
@@ -1,7 +1,7 @@
---
title: About custom actions
shortTitle: Custom actions
-intro: 'Actions are individual tasks that you can combine to create jobs and customize your workflow. You can create your own actions, or use and customize actions shared by the {% data variables.product.prodname_dotcom %} community.'
+intro: Actions are individual tasks that you can combine to create jobs and customize your workflow. You can create your own actions, or use and customize actions shared by the {% data variables.product.prodname_dotcom %} community.
redirect_from:
- /articles/about-actions
- /github/automating-your-workflow-with-github-actions/about-actions
@@ -15,7 +15,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
+contentType: concepts
category:
- Reuse and share automations
---
diff --git a/content/actions/concepts/workflows-and-actions/dependency-caching.md b/content/actions/concepts/workflows-and-actions/dependency-caching.md
index 19222e3d6af7..5c98bcdec79d 100644
--- a/content/actions/concepts/workflows-and-actions/dependency-caching.md
+++ b/content/actions/concepts/workflows-and-actions/dependency-caching.md
@@ -1,11 +1,11 @@
---
title: Dependency caching
-intro: 'Learn about dependency caching for workflow speed and efficiency.'
+intro: Learn about dependency caching for workflow speed and efficiency.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
+contentType: concepts
category:
- Write workflows
---
diff --git a/content/actions/concepts/workflows-and-actions/deployment-environments.md b/content/actions/concepts/workflows-and-actions/deployment-environments.md
index 058446027c5f..e68041a960f2 100644
--- a/content/actions/concepts/workflows-and-actions/deployment-environments.md
+++ b/content/actions/concepts/workflows-and-actions/deployment-environments.md
@@ -1,11 +1,11 @@
---
title: Deployment environments
-intro: 'You can create and deploy to different environments.'
+intro: You can create and deploy to different environments.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
+contentType: concepts
category:
- Deploy to environments
---
diff --git a/content/actions/concepts/workflows-and-actions/expressions.md b/content/actions/concepts/workflows-and-actions/expressions.md
index 8ca999d61a76..d7a1fe9b6f02 100644
--- a/content/actions/concepts/workflows-and-actions/expressions.md
+++ b/content/actions/concepts/workflows-and-actions/expressions.md
@@ -1,11 +1,11 @@
---
title: Expressions
-intro: 'You can evaluate expressions in workflows and actions.'
+intro: You can evaluate expressions in workflows and actions.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
+contentType: concepts
category:
- Write workflows
---
diff --git a/content/actions/concepts/workflows-and-actions/variables.md b/content/actions/concepts/workflows-and-actions/variables.md
index 1aad17f729f0..57eec8ab176c 100644
--- a/content/actions/concepts/workflows-and-actions/variables.md
+++ b/content/actions/concepts/workflows-and-actions/variables.md
@@ -1,11 +1,11 @@
---
title: Variables
-intro: 'Learn about variables in {% data variables.product.prodname_actions %} workflows.'
+intro: Learn about variables in {% data variables.product.prodname_actions %} workflows.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
+contentType: concepts
category:
- Write workflows
---
diff --git a/content/actions/concepts/workflows-and-actions/workflow-artifacts.md b/content/actions/concepts/workflows-and-actions/workflow-artifacts.md
index a820b0254baa..d093e4dd8215 100644
--- a/content/actions/concepts/workflows-and-actions/workflow-artifacts.md
+++ b/content/actions/concepts/workflows-and-actions/workflow-artifacts.md
@@ -1,11 +1,11 @@
---
title: Workflow artifacts
-intro: 'Learn about storing and sharing data as artifacts of {% data variables.product.prodname_actions %} workflows.'
+intro: Learn about storing and sharing data as artifacts of {% data variables.product.prodname_actions %} workflows.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
+contentType: concepts
category:
- Write workflows
---
diff --git a/content/actions/concepts/workflows-and-actions/workflows.md b/content/actions/concepts/workflows-and-actions/workflows.md
index fd2bbda0a951..11782395e9a1 100644
--- a/content/actions/concepts/workflows-and-actions/workflows.md
+++ b/content/actions/concepts/workflows-and-actions/workflows.md
@@ -1,11 +1,10 @@
---
title: Workflows
-intro: 'Get a high-level overview of {% data variables.product.prodname_actions %} workflows, including triggers, syntax, and advanced features.'
+intro: Get a high-level overview of {% data variables.product.prodname_actions %} workflows, including triggers, syntax, and advanced features.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
redirect_from:
- /articles/configuring-workflows
- /actions/learn-github-actions/managing-complex-workflows
@@ -15,6 +14,7 @@ redirect_from:
- /actions/concepts/use-cases/using-github-actions-for-project-management
- /actions/concepts/workflows-and-actions/about-workflows
layout: inline
+contentType: concepts
category:
- Write workflows
---
diff --git a/content/actions/get-started/actions-vs-apps.md b/content/actions/get-started/actions-vs-apps.md
index dd3c3c84969c..c84ad92c3a9d 100644
--- a/content/actions/get-started/actions-vs-apps.md
+++ b/content/actions/get-started/actions-vs-apps.md
@@ -1,15 +1,15 @@
---
title: GitHub Actions vs GitHub Apps
shortTitle: Actions vs Apps
-intro: 'Learn about the key differences between {% data variables.product.prodname_actions %} and {% data variables.product.prodname_github_apps %} to help you decide which is right for your use cases.'
+intro: Learn about the key differences between {% data variables.product.prodname_actions %} and {% data variables.product.prodname_github_apps %} to help you decide which is right for your use cases.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
redirect_from:
- /actions/concepts/overview/github-actions-vs-github-apps
- /actions/get-started/github-actions-vs-github-apps
+contentType: concepts
category:
- Get started with GitHub Actions
---
diff --git a/content/actions/get-started/continuous-deployment.md b/content/actions/get-started/continuous-deployment.md
index 9d63e91781f6..9f656cd98150 100644
--- a/content/actions/get-started/continuous-deployment.md
+++ b/content/actions/get-started/continuous-deployment.md
@@ -1,11 +1,10 @@
---
title: Continuous deployment
-intro: 'You can create custom continuous deployment (CD) workflows directly in your {% data variables.product.prodname_dotcom %} repository with {% data variables.product.prodname_actions %}.'
+intro: You can create custom continuous deployment (CD) workflows directly in your {% data variables.product.prodname_dotcom %} repository with {% data variables.product.prodname_actions %}.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
redirect_from:
- /actions/deployment/about-continuous-deployment
- /actions/deployment/about-deployments/about-continuous-deployment
@@ -14,6 +13,7 @@ redirect_from:
- /actions/about-github-actions/about-continuous-deployment-with-github-actions
- /actions/concepts/overview/about-continuous-deployment-with-github-actions
- /actions/concepts/overview/continuous-deployment
+contentType: concepts
category:
- Get started with GitHub Actions
---
diff --git a/content/actions/get-started/continuous-integration.md b/content/actions/get-started/continuous-integration.md
index bec70d2bcb87..559c6a1093b6 100644
--- a/content/actions/get-started/continuous-integration.md
+++ b/content/actions/get-started/continuous-integration.md
@@ -1,6 +1,6 @@
---
title: Continuous integration
-intro: 'You can create custom continuous integration (CI) workflows directly in your {% data variables.product.prodname_dotcom %} repository with {% data variables.product.prodname_actions %}.'
+intro: You can create custom continuous integration (CI) workflows directly in your {% data variables.product.prodname_dotcom %} repository with {% data variables.product.prodname_actions %}.
redirect_from:
- /articles/about-continuous-integration
- /github/automating-your-workflow-with-github-actions/about-continuous-integration
@@ -16,7 +16,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
+contentType: concepts
category:
- Get started with GitHub Actions
---
diff --git a/content/actions/get-started/quickstart.md b/content/actions/get-started/quickstart.md
index 7e69d217b197..256b8dfe6a0a 100644
--- a/content/actions/get-started/quickstart.md
+++ b/content/actions/get-started/quickstart.md
@@ -1,6 +1,6 @@
---
title: Quickstart for GitHub Actions
-intro: 'Try out the core features of {% data variables.product.prodname_actions %} in minutes.'
+intro: Try out the core features of {% data variables.product.prodname_actions %} in minutes.
allowTitleToDifferFromFilename: true
redirect_from:
- /actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates
@@ -11,8 +11,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: quick_start
shortTitle: Quickstart
+contentType: get-started
category:
- Get started with GitHub Actions
---
diff --git a/content/actions/get-started/understand-github-actions.md b/content/actions/get-started/understand-github-actions.md
index c85c7566e094..89d7dd40caf8 100644
--- a/content/actions/get-started/understand-github-actions.md
+++ b/content/actions/get-started/understand-github-actions.md
@@ -1,7 +1,7 @@
---
title: Understanding GitHub Actions
shortTitle: Understand GitHub Actions
-intro: 'Learn the basics of core concepts and essential terminology in {% data variables.product.prodname_actions %}.'
+intro: Learn the basics of core concepts and essential terminology in {% data variables.product.prodname_actions %}.
redirect_from:
- /github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions
- /actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions
@@ -16,7 +16,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
+contentType: concepts
category:
- Get started with GitHub Actions
---
diff --git a/content/actions/how-tos/administer/reuse-namespaces-on-ghecom.md b/content/actions/how-tos/administer/reuse-namespaces-on-ghecom.md
index 187b2c4aed47..93e0c25c51e7 100644
--- a/content/actions/how-tos/administer/reuse-namespaces-on-ghecom.md
+++ b/content/actions/how-tos/administer/reuse-namespaces-on-ghecom.md
@@ -1,14 +1,14 @@
---
title: Making retired namespaces available on GHE.com
shortTitle: Reuse namespaces on GHE.com
-intro: 'Allow people to use namespaces that match actions you have used from {% data variables.product.prodname_dotcom_the_website %}.'
+intro: Allow people to use namespaces that match actions you have used from {% data variables.product.prodname_dotcom_the_website %}.
versions:
ghec: '*'
-type: how_to
permissions: Enterprise owners
redirect_from:
- /actions/administering-github-actions/making-retired-namespaces-available-on-ghecom
- /actions/how-tos/administering-github-actions/making-retired-namespaces-available-on-ghecom
+contentType: how-tos
category:
- Administer GitHub Actions
---
diff --git a/content/actions/how-tos/create-and-publish-actions/manage-custom-actions.md b/content/actions/how-tos/create-and-publish-actions/manage-custom-actions.md
index fffa28877ecb..5887de267b4d 100644
--- a/content/actions/how-tos/create-and-publish-actions/manage-custom-actions.md
+++ b/content/actions/how-tos/create-and-publish-actions/manage-custom-actions.md
@@ -1,15 +1,15 @@
---
title: Managing custom actions
shortTitle: Manage custom actions
-intro: 'Learn how to create and manage your own actions, and customize actions shared by the {% data variables.product.prodname_dotcom %} community.'
+intro: Learn how to create and manage your own actions, and customize actions shared by the {% data variables.product.prodname_dotcom %} community.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
redirect_from:
- /actions/how-tos/administering-github-actions/managing-custom-actions
- /actions/how-tos/creating-and-publishing-actions/managing-custom-actions
+contentType: concepts
category:
- Reuse and share automations
---
diff --git a/content/actions/how-tos/deploy/configure-and-manage-deployments/control-deployments.md b/content/actions/how-tos/deploy/configure-and-manage-deployments/control-deployments.md
index 786002457bcc..890877cdc516 100644
--- a/content/actions/how-tos/deploy/configure-and-manage-deployments/control-deployments.md
+++ b/content/actions/how-tos/deploy/configure-and-manage-deployments/control-deployments.md
@@ -6,13 +6,13 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
redirect_from:
- /actions/deployment/deploying-with-github-actions
- /actions/deployment/about-deployments/deploying-with-github-actions
- /actions/use-cases-and-examples/deploying/deploying-with-github-actions
- /actions/concepts/use-cases/deploying-with-github-actions
- /actions/tutorials/deploying-with-github-actions
+contentType: concepts
category:
- Deploy to environments
---
diff --git a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/google-kubernetes-engine.md b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/google-kubernetes-engine.md
index 85b3b6b4c966..5d0c9828dc8a 100644
--- a/content/actions/how-tos/deploy/deploy-to-third-party-platforms/google-kubernetes-engine.md
+++ b/content/actions/how-tos/deploy/deploy-to-third-party-platforms/google-kubernetes-engine.md
@@ -13,7 +13,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
category:
- Deploy to environments
---
diff --git a/content/actions/how-tos/get-support.md b/content/actions/how-tos/get-support.md
index bc67e5dd776c..236626068ed7 100644
--- a/content/actions/how-tos/get-support.md
+++ b/content/actions/how-tos/get-support.md
@@ -1,17 +1,17 @@
---
title: Getting help from GitHub Support about GitHub Actions
shortTitle: Get support
-intro: 'Learn how {% data variables.contact.github_support %} can assist with {% data variables.product.prodname_actions %}'
+intro: Learn how {% data variables.contact.github_support %} can assist with {% data variables.product.prodname_actions %}
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: reference
redirect_from:
- /actions/monitoring-and-troubleshooting-workflows/working-with-support-for-github-actions
- /actions/monitoring-and-troubleshooting-workflows/troubleshooting-workflows/working-with-support-for-github-actions
- /actions/how-tos/monitoring-and-troubleshooting-workflows/troubleshooting-workflows/working-with-support-for-github-actions
- /actions/how-tos/getting-help-from-github-support-about-github-actions
+contentType: reference
category:
- Administer GitHub Actions
---
diff --git a/content/actions/how-tos/manage-runners/github-hosted-runners/connect-to-a-private-network/connect-with-oidc.md b/content/actions/how-tos/manage-runners/github-hosted-runners/connect-to-a-private-network/connect-with-oidc.md
index 29b9dcaa8b52..0546796a9c94 100644
--- a/content/actions/how-tos/manage-runners/github-hosted-runners/connect-to-a-private-network/connect-with-oidc.md
+++ b/content/actions/how-tos/manage-runners/github-hosted-runners/connect-to-a-private-network/connect-with-oidc.md
@@ -6,11 +6,11 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
redirect_from:
- /actions/using-github-hosted-runners/using-github-hosted-runners/using-an-api-gateway-with-oidc
- /actions/using-github-hosted-runners/connecting-to-a-private-network/using-an-api-gateway-with-oidc
- /actions/how-tos/using-github-hosted-runners/connecting-to-a-private-network/using-an-api-gateway-with-oidc
+contentType: how-tos
category:
- Use and manage runners
---
diff --git a/content/actions/how-tos/manage-runners/github-hosted-runners/connect-to-a-private-network/connect-with-wireguard.md b/content/actions/how-tos/manage-runners/github-hosted-runners/connect-to-a-private-network/connect-with-wireguard.md
index c7bb1910e9a9..2a629405a1f1 100644
--- a/content/actions/how-tos/manage-runners/github-hosted-runners/connect-to-a-private-network/connect-with-wireguard.md
+++ b/content/actions/how-tos/manage-runners/github-hosted-runners/connect-to-a-private-network/connect-with-wireguard.md
@@ -6,11 +6,11 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
redirect_from:
- /actions/using-github-hosted-runners/using-github-hosted-runners/using-wireguard-to-create-a-network-overlay
- /actions/using-github-hosted-runners/connecting-to-a-private-network/using-wireguard-to-create-a-network-overlay
- /actions/how-tos/using-github-hosted-runners/connecting-to-a-private-network/using-wireguard-to-create-a-network-overlay
+contentType: how-tos
category:
- Use and manage runners
---
diff --git a/content/actions/how-tos/manage-runners/github-hosted-runners/customize-runners.md b/content/actions/how-tos/manage-runners/github-hosted-runners/customize-runners.md
index c27249bd3bc3..603a4c8ded5f 100644
--- a/content/actions/how-tos/manage-runners/github-hosted-runners/customize-runners.md
+++ b/content/actions/how-tos/manage-runners/github-hosted-runners/customize-runners.md
@@ -5,7 +5,6 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
shortTitle: Customize runners
redirect_from:
- /actions/using-github-hosted-runners/customizing-github-hosted-runners
@@ -13,6 +12,7 @@ redirect_from:
- /actions/using-github-hosted-runners/using-github-hosted-runners/customizing-github-hosted-runners
- /actions/how-tos/using-github-hosted-runners/using-github-hosted-runners/customizing-github-hosted-runners
- /actions/how-tos/using-github-hosted-runners/customizing-github-hosted-runners
+contentType: tutorials
category:
- Set up runners
---
diff --git a/content/actions/how-tos/manage-runners/larger-runners/control-access.md b/content/actions/how-tos/manage-runners/larger-runners/control-access.md
index b5ebb2948d3b..ffc435f67d89 100644
--- a/content/actions/how-tos/manage-runners/larger-runners/control-access.md
+++ b/content/actions/how-tos/manage-runners/larger-runners/control-access.md
@@ -1,17 +1,17 @@
---
title: Controlling access to larger runners
shortTitle: Control access
-intro: 'You can use policies to limit access to {% data variables.actions.hosted_runner %}s that have been added to an organization or enterprise.'
+intro: You can use policies to limit access to {% data variables.actions.hosted_runner %}s that have been added to an organization or enterprise.
permissions: '{% data reusables.actions.larger-runner-permissions %}'
versions:
feature: actions-hosted-runners
-type: tutorial
redirect_from:
- /actions/using-github-hosted-runners/controlling-access-to-larger-runners
- /actions/using-github-hosted-runners/about-larger-runners/controlling-access-to-larger-runners
- /actions/using-github-hosted-runners/using-larger-runners/controlling-access-to-larger-runners
- /actions/how-tos/using-github-hosted-runners/using-larger-runners/controlling-access-to-larger-runners
- /actions/how-tos/using-larger-runners/controlling-access-to-larger-runners
+contentType: tutorials
category:
- Use and manage runners
---
diff --git a/content/actions/how-tos/reuse-automations/create-workflow-templates.md b/content/actions/how-tos/reuse-automations/create-workflow-templates.md
index 831f29a399bd..33c2db1ae621 100644
--- a/content/actions/how-tos/reuse-automations/create-workflow-templates.md
+++ b/content/actions/how-tos/reuse-automations/create-workflow-templates.md
@@ -13,7 +13,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
category:
- Reuse and share automations
---
diff --git a/content/actions/how-tos/reuse-automations/share-with-your-enterprise.md b/content/actions/how-tos/reuse-automations/share-with-your-enterprise.md
index 5fb04cb5e474..234c8b1c19b8 100644
--- a/content/actions/how-tos/reuse-automations/share-with-your-enterprise.md
+++ b/content/actions/how-tos/reuse-automations/share-with-your-enterprise.md
@@ -4,12 +4,12 @@ intro: You can share an action or reusable workflow with your enterprise without
versions:
ghec: '*'
ghes: '*'
-type: tutorial
shortTitle: Share with your enterprise
redirect_from:
- /actions/creating-actions/sharing-actions-and-workflows-with-your-enterprise
- /actions/sharing-automations/sharing-actions-and-workflows-with-your-enterprise
- /actions/how-tos/sharing-automations/sharing-actions-and-workflows-with-your-enterprise
+contentType: tutorials
category:
- Reuse and share automations
---
diff --git a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-aws.md b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-aws.md
index 21af14db1c10..56ed01c90f4a 100644
--- a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-aws.md
+++ b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-aws.md
@@ -6,11 +6,11 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
redirect_from:
- /actions/deployment/security-hardening-your-deployments/configuring-openid-connect-in-amazon-web-services
- /actions/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-amazon-web-services
- /actions/how-tos/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-amazon-web-services
+contentType: tutorials
category:
- Secure your workflows
---
diff --git a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-azure.md b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-azure.md
index 076f8364e54f..c6b7adc8de12 100644
--- a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-azure.md
+++ b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-azure.md
@@ -6,12 +6,12 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
redirect_from:
- /actions/deployment/security-hardening-your-deployments/configuring-openid-connect-in-azure
- /actions/security-for-github-actions/security-guides/security-hardening-your-deployments/configuring-openid-connect-in-azure
- /actions/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-azure
- /actions/how-tos/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-azure
+contentType: tutorials
category:
- Secure your workflows
---
diff --git a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-cloud-providers.md b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-cloud-providers.md
index 04a3836cd282..8bda5767310e 100644
--- a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-cloud-providers.md
+++ b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-cloud-providers.md
@@ -6,11 +6,11 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
redirect_from:
- /actions/deployment/security-hardening-your-deployments/configuring-openid-connect-in-cloud-providers
- /actions/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-cloud-providers
- /actions/how-tos/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-cloud-providers
+contentType: tutorials
category:
- Secure your workflows
---
diff --git a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-google-cloud-platform.md b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-google-cloud-platform.md
index 3b108b86f96a..6558f3af5fe0 100644
--- a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-google-cloud-platform.md
+++ b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-google-cloud-platform.md
@@ -6,11 +6,11 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
redirect_from:
- /actions/deployment/security-hardening-your-deployments/configuring-openid-connect-in-google-cloud-platform
- /actions/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-google-cloud-platform
- /actions/how-tos/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-google-cloud-platform
+contentType: tutorials
category:
- Secure your workflows
---
diff --git a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-hashicorp-vault.md b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-hashicorp-vault.md
index 4a047ffadcaf..863c49842fe2 100644
--- a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-hashicorp-vault.md
+++ b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-hashicorp-vault.md
@@ -6,11 +6,11 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
redirect_from:
- /actions/deployment/security-hardening-your-deployments/configuring-openid-connect-in-hashicorp-vault
- /actions/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-hashicorp-vault
- /actions/how-tos/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-hashicorp-vault
+contentType: tutorials
category:
- Secure your workflows
---
diff --git a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-jfrog.md b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-jfrog.md
index 4e3b414e8812..3cda8932f1e5 100644
--- a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-jfrog.md
+++ b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-jfrog.md
@@ -5,11 +5,11 @@ intro: Use OpenID Connect within your workflows to authenticate with JFrog.
versions:
fpt: '*'
ghec: '*'
-type: tutorial
redirect_from:
- /actions/deployment/security-hardening-your-deployments/configuring-openid-connect-in-jfrog
- /actions/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-jfrog
- /actions/how-tos/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-jfrog
+contentType: tutorials
category:
- Secure your workflows
---
diff --git a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-octopus-deploy.md b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-octopus-deploy.md
index fddda94aedc4..17419078435e 100644
--- a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-octopus-deploy.md
+++ b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-octopus-deploy.md
@@ -5,7 +5,7 @@ intro: Use OpenID Connect within your workflows to authenticate with Octopus Dep
versions:
fpt: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
category:
- Secure your workflows
---
@@ -76,4 +76,4 @@ jobs:
## Further reading
-{% data reusables.actions.oidc-further-reading %}
\ No newline at end of file
+{% data reusables.actions.oidc-further-reading %}
diff --git a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-pypi.md b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-pypi.md
index 64fdd1efa0a4..323bb1d909d2 100644
--- a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-pypi.md
+++ b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-in-pypi.md
@@ -5,11 +5,11 @@ intro: Use OpenID Connect within your workflows to authenticate with PyPI.
versions:
fpt: '*'
ghec: '*'
-type: tutorial
redirect_from:
- /actions/deployment/security-hardening-your-deployments/configuring-openid-connect-in-pypi
- /actions/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-pypi
- /actions/how-tos/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-pypi
+contentType: tutorials
category:
- Secure your workflows
---
diff --git a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-with-reusable-workflows.md b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-with-reusable-workflows.md
index ecfbf10a3488..15c485aeb011 100644
--- a/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-with-reusable-workflows.md
+++ b/content/actions/how-tos/secure-your-work/security-harden-deployments/oidc-with-reusable-workflows.md
@@ -11,7 +11,7 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: how_to
+contentType: how-tos
category:
- Secure your workflows
---
diff --git a/content/actions/how-tos/write-workflows/choose-what-workflows-do/find-and-customize-actions.md b/content/actions/how-tos/write-workflows/choose-what-workflows-do/find-and-customize-actions.md
index f48f4c83e149..5761eb9bbfc9 100644
--- a/content/actions/how-tos/write-workflows/choose-what-workflows-do/find-and-customize-actions.md
+++ b/content/actions/how-tos/write-workflows/choose-what-workflows-do/find-and-customize-actions.md
@@ -15,7 +15,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
category:
- Write workflows
---
diff --git a/content/actions/how-tos/write-workflows/choose-what-workflows-do/use-github-cli.md b/content/actions/how-tos/write-workflows/choose-what-workflows-do/use-github-cli.md
index 4ece29159018..b27b6e0e27e3 100644
--- a/content/actions/how-tos/write-workflows/choose-what-workflows-do/use-github-cli.md
+++ b/content/actions/how-tos/write-workflows/choose-what-workflows-do/use-github-cli.md
@@ -1,7 +1,7 @@
---
title: Using GitHub CLI in workflows
shortTitle: Use GitHub CLI
-intro: 'You can script with {% data variables.product.prodname_cli %} in {% data variables.product.prodname_actions %} workflows.'
+intro: You can script with {% data variables.product.prodname_cli %} in {% data variables.product.prodname_actions %} workflows.
redirect_from:
- /actions/guides/using-github-cli-in-workflows
- /actions/advanced-guides/using-github-cli-in-workflows
@@ -13,7 +13,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
category:
- Write workflows
---
diff --git a/content/actions/how-tos/write-workflows/choose-when-workflows-run/trigger-a-workflow.md b/content/actions/how-tos/write-workflows/choose-when-workflows-run/trigger-a-workflow.md
index 24e434aed80d..9eedf5ad962f 100644
--- a/content/actions/how-tos/write-workflows/choose-when-workflows-run/trigger-a-workflow.md
+++ b/content/actions/how-tos/write-workflows/choose-when-workflows-run/trigger-a-workflow.md
@@ -1,16 +1,16 @@
---
title: Triggering a workflow
shortTitle: Trigger a workflow
-intro: 'How to automatically trigger {% data variables.product.prodname_actions %} workflows'
+intro: How to automatically trigger {% data variables.product.prodname_actions %} workflows
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
redirect_from:
- /actions/using-workflows/triggering-a-workflow
- /actions/writing-workflows/choosing-when-your-workflow-runs/triggering-a-workflow
- /actions/how-tos/writing-workflows/choosing-when-your-workflow-runs/triggering-a-workflow
+contentType: tutorials
category:
- Write workflows
---
diff --git a/content/actions/how-tos/write-workflows/use-workflow-templates.md b/content/actions/how-tos/write-workflows/use-workflow-templates.md
index 2eef6d09b1c9..7931ab382110 100644
--- a/content/actions/how-tos/write-workflows/use-workflow-templates.md
+++ b/content/actions/how-tos/write-workflows/use-workflow-templates.md
@@ -18,7 +18,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
category:
- Write workflows
---
diff --git a/content/actions/reference/github-actions-importer/custom-transformers.md b/content/actions/reference/github-actions-importer/custom-transformers.md
index d97be008c7ac..e938cc3f8fbb 100644
--- a/content/actions/reference/github-actions-importer/custom-transformers.md
+++ b/content/actions/reference/github-actions-importer/custom-transformers.md
@@ -5,13 +5,13 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: how_to
shortTitle: Custom transformers
redirect_from:
- /actions/migrating-to-github-actions/automated-migrations/extending-github-actions-importer-with-custom-transformers
- /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/extending-github-actions-importer-with-custom-transformers
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/extending-github-actions-importer-with-custom-transformers
- /actions/reference/extending-github-actions-importer-with-custom-transformers
+contentType: how-tos
category:
- Migrate to GitHub Actions
---
diff --git a/content/actions/reference/github-actions-importer/supplemental-arguments-and-settings.md b/content/actions/reference/github-actions-importer/supplemental-arguments-and-settings.md
index 7a226e2a0b8d..a0505f656b9d 100644
--- a/content/actions/reference/github-actions-importer/supplemental-arguments-and-settings.md
+++ b/content/actions/reference/github-actions-importer/supplemental-arguments-and-settings.md
@@ -5,11 +5,11 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: reference
redirect_from:
- /actions/migrating-to-github-actions/automated-migrations/supplemental-arguments-and-settings
- /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/supplemental-arguments-and-settings
- /actions/reference/supplemental-arguments-and-settings
+contentType: reference
category:
- Migrate to GitHub Actions
---
diff --git a/content/actions/reference/runners/self-hosted-runners.md b/content/actions/reference/runners/self-hosted-runners.md
index b977f2bda6a6..e518c32973c6 100644
--- a/content/actions/reference/runners/self-hosted-runners.md
+++ b/content/actions/reference/runners/self-hosted-runners.md
@@ -15,7 +15,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
+contentType: concepts
category:
- Set up runners
---
diff --git a/content/actions/reference/workflows-and-actions/dependency-caching.md b/content/actions/reference/workflows-and-actions/dependency-caching.md
index ea188753fd25..e8c5fd3018b0 100644
--- a/content/actions/reference/workflows-and-actions/dependency-caching.md
+++ b/content/actions/reference/workflows-and-actions/dependency-caching.md
@@ -16,7 +16,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
+contentType: concepts
category:
- Write workflows
---
diff --git a/content/actions/reference/workflows-and-actions/dockerfile-support.md b/content/actions/reference/workflows-and-actions/dockerfile-support.md
index 2d7ecbbf8165..512004a77464 100644
--- a/content/actions/reference/workflows-and-actions/dockerfile-support.md
+++ b/content/actions/reference/workflows-and-actions/dockerfile-support.md
@@ -1,7 +1,7 @@
---
title: Dockerfile support for GitHub Actions
shortTitle: Dockerfile support
-intro: 'When creating a `Dockerfile` for a Docker container action, you should be aware of how some Docker instructions interact with GitHub Actions and an action''s metadata file.'
+intro: When creating a `Dockerfile` for a Docker container action, you should be aware of how some Docker instructions interact with GitHub Actions and an action's metadata file.
redirect_from:
- /actions/building-actions/dockerfile-support-for-github-actions
- /actions/creating-actions/dockerfile-support-for-github-actions
@@ -11,7 +11,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: reference
+contentType: reference
category:
- Write workflows
---
diff --git a/content/actions/reference/workflows-and-actions/metadata-syntax.md b/content/actions/reference/workflows-and-actions/metadata-syntax.md
index 6b4123651e77..9c5aa7b478b8 100644
--- a/content/actions/reference/workflows-and-actions/metadata-syntax.md
+++ b/content/actions/reference/workflows-and-actions/metadata-syntax.md
@@ -15,8 +15,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: reference
allowTitleToDifferFromFilename: true
+contentType: reference
category:
- Reuse and share automations
---
diff --git a/content/actions/tutorials/create-actions/create-a-composite-action.md b/content/actions/tutorials/create-actions/create-a-composite-action.md
index 8204aa1cb91a..738f551af1ae 100644
--- a/content/actions/tutorials/create-actions/create-a-composite-action.md
+++ b/content/actions/tutorials/create-actions/create-a-composite-action.md
@@ -1,7 +1,7 @@
---
title: Creating a composite action
shortTitle: Create a composite action
-intro: 'In this tutorial, you''ll learn how to build a composite action.'
+intro: In this tutorial, you'll learn how to build a composite action.
redirect_from:
- /actions/creating-actions/creating-a-composite-run-steps-action
- /actions/creating-actions/creating-a-composite-action
@@ -11,8 +11,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
defaultPlatform: linux
+contentType: tutorials
category:
- Reuse and share automations
---
diff --git a/content/actions/tutorials/create-actions/create-a-javascript-action.md b/content/actions/tutorials/create-actions/create-a-javascript-action.md
index e13d9849f170..6a4fdd9df365 100644
--- a/content/actions/tutorials/create-actions/create-a-javascript-action.md
+++ b/content/actions/tutorials/create-actions/create-a-javascript-action.md
@@ -1,7 +1,7 @@
---
title: Creating a JavaScript action
shortTitle: Create a JavaScript action
-intro: 'In this tutorial, you''ll learn how to build a JavaScript action using the actions toolkit.'
+intro: In this tutorial, you'll learn how to build a JavaScript action using the actions toolkit.
redirect_from:
- /articles/creating-a-javascript-action
- /github/automating-your-workflow-with-github-actions/creating-a-javascript-action
@@ -14,7 +14,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
category:
- Reuse and share automations
---
diff --git a/content/actions/tutorials/create-an-example-workflow.md b/content/actions/tutorials/create-an-example-workflow.md
index d01239bd06c9..e05331f322e1 100644
--- a/content/actions/tutorials/create-an-example-workflow.md
+++ b/content/actions/tutorials/create-an-example-workflow.md
@@ -1,16 +1,16 @@
---
title: Creating an example workflow
-intro: 'In this tutorial, you''ll learn how to create a basic workflow that is triggered by a push event.'
+intro: In this tutorial, you'll learn how to create a basic workflow that is triggered by a push event.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
shortTitle: Create an example workflow
layout: inline
redirect_from:
- /actions/use-cases-and-examples/creating-an-example-workflow
- /actions/tutorials/creating-an-example-workflow
+contentType: tutorials
category:
- Get started with GitHub Actions
---
diff --git a/content/actions/tutorials/manage-your-work/add-comments-with-labels.md b/content/actions/tutorials/manage-your-work/add-comments-with-labels.md
index 2c768ad97585..92a2c82e5d8e 100644
--- a/content/actions/tutorials/manage-your-work/add-comments-with-labels.md
+++ b/content/actions/tutorials/manage-your-work/add-comments-with-labels.md
@@ -1,6 +1,6 @@
---
title: Commenting on an issue when a label is added
-intro: 'You can use {% data variables.product.prodname_actions %} to automatically comment on issues when a specific label is applied.'
+intro: You can use {% data variables.product.prodname_actions %} to automatically comment on issues when a specific label is applied.
redirect_from:
- /actions/guides/commenting-on-an-issue-when-a-label-is-added
- /actions/managing-issues-and-pull-requests/commenting-on-an-issue-when-a-label-is-added
@@ -11,8 +11,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
shortTitle: Add comments with labels
+contentType: tutorials
category:
- Reuse and share automations
---
diff --git a/content/actions/tutorials/manage-your-work/add-labels-to-issues.md b/content/actions/tutorials/manage-your-work/add-labels-to-issues.md
index 98928ce2e1d6..ce13fbaf382d 100644
--- a/content/actions/tutorials/manage-your-work/add-labels-to-issues.md
+++ b/content/actions/tutorials/manage-your-work/add-labels-to-issues.md
@@ -1,7 +1,7 @@
---
title: Adding labels to issues
shortTitle: Add labels to issues
-intro: 'You can use {% data variables.product.prodname_actions %} to automatically label issues.'
+intro: You can use {% data variables.product.prodname_actions %} to automatically label issues.
redirect_from:
- /actions/guides/adding-labels-to-issues
- /actions/managing-issues-and-pull-requests/adding-labels-to-issues
@@ -12,7 +12,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
category:
- Reuse and share automations
---
diff --git a/content/actions/tutorials/manage-your-work/close-inactive-issues.md b/content/actions/tutorials/manage-your-work/close-inactive-issues.md
index 6615527458d8..a77e338b7dee 100644
--- a/content/actions/tutorials/manage-your-work/close-inactive-issues.md
+++ b/content/actions/tutorials/manage-your-work/close-inactive-issues.md
@@ -1,7 +1,7 @@
---
title: Closing inactive issues
shortTitle: Close inactive issues
-intro: 'You can use {% data variables.product.prodname_actions %} to comment on or close issues that have been inactive for a certain period of time.'
+intro: You can use {% data variables.product.prodname_actions %} to comment on or close issues that have been inactive for a certain period of time.
redirect_from:
- /actions/guides/closing-inactive-issues
- /actions/managing-issues-and-pull-requests/closing-inactive-issues
@@ -12,7 +12,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
category:
- Reuse and share automations
---
diff --git a/content/actions/tutorials/manage-your-work/schedule-issue-creation.md b/content/actions/tutorials/manage-your-work/schedule-issue-creation.md
index 320d617c5e66..5e0103b9b0a5 100644
--- a/content/actions/tutorials/manage-your-work/schedule-issue-creation.md
+++ b/content/actions/tutorials/manage-your-work/schedule-issue-creation.md
@@ -1,7 +1,7 @@
---
title: Scheduling issue creation
shortTitle: Schedule issue creation
-intro: 'You can use {% data variables.product.prodname_actions %} to create an issue on a regular basis for things like daily meetings or quarterly reviews.'
+intro: You can use {% data variables.product.prodname_actions %} to create an issue on a regular basis for things like daily meetings or quarterly reviews.
redirect_from:
- /actions/guides/scheduling-issue-creation
- /actions/managing-issues-and-pull-requests/scheduling-issue-creation
@@ -12,7 +12,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
category:
- Reuse and share automations
---
diff --git a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/azure-devops-migration.md b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/azure-devops-migration.md
index a2d8afa60026..0b11dcd9e3a5 100644
--- a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/azure-devops-migration.md
+++ b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/azure-devops-migration.md
@@ -1,17 +1,17 @@
---
title: Migrating from Azure DevOps with GitHub Actions Importer
-intro: 'Learn how to use {% data variables.product.prodname_actions_importer %} to automate the migration of your Azure DevOps pipelines to {% data variables.product.prodname_actions %}.'
+intro: Learn how to use {% data variables.product.prodname_actions_importer %} to automate the migration of your Azure DevOps pipelines to {% data variables.product.prodname_actions %}.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
shortTitle: Azure DevOps migration
redirect_from:
- /actions/migrating-to-github-actions/automated-migrations/migrating-from-azure-devops-with-github-actions-importer
- /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-azure-devops-with-github-actions-importer
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-azure-devops-with-github-actions-importer
- /actions/tutorials/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-azure-devops-with-github-actions-importer
+contentType: tutorials
category:
- Migrate to GitHub Actions
---
diff --git a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/bamboo-migration.md b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/bamboo-migration.md
index 28dc3a1ff51d..494b78e3c603 100644
--- a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/bamboo-migration.md
+++ b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/bamboo-migration.md
@@ -1,17 +1,17 @@
---
title: Migrating from Bamboo with GitHub Actions Importer
-intro: 'Learn how to use {% data variables.product.prodname_actions_importer %} to automate the migration of your Bamboo pipelines to {% data variables.product.prodname_actions %}.'
+intro: Learn how to use {% data variables.product.prodname_actions_importer %} to automate the migration of your Bamboo pipelines to {% data variables.product.prodname_actions %}.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
shortTitle: Bamboo migration
redirect_from:
- /actions/migrating-to-github-actions/automated-migrations/migrating-from-bamboo-with-github-actions-importer
- /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-bamboo-with-github-actions-importer
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-bamboo-with-github-actions-importer
- /actions/tutorials/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-bamboo-with-github-actions-importer
+contentType: tutorials
category:
- Migrate to GitHub Actions
---
diff --git a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/bitbucket-pipelines-migration.md b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/bitbucket-pipelines-migration.md
index ab690af72204..ae70d066e844 100644
--- a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/bitbucket-pipelines-migration.md
+++ b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/bitbucket-pipelines-migration.md
@@ -1,17 +1,17 @@
---
title: Migrating from Bitbucket Pipelines with GitHub Actions Importer
-intro: 'Learn how to use {% data variables.product.prodname_actions_importer %} to automate the migration of your Bitbucket pipelines to {% data variables.product.prodname_actions %}.'
+intro: Learn how to use {% data variables.product.prodname_actions_importer %} to automate the migration of your Bitbucket pipelines to {% data variables.product.prodname_actions %}.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
shortTitle: Bitbucket Pipelines migration
redirect_from:
- /actions/migrating-to-github-actions/automated-migrations/migrating-from-bitbucket-pipelines-with-github-actions-importer
- /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-bitbucket-pipelines-with-github-actions-importer
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-bitbucket-pipelines-with-github-actions-importer
- /actions/tutorials/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-bitbucket-pipelines-with-github-actions-importer
+contentType: tutorials
category:
- Migrate to GitHub Actions
---
diff --git a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/circleci-migration.md b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/circleci-migration.md
index da912a537085..22d68b6d1cb0 100644
--- a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/circleci-migration.md
+++ b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/circleci-migration.md
@@ -1,17 +1,17 @@
---
title: Migrating from CircleCI with GitHub Actions Importer
-intro: 'Learn how to use {% data variables.product.prodname_actions_importer %} to automate the migration of your CircleCI pipelines to {% data variables.product.prodname_actions %}.'
+intro: Learn how to use {% data variables.product.prodname_actions_importer %} to automate the migration of your CircleCI pipelines to {% data variables.product.prodname_actions %}.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
shortTitle: CircleCI migration
redirect_from:
- /actions/migrating-to-github-actions/automated-migrations/migrating-from-circleci-with-github-actions-importer
- /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-circleci-with-github-actions-importer
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-circleci-with-github-actions-importer
- /actions/tutorials/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-circleci-with-github-actions-importer
+contentType: tutorials
category:
- Migrate to GitHub Actions
---
diff --git a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/gitlab-migration.md b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/gitlab-migration.md
index dd520385b44a..575682ae8fa0 100644
--- a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/gitlab-migration.md
+++ b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/gitlab-migration.md
@@ -1,17 +1,17 @@
---
title: Migrating from GitLab with GitHub Actions Importer
-intro: 'Learn how to use {% data variables.product.prodname_actions_importer %} to automate the migration of your GitLab pipelines to {% data variables.product.prodname_actions %}.'
+intro: Learn how to use {% data variables.product.prodname_actions_importer %} to automate the migration of your GitLab pipelines to {% data variables.product.prodname_actions %}.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
shortTitle: GitLab migration
redirect_from:
- /actions/migrating-to-github-actions/automated-migrations/migrating-from-gitlab-with-github-actions-importer
- /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-gitlab-with-github-actions-importer
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-gitlab-with-github-actions-importer
- /actions/tutorials/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-gitlab-with-github-actions-importer
+contentType: tutorials
category:
- Migrate to GitHub Actions
---
diff --git a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/jenkins-migration.md b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/jenkins-migration.md
index 13ff6fb35dab..dd2dcc1e3442 100644
--- a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/jenkins-migration.md
+++ b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/jenkins-migration.md
@@ -1,17 +1,17 @@
---
title: Migrating from Jenkins with GitHub Actions Importer
-intro: 'Learn how to use {% data variables.product.prodname_actions_importer %} to automate the migration of your Jenkins pipelines to {% data variables.product.prodname_actions %}.'
+intro: Learn how to use {% data variables.product.prodname_actions_importer %} to automate the migration of your Jenkins pipelines to {% data variables.product.prodname_actions %}.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
shortTitle: Jenkins migration
redirect_from:
- /actions/migrating-to-github-actions/automated-migrations/migrating-from-jenkins-with-github-actions-importer
- /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-jenkins-with-github-actions-importer
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-jenkins-with-github-actions-importer
- /actions/tutorials/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-jenkins-with-github-actions-importer
+contentType: tutorials
category:
- Migrate to GitHub Actions
---
diff --git a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/travis-ci-migration.md b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/travis-ci-migration.md
index 02b271fc2a66..151aaf26c61f 100644
--- a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/travis-ci-migration.md
+++ b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/travis-ci-migration.md
@@ -1,17 +1,17 @@
---
title: Migrating from Travis CI with GitHub Actions Importer
-intro: 'Learn how to use {% data variables.product.prodname_actions_importer %} to automate the migration of your Travis CI pipelines to {% data variables.product.prodname_actions %}.'
+intro: Learn how to use {% data variables.product.prodname_actions_importer %} to automate the migration of your Travis CI pipelines to {% data variables.product.prodname_actions %}.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
shortTitle: Travis CI migration
redirect_from:
- /actions/migrating-to-github-actions/automated-migrations/migrating-from-travis-ci-with-github-actions-importer
- /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-travis-ci-with-github-actions-importer
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-travis-ci-with-github-actions-importer
- /actions/tutorials/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-travis-ci-with-github-actions-importer
+contentType: tutorials
category:
- Migrate to GitHub Actions
---
diff --git a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/use-github-actions-importer.md b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/use-github-actions-importer.md
index 00d0f99ce337..f5461c96d6be 100644
--- a/content/actions/tutorials/migrate-to-github-actions/automated-migrations/use-github-actions-importer.md
+++ b/content/actions/tutorials/migrate-to-github-actions/automated-migrations/use-github-actions-importer.md
@@ -1,7 +1,7 @@
---
title: Automating migration with GitHub Actions Importer
shortTitle: Use GitHub Actions Importer
-intro: 'Use {% data variables.product.prodname_actions_importer %} to plan and automate your migration to {% data variables.product.prodname_actions %}.'
+intro: Use {% data variables.product.prodname_actions_importer %} to plan and automate your migration to {% data variables.product.prodname_actions %}.
redirect_from:
- /actions/migrating-to-github-actions/automating-migration-with-github-actions-importer
- /actions/migrating-to-github-actions/automated-migrations/automating-migration-with-github-actions-importer
@@ -12,7 +12,7 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: how_to
+contentType: how-tos
category:
- Migrate to GitHub Actions
---
diff --git a/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-azure-pipelines.md b/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-azure-pipelines.md
index 2bae9c4ee0dd..c3961da47296 100644
--- a/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-azure-pipelines.md
+++ b/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-azure-pipelines.md
@@ -12,8 +12,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
shortTitle: Migrate from Azure Pipelines
+contentType: tutorials
category:
- Migrate to GitHub Actions
---
diff --git a/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-circleci.md b/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-circleci.md
index c829ea71a5bb..a5c4ebc72887 100644
--- a/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-circleci.md
+++ b/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-circleci.md
@@ -1,6 +1,6 @@
---
title: Migrating from CircleCI to GitHub Actions
-intro: 'GitHub Actions and CircleCI share several similarities in configuration, which makes migration to GitHub Actions relatively straightforward.'
+intro: GitHub Actions and CircleCI share several similarities in configuration, which makes migration to GitHub Actions relatively straightforward.
redirect_from:
- /actions/learn-github-actions/migrating-from-circleci-to-github-actions
- /actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions
@@ -12,8 +12,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
shortTitle: Migrate from CircleCI
+contentType: tutorials
category:
- Migrate to GitHub Actions
---
diff --git a/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-gitlab-cicd.md b/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-gitlab-cicd.md
index 7747553b58d7..0c9a980ebf8a 100644
--- a/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-gitlab-cicd.md
+++ b/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-gitlab-cicd.md
@@ -12,8 +12,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
shortTitle: Migrate from GitLab CI/CD
+contentType: tutorials
category:
- Migrate to GitHub Actions
---
diff --git a/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-jenkins.md b/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-jenkins.md
index 9503bf520a86..4e93e09ab268 100644
--- a/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-jenkins.md
+++ b/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-jenkins.md
@@ -12,8 +12,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
shortTitle: Migrate from Jenkins
+contentType: tutorials
category:
- Migrate to GitHub Actions
---
diff --git a/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-travis-ci.md b/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-travis-ci.md
index 142c034a508f..6e4d0f4015d3 100644
--- a/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-travis-ci.md
+++ b/content/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-travis-ci.md
@@ -12,8 +12,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
shortTitle: Migrate from Travis CI
+contentType: tutorials
category:
- Migrate to GitHub Actions
---
diff --git a/content/actions/tutorials/publish-packages/publish-docker-images.md b/content/actions/tutorials/publish-packages/publish-docker-images.md
index b6abaeadaa34..ff02b5d14986 100644
--- a/content/actions/tutorials/publish-packages/publish-docker-images.md
+++ b/content/actions/tutorials/publish-packages/publish-docker-images.md
@@ -1,7 +1,7 @@
---
title: Publishing Docker images
shortTitle: Publish Docker images
-intro: 'In this tutorial, you''ll learn how to publish Docker images to a registry, such as Docker Hub or {% data variables.product.prodname_registry %}, as part of your continuous integration (CI) workflow.'
+intro: In this tutorial, you'll learn how to publish Docker images to a registry, such as Docker Hub or {% data variables.product.prodname_registry %}, as part of your continuous integration (CI) workflow.
redirect_from:
- /actions/language-and-framework-guides/publishing-docker-images
- /actions/guides/publishing-docker-images
@@ -13,8 +13,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
layout: inline
+contentType: tutorials
category:
- Build and test code
---
diff --git a/content/actions/tutorials/publish-packages/publish-java-packages-with-gradle.md b/content/actions/tutorials/publish-packages/publish-java-packages-with-gradle.md
index a7066f77037c..cfcc8c584313 100644
--- a/content/actions/tutorials/publish-packages/publish-java-packages-with-gradle.md
+++ b/content/actions/tutorials/publish-packages/publish-java-packages-with-gradle.md
@@ -1,7 +1,7 @@
---
title: Publishing Java packages with Gradle
shortTitle: Publish Java packages with Gradle
-intro: 'In this tutorial, you''ll learn how to use Gradle to publish Java packages to a registry as part of your continuous integration (CI) workflow.'
+intro: In this tutorial, you'll learn how to use Gradle to publish Java packages to a registry as part of your continuous integration (CI) workflow.
redirect_from:
- /actions/language-and-framework-guides/publishing-java-packages-with-gradle
- /actions/guides/publishing-java-packages-with-gradle
@@ -13,7 +13,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
category:
- Build and test code
---
diff --git a/content/actions/tutorials/publish-packages/publish-java-packages-with-maven.md b/content/actions/tutorials/publish-packages/publish-java-packages-with-maven.md
index c33fc3889b9a..e3c4729b6125 100644
--- a/content/actions/tutorials/publish-packages/publish-java-packages-with-maven.md
+++ b/content/actions/tutorials/publish-packages/publish-java-packages-with-maven.md
@@ -1,7 +1,7 @@
---
title: Publishing Java packages with Maven
shortTitle: Publish Java packages with Maven
-intro: 'In this tutorial, you''ll learn how to use Maven to publish Java packages to a registry as part of your continuous integration (CI) workflow.'
+intro: In this tutorial, you'll learn how to use Maven to publish Java packages to a registry as part of your continuous integration (CI) workflow.
redirect_from:
- /actions/language-and-framework-guides/publishing-java-packages-with-maven
- /actions/guides/publishing-java-packages-with-maven
@@ -13,7 +13,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
category:
- Build and test code
---
diff --git a/content/actions/tutorials/publish-packages/publish-nodejs-packages.md b/content/actions/tutorials/publish-packages/publish-nodejs-packages.md
index 0c499f380347..d3cdce81985b 100644
--- a/content/actions/tutorials/publish-packages/publish-nodejs-packages.md
+++ b/content/actions/tutorials/publish-packages/publish-nodejs-packages.md
@@ -1,7 +1,7 @@
---
title: Publishing Node.js packages
shortTitle: Publish Node.js packages
-intro: 'In this tutorial, you''ll learn how to publish Node.js packages to a registry as part of your continuous integration (CI) workflow.'
+intro: In this tutorial, you'll learn how to publish Node.js packages to a registry as part of your continuous integration (CI) workflow.
redirect_from:
- /actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages
- /actions/language-and-framework-guides/publishing-nodejs-packages
@@ -14,7 +14,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
category:
- Build and test code
---
diff --git a/content/actions/tutorials/store-and-share-data.md b/content/actions/tutorials/store-and-share-data.md
index 822276ac8e68..214e9253904b 100644
--- a/content/actions/tutorials/store-and-share-data.md
+++ b/content/actions/tutorials/store-and-share-data.md
@@ -17,8 +17,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
allowTitleToDifferFromFilename: true
+contentType: tutorials
category:
- Write workflows
---
diff --git a/content/actions/tutorials/use-actions-runner-controller/authenticate-to-the-api.md b/content/actions/tutorials/use-actions-runner-controller/authenticate-to-the-api.md
index 574e2899d133..d9f4b385fdd1 100644
--- a/content/actions/tutorials/use-actions-runner-controller/authenticate-to-the-api.md
+++ b/content/actions/tutorials/use-actions-runner-controller/authenticate-to-the-api.md
@@ -1,17 +1,17 @@
---
title: Authenticating ARC to the GitHub API
shortTitle: Authenticate to the API
-intro: 'Learn how to authenticate {% data variables.product.prodname_actions_runner_controller %} to the {% data variables.product.company_short %} API.'
+intro: Learn how to authenticate {% data variables.product.prodname_actions_runner_controller %} to the {% data variables.product.company_short %} API.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: overview
defaultPlatform: linux
redirect_from:
- /actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/authenticating-to-the-github-api
- /actions/how-tos/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/authenticating-to-the-github-api#deploying-using-personal-access-token-classic-authentication
- /actions/tutorials/actions-runner-controller/authenticating-arc-to-the-github-api
+contentType: concepts
category:
- Use and manage runners
---
diff --git a/content/actions/tutorials/use-actions-runner-controller/deploy-runner-scale-sets.md b/content/actions/tutorials/use-actions-runner-controller/deploy-runner-scale-sets.md
index 2a247be21b0b..e1cd716b2753 100644
--- a/content/actions/tutorials/use-actions-runner-controller/deploy-runner-scale-sets.md
+++ b/content/actions/tutorials/use-actions-runner-controller/deploy-runner-scale-sets.md
@@ -1,17 +1,17 @@
---
title: Deploying runner scale sets with Actions Runner Controller
shortTitle: Deploy runner scale sets
-intro: 'Learn how to deploy runner scale sets with {% data variables.product.prodname_actions_runner_controller %}, and use advanced configuration options to tailor {% data variables.product.prodname_actions_runner_controller %} to your needs.'
+intro: Learn how to deploy runner scale sets with {% data variables.product.prodname_actions_runner_controller %}, and use advanced configuration options to tailor {% data variables.product.prodname_actions_runner_controller %} to your needs.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: overview
defaultPlatform: linux
redirect_from:
- /actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller
- /actions/how-tos/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller
- /actions/tutorials/actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller
+contentType: concepts
category:
- Set up runners
---
diff --git a/content/actions/tutorials/use-actions-runner-controller/quickstart.md b/content/actions/tutorials/use-actions-runner-controller/quickstart.md
index 87a7db552241..cde56265148a 100644
--- a/content/actions/tutorials/use-actions-runner-controller/quickstart.md
+++ b/content/actions/tutorials/use-actions-runner-controller/quickstart.md
@@ -1,17 +1,17 @@
---
title: Quickstart for Actions Runner Controller
shortTitle: Quickstart
-intro: 'In this tutorial, you''ll try out the basics of {% data variables.product.prodname_actions_runner_controller %}.'
+intro: In this tutorial, you'll try out the basics of {% data variables.product.prodname_actions_runner_controller %}.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: quick_start
defaultPlatform: linux
redirect_from:
- /actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/quickstart-for-actions-runner-controller
- /actions/tutorials/quickstart-for-actions-runner-controller
- /actions/tutorials/actions-runner-controller/quickstart-for-actions-runner-controller
+contentType: get-started
category:
- Set up runners
---
diff --git a/content/actions/tutorials/use-actions-runner-controller/troubleshoot.md b/content/actions/tutorials/use-actions-runner-controller/troubleshoot.md
index 5b16dc9ff3d3..39af1ff57edd 100644
--- a/content/actions/tutorials/use-actions-runner-controller/troubleshoot.md
+++ b/content/actions/tutorials/use-actions-runner-controller/troubleshoot.md
@@ -1,16 +1,16 @@
---
title: Troubleshooting Actions Runner Controller errors
shortTitle: Troubleshoot
-intro: 'Learn how to troubleshoot {% data variables.product.prodname_actions_runner_controller %} errors.'
+intro: Learn how to troubleshoot {% data variables.product.prodname_actions_runner_controller %} errors.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: how_to
redirect_from:
- /actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/troubleshooting-actions-runner-controller-errors
- /actions/how-tos/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/troubleshooting-actions-runner-controller-errors
- /actions/tutorials/actions-runner-controller/troubleshooting-actions-runner-controller-errors
+contentType: how-tos
category:
- Use and manage runners
---
diff --git a/content/actions/tutorials/use-actions-runner-controller/use-arc-in-a-workflow.md b/content/actions/tutorials/use-actions-runner-controller/use-arc-in-a-workflow.md
index 37c39acfee7b..3c1a380bca50 100644
--- a/content/actions/tutorials/use-actions-runner-controller/use-arc-in-a-workflow.md
+++ b/content/actions/tutorials/use-actions-runner-controller/use-arc-in-a-workflow.md
@@ -1,17 +1,17 @@
---
title: Using Actions Runner Controller runners in a workflow
shortTitle: Use ARC in a workflow
-intro: 'You can use {% data variables.product.prodname_actions_runner_controller %} runners in a workflow file.'
+intro: You can use {% data variables.product.prodname_actions_runner_controller %} runners in a workflow file.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: overview
defaultPlatform: linux
redirect_from:
- /actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/using-actions-runner-controller-runners-in-a-workflow
- /actions/how-tos/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/using-actions-runner-controller-runners-in-a-workflow
- /actions/tutorials/actions-runner-controller/using-actions-runner-controller-runners-in-a-workflow
+contentType: concepts
category:
- Use and manage runners
---
diff --git a/content/actions/tutorials/use-containerized-services/create-a-docker-container-action.md b/content/actions/tutorials/use-containerized-services/create-a-docker-container-action.md
index 9c2f333e0af3..a973af03ac47 100644
--- a/content/actions/tutorials/use-containerized-services/create-a-docker-container-action.md
+++ b/content/actions/tutorials/use-containerized-services/create-a-docker-container-action.md
@@ -1,7 +1,7 @@
---
title: Creating a Docker container action
shortTitle: Create a Docker container action
-intro: 'In this tutorial, you''ll learn how to build a Docker container action.'
+intro: In this tutorial, you'll learn how to build a Docker container action.
redirect_from:
- /articles/creating-a-docker-container-action
- /github/automating-your-workflow-with-github-actions/creating-a-docker-container-action
@@ -15,7 +15,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
category:
- Build and test code
---
diff --git a/content/actions/tutorials/use-containerized-services/create-postgresql-service-containers.md b/content/actions/tutorials/use-containerized-services/create-postgresql-service-containers.md
index a9fefb709fee..8ce4f70b195d 100644
--- a/content/actions/tutorials/use-containerized-services/create-postgresql-service-containers.md
+++ b/content/actions/tutorials/use-containerized-services/create-postgresql-service-containers.md
@@ -14,7 +14,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
category:
- Build and test code
---
diff --git a/content/actions/tutorials/use-containerized-services/create-redis-service-containers.md b/content/actions/tutorials/use-containerized-services/create-redis-service-containers.md
index 02ea2664be86..8bfac68ab542 100644
--- a/content/actions/tutorials/use-containerized-services/create-redis-service-containers.md
+++ b/content/actions/tutorials/use-containerized-services/create-redis-service-containers.md
@@ -14,7 +14,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
category:
- Build and test code
---
diff --git a/content/actions/tutorials/use-containerized-services/use-docker-service-containers.md b/content/actions/tutorials/use-containerized-services/use-docker-service-containers.md
index b842110a33e9..68325a1f4cd2 100644
--- a/content/actions/tutorials/use-containerized-services/use-docker-service-containers.md
+++ b/content/actions/tutorials/use-containerized-services/use-docker-service-containers.md
@@ -1,7 +1,7 @@
---
title: Communicating with Docker service containers
shortTitle: Use Docker service containers
-intro: 'Learn how to use Docker service containers to connect databases, web services, memory caches, and other tools to your workflow.'
+intro: Learn how to use Docker service containers to connect databases, web services, memory caches, and other tools to your workflow.
redirect_from:
- /actions/automating-your-workflow-with-github-actions/about-service-containers
- /actions/configuring-and-managing-workflows/about-service-containers
@@ -15,7 +15,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
+contentType: concepts
category:
- Build and test code
---
diff --git a/content/admin/administering-your-instance/administering-your-instance-from-the-command-line/accessing-the-administrative-shell-ssh.md b/content/admin/administering-your-instance/administering-your-instance-from-the-command-line/accessing-the-administrative-shell-ssh.md
index a7dc2a1e86e2..9bdb9908f2a6 100644
--- a/content/admin/administering-your-instance/administering-your-instance-from-the-command-line/accessing-the-administrative-shell-ssh.md
+++ b/content/admin/administering-your-instance/administering-your-instance-from-the-command-line/accessing-the-administrative-shell-ssh.md
@@ -16,8 +16,8 @@ redirect_from:
intro: '{% data reusables.enterprise_site_admin_settings.about-ssh-access %}'
versions:
ghes: '*'
-type: how_to
shortTitle: Access the admin shell (SSH)
+contentType: how-tos
---
## About administrative shell access
diff --git a/content/admin/administering-your-instance/administering-your-instance-from-the-command-line/administering-your-instance-using-the-github-cli.md b/content/admin/administering-your-instance/administering-your-instance-from-the-command-line/administering-your-instance-using-the-github-cli.md
index 42488e0831b1..4cbe18c570c0 100644
--- a/content/admin/administering-your-instance/administering-your-instance-from-the-command-line/administering-your-instance-using-the-github-cli.md
+++ b/content/admin/administering-your-instance/administering-your-instance-from-the-command-line/administering-your-instance-using-the-github-cli.md
@@ -1,10 +1,10 @@
---
title: Administering your instance using the GitHub CLI
-intro: 'You can administer your {% data variables.product.prodname_ghe_server %} instance using the {% data variables.product.prodname_cli %} extension for GHES Manage API.'
+intro: You can administer your {% data variables.product.prodname_ghe_server %} instance using the {% data variables.product.prodname_cli %} extension for GHES Manage API.
versions:
feature: ghes-manage-api-cli-extension
-type: how_to
shortTitle: Using the GitHub CLI
+contentType: how-tos
---
## About the `gh es` extension for {% data variables.product.prodname_cli %}
diff --git a/content/admin/administering-your-instance/administering-your-instance-from-the-command-line/command-line-utilities.md b/content/admin/administering-your-instance/administering-your-instance-from-the-command-line/command-line-utilities.md
index 86b838c46ecd..368ddeb55c91 100644
--- a/content/admin/administering-your-instance/administering-your-instance-from-the-command-line/command-line-utilities.md
+++ b/content/admin/administering-your-instance/administering-your-instance-from-the-command-line/command-line-utilities.md
@@ -11,7 +11,7 @@ redirect_from:
- /admin/administering-your-instance/command-line-utilities
versions:
ghes: '*'
-type: reference
+contentType: reference
---
You can execute these commands from anywhere on the VM after signing in as an SSH admin user. For more information, see [AUTOTITLE](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh).
diff --git a/content/admin/administering-your-instance/administering-your-instance-from-the-command-line/index.md b/content/admin/administering-your-instance/administering-your-instance-from-the-command-line/index.md
index 7f91885775ce..adb2bccf03c5 100644
--- a/content/admin/administering-your-instance/administering-your-instance-from-the-command-line/index.md
+++ b/content/admin/administering-your-instance/administering-your-instance-from-the-command-line/index.md
@@ -1,13 +1,13 @@
---
title: Administering your instance from the command line
-intro: 'You can use the administrative shell (SSH) and command-line utilities to perform administrative tasks for {% data variables.location.product_location %}.'
+intro: You can use the administrative shell (SSH) and command-line utilities to perform administrative tasks for {% data variables.location.product_location %}.
versions:
ghes: '*'
-type: how_to
children:
- /accessing-the-administrative-shell-ssh
- /administering-your-instance-using-the-github-cli
- /command-line-utilities
shortTitle: Command line
+contentType: how-tos
---
diff --git a/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/about-the-management-console.md b/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/about-the-management-console.md
index 868d90019d9f..95fe59dff440 100644
--- a/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/about-the-management-console.md
+++ b/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/about-the-management-console.md
@@ -5,7 +5,7 @@ redirect_from:
- /admin/configuration/administering-your-instance-from-the-management-console/about-the-management-console
versions:
ghes: '*'
-type: overview
+contentType: concepts
---
## About the {% data variables.enterprise.management_console %}
diff --git a/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/accessing-the-management-console.md b/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/accessing-the-management-console.md
index 510912df07a8..89f1d041a56d 100644
--- a/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/accessing-the-management-console.md
+++ b/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/accessing-the-management-console.md
@@ -1,12 +1,12 @@
---
title: Accessing the Management Console
shortTitle: Access Management Console
-intro: 'You can access the {% data variables.enterprise.management_console %} as the root site administrator or a {% data variables.enterprise.management_console %} user.'
+intro: You can access the {% data variables.enterprise.management_console %} as the root site administrator or a {% data variables.enterprise.management_console %} user.
redirect_from:
- /admin/configuration/administering-your-instance-from-the-management-console/accessing-the-management-console
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
{% data reusables.enterprise_site_admin_settings.management-console-access %}
diff --git a/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/index.md b/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/index.md
index 2ba5e3b157fe..dc85cd917cc4 100644
--- a/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/index.md
+++ b/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/index.md
@@ -1,6 +1,6 @@
---
title: Administering your instance from the web UI
-intro: 'To perform administrative tasks for {% data variables.location.product_location %}, you can use the {% data variables.enterprise.management_console %} and site admin dashboard.'
+intro: To perform administrative tasks for {% data variables.location.product_location %}, you can use the {% data variables.enterprise.management_console %} and site admin dashboard.
redirect_from:
- /admin/configuration/configuring-your-enterprise/accessing-the-management-console
- /enterprise/admin/articles/about-the-management-console
@@ -22,7 +22,6 @@ redirect_from:
- /admin/administering-your-instance/administering-your-instance-from-the-web-ui/site-admin-dashboard
versions:
ghes: '*'
-type: how_to
children:
- /about-the-management-console
- /managing-access-to-the-management-console
@@ -30,5 +29,6 @@ children:
- /troubleshooting-access-to-the-management-console
- /managing-search-indices-for-your-instance
shortTitle: Web UI
+contentType: how-tos
---
diff --git a/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/managing-access-to-the-management-console.md b/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/managing-access-to-the-management-console.md
index 1712ba191557..30f23ac30b3d 100644
--- a/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/managing-access-to-the-management-console.md
+++ b/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/managing-access-to-the-management-console.md
@@ -1,12 +1,12 @@
---
title: Managing access to the Management Console
shortTitle: Manage Management Console access
-intro: 'You can increase the security of {% data variables.location.product_location %} by creating or deleting {% data variables.enterprise.management_console %} users. As the root site administrator, you can access the {% data variables.enterprise.management_console %} as well as configure {% data variables.enterprise.management_console %} authentication rate limits.'
+intro: You can increase the security of {% data variables.location.product_location %} by creating or deleting {% data variables.enterprise.management_console %} users. As the root site administrator, you can access the {% data variables.enterprise.management_console %} as well as configure {% data variables.enterprise.management_console %} authentication rate limits.
redirect_from:
- /admin/configuration/administering-your-instance-from-the-management-console/managing-access-to-the-management-console
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
{% data reusables.enterprise_site_admin_settings.management-console-access %} For more information about {% data variables.enterprise.management_console %} access, see [AUTOTITLE](/admin/configuration/administering-your-instance-from-the-management-console).
diff --git a/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/managing-search-indices-for-your-instance.md b/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/managing-search-indices-for-your-instance.md
index d67579eabf81..09071f01d31a 100644
--- a/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/managing-search-indices-for-your-instance.md
+++ b/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/managing-search-indices-for-your-instance.md
@@ -5,7 +5,7 @@ intro: '{% data variables.product.prodname_ghe_server %} uses Elasticsearch to p
permissions: Enterprise owners can manage search indices for a {% data variables.product.prodname_ghe_server %} instance.
versions:
ghes: '*'
-type: reference
+contentType: reference
---
## About search for {% data variables.product.prodname_ghe_server %}
diff --git a/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/troubleshooting-access-to-the-management-console.md b/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/troubleshooting-access-to-the-management-console.md
index ed414944925b..f815c0561669 100644
--- a/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/troubleshooting-access-to-the-management-console.md
+++ b/content/admin/administering-your-instance/administering-your-instance-from-the-web-ui/troubleshooting-access-to-the-management-console.md
@@ -1,12 +1,12 @@
---
title: Troubleshooting access to the Management Console
shortTitle: Troubleshoot Management Console
-intro: 'You can troubleshoot access problems for the {% data variables.enterprise.management_console %}.'
+intro: You can troubleshoot access problems for the {% data variables.enterprise.management_console %}.
redirect_from:
- /admin/configuration/administering-your-instance-from-the-management-console/troubleshooting-access-to-the-management-console
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About problems with {% data variables.enterprise.management_console %} access
diff --git a/content/admin/administering-your-instance/configuring-maintenance-mode/enabling-and-scheduling-maintenance-mode.md b/content/admin/administering-your-instance/configuring-maintenance-mode/enabling-and-scheduling-maintenance-mode.md
index 6b5f81c34434..40e9bd4f67c6 100644
--- a/content/admin/administering-your-instance/configuring-maintenance-mode/enabling-and-scheduling-maintenance-mode.md
+++ b/content/admin/administering-your-instance/configuring-maintenance-mode/enabling-and-scheduling-maintenance-mode.md
@@ -1,6 +1,6 @@
---
title: Enabling and scheduling maintenance mode
-intro: 'Some standard maintenance procedures, such as upgrading {% data variables.location.product_location %} or restoring backups, require the instance to be taken offline for normal use.'
+intro: Some standard maintenance procedures, such as upgrading {% data variables.location.product_location %} or restoring backups, require the instance to be taken offline for normal use.
redirect_from:
- /enterprise/admin/maintenance-mode
- /enterprise/admin/categories/maintenance-mode
@@ -15,8 +15,8 @@ redirect_from:
- /admin/administering-your-instance/enabling-and-scheduling-maintenance-mode
versions:
ghes: '*'
-type: how_to
shortTitle: Configure maintenance mode
+contentType: how-tos
---
## About maintenance mode
diff --git a/content/admin/administering-your-instance/configuring-maintenance-mode/index.md b/content/admin/administering-your-instance/configuring-maintenance-mode/index.md
index 950c4f1e95e3..eadb23b44729 100644
--- a/content/admin/administering-your-instance/configuring-maintenance-mode/index.md
+++ b/content/admin/administering-your-instance/configuring-maintenance-mode/index.md
@@ -1,11 +1,11 @@
---
title: Configuring maintenance mode
-intro: 'To control availability of {% data variables.location.product_location %} during maintenance, you can configure maintenance mode.'
+intro: To control availability of {% data variables.location.product_location %} during maintenance, you can configure maintenance mode.
versions:
ghes: '*'
-type: how_to
children:
- /enabling-and-scheduling-maintenance-mode
shortTitle: Maintenance mode
+contentType: how-tos
---
diff --git a/content/admin/administering-your-instance/index.md b/content/admin/administering-your-instance/index.md
index a00ccf30fc4f..22769c569096 100644
--- a/content/admin/administering-your-instance/index.md
+++ b/content/admin/administering-your-instance/index.md
@@ -1,12 +1,13 @@
---
title: Administering your instance
shortTitle: Administer your instance
-intro: 'You can administer your instance using the {% data variables.enterprise.management_console %}, site admin dashboard, SSH, and command-line utilities.'
+intro: You can administer your instance using the {% data variables.enterprise.management_console %}, site admin dashboard, SSH, and command-line utilities.
versions:
ghes: '*'
-type: how_to
children:
- /administering-your-instance-from-the-web-ui
- /administering-your-instance-from-the-command-line
- /configuring-maintenance-mode
+contentType: how-tos
---
+
diff --git a/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/about-the-backup-service-for-github-enterprise-server.md b/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/about-the-backup-service-for-github-enterprise-server.md
index 766cf429a6b8..54903f690e5c 100644
--- a/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/about-the-backup-service-for-github-enterprise-server.md
+++ b/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/about-the-backup-service-for-github-enterprise-server.md
@@ -1,10 +1,10 @@
---
title: About the backup service for GitHub Enterprise Server
shortTitle: About the backup service
-intro: 'Learn what the built-in backup service offers and how it differs from a High Availability replica.'
+intro: Learn what the built-in backup service offers and how it differs from a High Availability replica.
versions:
ghes: '>=3.17'
-type: overview
+contentType: concepts
---
{% ifversion ghes < 3.20 %}
diff --git a/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/backup-from-replica-in-high-availability.md b/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/backup-from-replica-in-high-availability.md
index ea876b7fe0b0..e270dceb1320 100644
--- a/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/backup-from-replica-in-high-availability.md
+++ b/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/backup-from-replica-in-high-availability.md
@@ -1,10 +1,10 @@
---
title: Backup from replica in high availability
shortTitle: Backup from replica
-intro: 'Enable backup from a high availability replica node.'
+intro: Enable backup from a high availability replica node.
versions:
ghes: '> 3.19'
-type: how_to
+contentType: how-tos
---
## Configuring backups from a replica node
diff --git a/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/backup-in-clustering-mode.md b/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/backup-in-clustering-mode.md
index 7b5844343b4b..fc194c7441ee 100644
--- a/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/backup-in-clustering-mode.md
+++ b/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/backup-in-clustering-mode.md
@@ -1,10 +1,10 @@
---
title: Backup in clustering mode
shortTitle: Backup in clustering
-intro: 'Enable backup from a node in cluster.'
+intro: Enable backup from a node in cluster.
versions:
ghes: '> 3.19'
-type: how_to
+contentType: how-tos
---
## Configuring backups from a cluster node
diff --git a/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/backup-service-settings-reference.md b/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/backup-service-settings-reference.md
index a5c58b0cfc7a..094ab9f0b06f 100644
--- a/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/backup-service-settings-reference.md
+++ b/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/backup-service-settings-reference.md
@@ -1,10 +1,10 @@
---
title: Backup service settings reference
shortTitle: Backup settings
-intro: 'Reference for all configurable options available in the Backup Service section of the {% data variables.enterprise.management_console %}.'
+intro: Reference for all configurable options available in the Backup Service section of the {% data variables.enterprise.management_console %}.
versions:
ghes: '>= 3.17'
-type: reference
+contentType: reference
---
You can configure the following options in the "Backup Service" section of the {% data variables.enterprise.management_console %}.
diff --git a/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/configuring-remote-archives-for-backups.md b/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/configuring-remote-archives-for-backups.md
index 569884aab39f..a98e415f640e 100644
--- a/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/configuring-remote-archives-for-backups.md
+++ b/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/configuring-remote-archives-for-backups.md
@@ -1,10 +1,10 @@
---
title: Configuring remote archives for backups
shortTitle: Configure remote archives
-intro: 'Enable a remote archive for backups through SSH.'
+intro: Enable a remote archive for backups through SSH.
versions:
ghes: '> 3.19'
-type: how_to
+contentType: how-tos
---
If you are running {% data variables.product.prodname_ghe_server %} on a cloud platform or virtualization platform that supports disk snapshots, we recommend that you use snapshots to archive your backup disk, and recreate a new backup disk for testing, restoring, or disaster recovery purposes. However, if your infrastructure does not support disk snapshots or similar solutions, you can setup a {% data variables.product.prodname_ghe_server %} backup archive on a remote {% data variables.product.prodname_ghe_server %} appliance for data replication and restoration purposes.
diff --git a/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/configuring-the-backup-service.md b/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/configuring-the-backup-service.md
index 9c0ecaa5bdb7..7d7ac1f7c5a7 100644
--- a/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/configuring-the-backup-service.md
+++ b/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/configuring-the-backup-service.md
@@ -1,10 +1,10 @@
---
title: Configuring the backup service
shortTitle: Configure the backup service
-intro: 'Enable and configure the built-in backup service in the {% data variables.enterprise.management_console %}, and optionally migrate legacy settings.'
+intro: Enable and configure the built-in backup service in the {% data variables.enterprise.management_console %}, and optionally migrate legacy settings.
versions:
ghes: '>=3.17'
-type: how_to
+contentType: how-tos
---
Before configuring the backup service, ensure you have:
@@ -175,4 +175,4 @@ Once the service is configured, you can define a backup schedule.
1. Click **Save** to apply the changes.
{% endif %}
-The first run will be a full backup. Future runs will be incremental. If a new backup attempt starts while a previous one is still running, it may be skipped or fail. In that case, adjust the schedule to avoid overlap.
\ No newline at end of file
+The first run will be a full backup. Future runs will be incremental. If a new backup attempt starts while a previous one is still running, it may be skipped or fail. In that case, adjust the schedule to avoid overlap.
diff --git a/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/creating-and-monitoring-backups.md b/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/creating-and-monitoring-backups.md
index 4910ffd123b4..d2e07397f24a 100644
--- a/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/creating-and-monitoring-backups.md
+++ b/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/creating-and-monitoring-backups.md
@@ -1,10 +1,10 @@
---
title: Creating and monitoring backups
shortTitle: Create and monitor backups
-intro: 'Run manual backups, understand backup types, and monitor backup activity using the {% data variables.enterprise.management_console %} or command line.'
+intro: Run manual backups, understand backup types, and monitor backup activity using the {% data variables.enterprise.management_console %} or command line.
versions:
ghes: '>= 3.17'
-type: how_to
+contentType: how-tos
---
## About backup types
diff --git a/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/restoring-from-a-backup.md b/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/restoring-from-a-backup.md
index 0e78ba88b0de..06f3e2657e04 100644
--- a/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/restoring-from-a-backup.md
+++ b/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/restoring-from-a-backup.md
@@ -1,10 +1,10 @@
---
title: Restoring from a backup
shortTitle: Restore from backup
-intro: 'Restore a {% data variables.product.prodname_ghe_server %} instance using a previously created backup snapshot.'
+intro: Restore a {% data variables.product.prodname_ghe_server %} instance using a previously created backup snapshot.
versions:
ghes: '>= 3.17'
-type: how_to
+contentType: how-tos
---
You can restore a {% data variables.product.prodname_ghe_server %} instance from a backup using the command line. The backup service supports full instance restoration, including configuration and user data.
diff --git a/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/restoring-with-github-actions-enabled.md b/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/restoring-with-github-actions-enabled.md
index 6a57e22c4663..922827cb10e5 100644
--- a/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/restoring-with-github-actions-enabled.md
+++ b/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/restoring-with-github-actions-enabled.md
@@ -1,10 +1,10 @@
---
title: Restoring with GitHub Actions enabled
shortTitle: Restore with Actions
-intro: 'Learn how to prepare for and restore backups when {% data variables.product.prodname_actions %} is enabled with external blob storage.'
+intro: Learn how to prepare for and restore backups when {% data variables.product.prodname_actions %} is enabled with external blob storage.
versions:
ghes: '>= 3.17'
-type: how_to
+contentType: how-tos
---
>[!IMPORTANT] Data stored in your configured external storage for {% data variables.product.prodname_actions %}—such as logs, artifacts, and other blobs—is not included in {% data variables.product.prodname_enterprise_backup_service %} snapshots. You must back up this data separately using your storage provider's tools and best practices.
diff --git a/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/understanding-the-snapshot-file-structure.md b/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/understanding-the-snapshot-file-structure.md
index 069689264b66..0a02454afe5e 100644
--- a/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/understanding-the-snapshot-file-structure.md
+++ b/content/admin/backing-up-and-restoring-your-instance/backup-service-for-github-enterprise-server/understanding-the-snapshot-file-structure.md
@@ -1,10 +1,10 @@
---
title: Understanding the snapshot file structure
shortTitle: Snapshot structure
-intro: 'Understand the structure and contents of backup snapshot directories, including what is stored and how hard links are used.'
+intro: Understand the structure and contents of backup snapshot directories, including what is stored and how hard links are used.
versions:
ghes: '>= 3.17'
-type: reference
+contentType: reference
---
Each backup snapshot is stored in a timestamped directory (e.g., `YYYYMMDDTHHMMSS`) under the backup target path (e.g., `/data/backup/data`). Snapshots include full exports of key data stores. Git repositories, {% data variables.product.prodname_pages %}, and other components are stored using hard links to optimize storage and enable efficient point-in-time restores.
diff --git a/content/admin/backing-up-and-restoring-your-instance/configuring-backups-on-your-instance.md b/content/admin/backing-up-and-restoring-your-instance/configuring-backups-on-your-instance.md
index 172aea681d3b..3981d5e4366d 100644
--- a/content/admin/backing-up-and-restoring-your-instance/configuring-backups-on-your-instance.md
+++ b/content/admin/backing-up-and-restoring-your-instance/configuring-backups-on-your-instance.md
@@ -17,10 +17,10 @@ redirect_from:
- /admin/configuration/configuring-backups-on-your-appliance
- /admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance
- /admin/configuration/configuring-your-enterprise/configuring-backups-on-your-instance
-intro: 'As part of a disaster recovery plan, you can protect production data on {% data variables.location.product_location %} by configuring automated backups.'
+intro: As part of a disaster recovery plan, you can protect production data on {% data variables.location.product_location %} by configuring automated backups.
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
{% ifversion ghes > 3.16 %}
diff --git a/content/admin/concepts/enterprise-fundamentals/automations-in-your-enterprise.md b/content/admin/concepts/enterprise-fundamentals/automations-in-your-enterprise.md
index 6dc4d919a6ce..a4b9ccd70f9c 100644
--- a/content/admin/concepts/enterprise-fundamentals/automations-in-your-enterprise.md
+++ b/content/admin/concepts/enterprise-fundamentals/automations-in-your-enterprise.md
@@ -1,10 +1,10 @@
---
title: Automations in your enterprise
shortTitle: Automations
-intro: 'Learn how {% data variables.product.prodname_github_apps %}, external services, and {% data variables.product.prodname_actions %} work together to automate processes in your enterprise.'
+intro: Learn how {% data variables.product.prodname_github_apps %}, external services, and {% data variables.product.prodname_actions %} work together to automate processes in your enterprise.
versions:
feature: enterprise-apps-public-beta
-type: overview
+contentType: concepts
---
Automation on {% data variables.product.github %} typically involves multiple components working together. The most important {% data variables.product.github %} native components are:
diff --git a/content/admin/configuring-packages/configuring-package-ecosystem-support-for-your-enterprise.md b/content/admin/configuring-packages/configuring-package-ecosystem-support-for-your-enterprise.md
index 64e2e8b9c202..eb5527e37bbe 100644
--- a/content/admin/configuring-packages/configuring-package-ecosystem-support-for-your-enterprise.md
+++ b/content/admin/configuring-packages/configuring-package-ecosystem-support-for-your-enterprise.md
@@ -1,15 +1,15 @@
---
title: Configuring package ecosystem support for your enterprise
-intro: 'You can configure {% data variables.product.prodname_registry %} for your enterprise by globally enabling or disabling individual package ecosystems on your enterprise, including {% data variables.product.prodname_container_registry %}, Docker, and npm. Learn about other configuration requirements to support specific package ecosystems.'
-permissions: 'Site administrators can enable {% data variables.product.prodname_registry %} and configure enterprise settings.'
+intro: You can configure {% data variables.product.prodname_registry %} for your enterprise by globally enabling or disabling individual package ecosystems on your enterprise, including {% data variables.product.prodname_container_registry %}, Docker, and npm. Learn about other configuration requirements to support specific package ecosystems.
+permissions: Site administrators can enable {% data variables.product.prodname_registry %} and configure enterprise settings.
redirect_from:
- /enterprise/admin/packages/configuring-packages-support-for-your-enterprise
- /admin/packages/configuring-packages-support-for-your-enterprise
- /admin/packages/configuring-package-ecosystem-support-for-your-enterprise
versions:
ghes: '*'
-type: how_to
shortTitle: Configure package ecosystems
+contentType: how-tos
---
{% data reusables.package_registry.packages-ghes-release-stage %}
diff --git a/content/admin/configuring-packages/enabling-github-packages-with-aws.md b/content/admin/configuring-packages/enabling-github-packages-with-aws.md
index 29515b4dbca9..31188425e3ff 100644
--- a/content/admin/configuring-packages/enabling-github-packages-with-aws.md
+++ b/content/admin/configuring-packages/enabling-github-packages-with-aws.md
@@ -1,12 +1,12 @@
---
title: Enabling GitHub Packages with AWS
-intro: 'Set up {% data variables.product.prodname_registry %} with AWS as your external storage.'
+intro: Set up {% data variables.product.prodname_registry %} with AWS as your external storage.
versions:
ghes: '*'
-type: tutorial
shortTitle: Enable Packages with AWS
redirect_from:
- /admin/packages/enabling-github-packages-with-aws
+contentType: tutorials
---
> [!WARNING]
diff --git a/content/admin/configuring-packages/enabling-github-packages-with-azure-blob-storage.md b/content/admin/configuring-packages/enabling-github-packages-with-azure-blob-storage.md
index 07e0cf432a2a..ac73f617300c 100644
--- a/content/admin/configuring-packages/enabling-github-packages-with-azure-blob-storage.md
+++ b/content/admin/configuring-packages/enabling-github-packages-with-azure-blob-storage.md
@@ -1,12 +1,12 @@
---
title: Enabling GitHub Packages with Azure Blob Storage
-intro: 'Set up {% data variables.product.prodname_registry %} with Azure Blob Storage as your external storage.'
+intro: Set up {% data variables.product.prodname_registry %} with Azure Blob Storage as your external storage.
versions:
ghes: '*'
-type: tutorial
shortTitle: Enable Packages with Azure
redirect_from:
- /admin/packages/enabling-github-packages-with-azure-blob-storage
+contentType: tutorials
---
> [!WARNING]
diff --git a/content/admin/configuring-packages/enabling-github-packages-with-minio.md b/content/admin/configuring-packages/enabling-github-packages-with-minio.md
index 33740e75ee6f..fb8069835a40 100644
--- a/content/admin/configuring-packages/enabling-github-packages-with-minio.md
+++ b/content/admin/configuring-packages/enabling-github-packages-with-minio.md
@@ -1,13 +1,13 @@
---
title: Enabling GitHub Packages with MinIO
-intro: 'Set up {% data variables.product.prodname_registry %} with MinIO as your external storage.'
+intro: Set up {% data variables.product.prodname_registry %} with MinIO as your external storage.
versions:
ghes: '*'
-type: tutorial
shortTitle: Enable Packages with MinIO
redirect_from:
- /admin/packages/enabling-github-packages-with-minio
- /admin/configuring-packages/quickstart-for-configuring-your-minio-storage-bucket-for-github-packages
+contentType: tutorials
---
> [!WARNING]
diff --git a/content/admin/configuring-packages/getting-started-with-github-packages-for-your-enterprise.md b/content/admin/configuring-packages/getting-started-with-github-packages-for-your-enterprise.md
index a115ce4dd239..0a8a1301bf16 100644
--- a/content/admin/configuring-packages/getting-started-with-github-packages-for-your-enterprise.md
+++ b/content/admin/configuring-packages/getting-started-with-github-packages-for-your-enterprise.md
@@ -1,15 +1,15 @@
---
title: Getting started with GitHub Packages for your enterprise
shortTitle: Getting started with GitHub Packages
-intro: 'You can start using {% data variables.product.prodname_registry %} on {% data variables.location.product_location %} by enabling the feature, configuring third-party storage, configuring the ecosystems you want to support, and updating your TLS certificate.'
-permissions: 'Site administrators can enable and configure {% data variables.product.prodname_registry %}.'
+intro: You can start using {% data variables.product.prodname_registry %} on {% data variables.location.product_location %} by enabling the feature, configuring third-party storage, configuring the ecosystems you want to support, and updating your TLS certificate.
+permissions: Site administrators can enable and configure {% data variables.product.prodname_registry %}.
redirect_from:
- /enterprise/admin/packages/enabling-github-packages-for-your-enterprise
- /admin/packages/enabling-github-packages-for-your-enterprise
- /admin/packages/getting-started-with-github-packages-for-your-enterprise
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
diff --git a/content/admin/configuring-settings/configuring-github-connect/about-github-connect.md b/content/admin/configuring-settings/configuring-github-connect/about-github-connect.md
index 31a8e3aacaf6..344587bacd35 100644
--- a/content/admin/configuring-settings/configuring-github-connect/about-github-connect.md
+++ b/content/admin/configuring-settings/configuring-github-connect/about-github-connect.md
@@ -3,9 +3,9 @@ title: About GitHub Connect
intro: '{% data variables.product.prodname_github_connect %} enhances {% data variables.product.prodname_ghe_server %} by giving you access to data and workflows from {% data variables.product.prodname_ghe_cloud %}.'
versions:
ghes: '*'
-type: overview
redirect_from:
- /admin/configuration/configuring-github-connect/about-github-connect
+contentType: concepts
---
{% data variables.product.prodname_github_connect %} allows {% data variables.location.product_location %} to connect to your enterprise on {% data variables.product.prodname_ghe_cloud %} in limited ways.
diff --git a/content/admin/configuring-settings/configuring-github-connect/enabling-automatic-user-license-sync-for-your-enterprise.md b/content/admin/configuring-settings/configuring-github-connect/enabling-automatic-user-license-sync-for-your-enterprise.md
index 2a80ae57d271..def9d5c3e914 100644
--- a/content/admin/configuring-settings/configuring-github-connect/enabling-automatic-user-license-sync-for-your-enterprise.md
+++ b/content/admin/configuring-settings/configuring-github-connect/enabling-automatic-user-license-sync-for-your-enterprise.md
@@ -1,6 +1,6 @@
---
title: Enabling automatic user license sync for your enterprise
-intro: 'You can manage license usage across your {% data variables.product.prodname_enterprise %} environments by automatically syncing user licenses from {% data variables.location.product_location %} to {% data variables.product.prodname_ghe_cloud %}.'
+intro: You can manage license usage across your {% data variables.product.prodname_enterprise %} environments by automatically syncing user licenses from {% data variables.location.product_location %} to {% data variables.product.prodname_ghe_cloud %}.
redirect_from:
- /enterprise/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud
- /enterprise/admin/configuration/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud
@@ -11,8 +11,8 @@ redirect_from:
permissions: Enterprise owners can enable automatic user license synchronization.
versions:
ghes: '*'
-type: how_to
shortTitle: Automatic user license sync
+contentType: how-tos
---
## About automatic license synchronization
diff --git a/content/admin/configuring-settings/configuring-github-connect/enabling-dependabot-for-your-enterprise.md b/content/admin/configuring-settings/configuring-github-connect/enabling-dependabot-for-your-enterprise.md
index 5bcc4c093547..054125694df4 100644
--- a/content/admin/configuring-settings/configuring-github-connect/enabling-dependabot-for-your-enterprise.md
+++ b/content/admin/configuring-settings/configuring-github-connect/enabling-dependabot-for-your-enterprise.md
@@ -1,6 +1,6 @@
---
title: Enabling Dependabot for your enterprise
-intro: 'You can allow users to find and fix vulnerabilities in code dependencies by setting up {% data variables.product.prodname_dependabot_alerts %} and {% data variables.product.prodname_dependabot_updates %}.'
+intro: You can allow users to find and fix vulnerabilities in code dependencies by setting up {% data variables.product.prodname_dependabot_alerts %} and {% data variables.product.prodname_dependabot_updates %}.
shortTitle: Dependabot
redirect_from:
- /enterprise/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server
@@ -12,10 +12,10 @@ redirect_from:
- /admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-the-dependency-graph-and-dependabot-alerts-on-your-enterprise-account
- /admin/configuration/configuring-github-connect/enabling-the-dependency-graph-and-dependabot-alerts-for-your-enterprise
- /admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise
-permissions: 'Enterprise owners can set up {% data variables.product.prodname_dependabot %}.'
+permissions: Enterprise owners can set up {% data variables.product.prodname_dependabot %}.
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About {% data variables.product.prodname_dependabot %} for {% data variables.product.prodname_ghe_server %}
diff --git a/content/admin/configuring-settings/configuring-github-connect/enabling-github-connect-for-githubcom.md b/content/admin/configuring-settings/configuring-github-connect/enabling-github-connect-for-githubcom.md
index c97ff504ebd8..32091d8276d4 100644
--- a/content/admin/configuring-settings/configuring-github-connect/enabling-github-connect-for-githubcom.md
+++ b/content/admin/configuring-settings/configuring-github-connect/enabling-github-connect-for-githubcom.md
@@ -1,7 +1,7 @@
---
title: Enabling GitHub Connect for GitHub.com
shortTitle: Enable for GitHub.com
-intro: 'Enable {% data variables.product.prodname_github_connect %} to access additional features and workflows from {% data variables.product.prodname_dotcom_the_website %} on {% data variables.location.product_location %}.'
+intro: Enable {% data variables.product.prodname_github_connect %} to access additional features and workflows from {% data variables.product.prodname_dotcom_the_website %} on {% data variables.location.product_location %}.
redirect_from:
- /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-to-github-com
- /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com
@@ -15,7 +15,7 @@ redirect_from:
- /admin/configuring-settings/configuring-github-connect/managing-github-connect
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
You can access additional features and workflows on {% data variables.location.product_location %} by enabling {% data variables.product.prodname_github_connect %}. See [AUTOTITLE](/admin/configuration/configuring-github-connect/about-github-connect).
diff --git a/content/admin/configuring-settings/configuring-github-connect/enabling-unified-contributions-for-your-enterprise.md b/content/admin/configuring-settings/configuring-github-connect/enabling-unified-contributions-for-your-enterprise.md
index b76fa9050cfd..1f7dd4e0b0c7 100644
--- a/content/admin/configuring-settings/configuring-github-connect/enabling-unified-contributions-for-your-enterprise.md
+++ b/content/admin/configuring-settings/configuring-github-connect/enabling-unified-contributions-for-your-enterprise.md
@@ -1,7 +1,7 @@
---
title: Enabling unified contributions for your enterprise
shortTitle: Unified contributions
-intro: 'You can allow users to include anonymized contribution counts for their work on {% data variables.location.product_location %} in their contribution graphs on {% data variables.product.prodname_ghe_cloud %}.'
+intro: You can allow users to include anonymized contribution counts for their work on {% data variables.location.product_location %} in their contribution graphs on {% data variables.product.prodname_ghe_cloud %}.
redirect_from:
- /enterprise/admin/guides/developer-workflow/enabling-unified-contributions-between-github-enterprise-and-github-com
- /enterprise/admin/guides/developer-workflow/enabling-unified-contributions-between-github-enterprise-server-and-github-com
@@ -12,10 +12,10 @@ redirect_from:
- /admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud/enabling-unified-contributions-between-github-enterprise-server-and-githubcom
- /admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-unified-contributions-between-your-enterprise-account-and-githubcom
- /admin/configuration/configuring-github-connect/enabling-unified-contributions-for-your-enterprise
-permissions: 'Enterprise owners'
+permissions: Enterprise owners
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About unified contributions
diff --git a/content/admin/configuring-settings/configuring-github-connect/enabling-unified-search-for-your-enterprise.md b/content/admin/configuring-settings/configuring-github-connect/enabling-unified-search-for-your-enterprise.md
index c506242e182a..c772546b4e78 100644
--- a/content/admin/configuring-settings/configuring-github-connect/enabling-unified-search-for-your-enterprise.md
+++ b/content/admin/configuring-settings/configuring-github-connect/enabling-unified-search-for-your-enterprise.md
@@ -1,7 +1,7 @@
---
title: Enabling unified search for your enterprise
shortTitle: Unified search
-intro: 'You can allow users to include repositories on {% data variables.product.prodname_ghe_cloud %} in their search results when searching from {% data variables.location.product_location %}.'
+intro: You can allow users to include repositories on {% data variables.product.prodname_ghe_cloud %} in their search results when searching from {% data variables.location.product_location %}.
redirect_from:
- /enterprise/admin/guides/developer-workflow/enabling-unified-search-between-github-enterprise-and-github-com
- /enterprise/admin/guides/developer-workflow/enabling-unified-search-between-github-enterprise-server-and-github-com
@@ -12,10 +12,10 @@ redirect_from:
- /admin/configuration/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud/enabling-unified-search-between-github-enterprise-server-and-githubcom
- /admin/configuration/managing-connections-between-your-enterprise-accounts/enabling-unified-search-between-your-enterprise-account-and-githubcom
- /admin/configuration/configuring-github-connect/enabling-unified-search-for-your-enterprise
-permissions: 'Enterprise owners'
+permissions: Enterprise owners
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About {% data variables.enterprise.prodname_unified_search %}
diff --git a/content/admin/configuring-settings/configuring-github-connect/index.md b/content/admin/configuring-settings/configuring-github-connect/index.md
index 1aad480d3039..5e001b75f39e 100644
--- a/content/admin/configuring-settings/configuring-github-connect/index.md
+++ b/content/admin/configuring-settings/configuring-github-connect/index.md
@@ -1,6 +1,6 @@
---
title: Configuring GitHub Connect
-intro: 'With {% data variables.product.prodname_github_connect %}, you can access additional features and workflows by connecting {% data variables.location.product_location %} to {% data variables.product.prodname_ghe_cloud %}.'
+intro: With {% data variables.product.prodname_github_connect %}, you can access additional features and workflows by connecting {% data variables.location.product_location %} to {% data variables.product.prodname_ghe_cloud %}.
redirect_from:
- /enterprise/admin/developer-workflow/connecting-github-enterprise-to-github-com
- /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-and-github-com
@@ -13,7 +13,6 @@ redirect_from:
- /admin/configuration/configuring-github-connect
versions:
ghes: '*'
-type: how_to
children:
- /about-github-connect
- /enabling-github-connect-for-githubcom
@@ -25,5 +24,6 @@ children:
- /enabling-unified-contributions-for-your-enterprise
- /disabling-github-connect
shortTitle: GitHub Connect
+contentType: how-tos
---
diff --git a/content/admin/configuring-settings/configuring-network-settings/changing-the-hostname-for-your-instance.md b/content/admin/configuring-settings/configuring-network-settings/changing-the-hostname-for-your-instance.md
index 0f400dc311c6..f4d1947ef06e 100644
--- a/content/admin/configuring-settings/configuring-network-settings/changing-the-hostname-for-your-instance.md
+++ b/content/admin/configuring-settings/configuring-network-settings/changing-the-hostname-for-your-instance.md
@@ -1,12 +1,12 @@
---
title: Changing the hostname for your instance
shortTitle: Change hostname
-intro: 'If you want to change the hostname for an existing {% data variables.product.prodname_ghe_server %} instance, you must restore the settings and data to a new instance.'
+intro: If you want to change the hostname for an existing {% data variables.product.prodname_ghe_server %} instance, you must restore the settings and data to a new instance.
versions:
ghes: '*'
-type: how_to
redirect_from:
- /admin/configuration/configuring-network-settings/changing-the-hostname-for-your-instance
+contentType: how-tos
---
## About changes to the hostname for {% data variables.product.prodname_ghe_server %}
diff --git a/content/admin/configuring-settings/configuring-network-settings/configuring-an-outbound-web-proxy-server.md b/content/admin/configuring-settings/configuring-network-settings/configuring-an-outbound-web-proxy-server.md
index 4c438a56b0a1..8109826a01a5 100644
--- a/content/admin/configuring-settings/configuring-network-settings/configuring-an-outbound-web-proxy-server.md
+++ b/content/admin/configuring-settings/configuring-network-settings/configuring-an-outbound-web-proxy-server.md
@@ -1,17 +1,17 @@
---
title: Configuring an outbound web proxy server
-intro: 'A proxy server provides an additional level of security for {% data variables.location.product_location %}.'
+intro: A proxy server provides an additional level of security for {% data variables.location.product_location %}.
redirect_from:
- /enterprise/admin/guides/installation/configuring-a-proxy-server
- /enterprise/admin/installation/configuring-an-outbound-web-proxy-server
- /enterprise/admin/configuration/configuring-an-outbound-web-proxy-server
- /admin/configuration/configuring-an-outbound-web-proxy-server
- /admin/configuration/configuring-network-settings/configuring-an-outbound-web-proxy-server
-permissions: 'Site administrators can configure an outbound web proxy server for a {% data variables.product.prodname_ghe_server %} instance.'
+permissions: Site administrators can configure an outbound web proxy server for a {% data variables.product.prodname_ghe_server %} instance.
versions:
ghes: '*'
-type: how_to
shortTitle: Configure an outbound proxy
+contentType: how-tos
---
## About configuration of a proxy for {% data variables.product.prodname_ghe_server %}
diff --git a/content/admin/configuring-settings/configuring-network-settings/configuring-built-in-firewall-rules.md b/content/admin/configuring-settings/configuring-network-settings/configuring-built-in-firewall-rules.md
index e730467bd370..d17ee0fb666c 100644
--- a/content/admin/configuring-settings/configuring-network-settings/configuring-built-in-firewall-rules.md
+++ b/content/admin/configuring-settings/configuring-network-settings/configuring-built-in-firewall-rules.md
@@ -1,6 +1,6 @@
---
title: Configuring built-in firewall rules
-intro: 'You can view default firewall rules and customize rules for {% data variables.location.product_location %}.'
+intro: You can view default firewall rules and customize rules for {% data variables.location.product_location %}.
redirect_from:
- /enterprise/admin/guides/installation/configuring-firewall-settings
- /enterprise/admin/installation/configuring-built-in-firewall-rules
@@ -9,8 +9,8 @@ redirect_from:
- /admin/configuration/configuring-network-settings/configuring-built-in-firewall-rules
versions:
ghes: '*'
-type: how_to
shortTitle: Configure firewall rules
+contentType: how-tos
---
## About {% data variables.location.product_location %}'s firewall
diff --git a/content/admin/configuring-settings/configuring-network-settings/configuring-dns-nameservers.md b/content/admin/configuring-settings/configuring-network-settings/configuring-dns-nameservers.md
index 603a8d0b4ff9..757bf35b3fb2 100644
--- a/content/admin/configuring-settings/configuring-network-settings/configuring-dns-nameservers.md
+++ b/content/admin/configuring-settings/configuring-network-settings/configuring-dns-nameservers.md
@@ -9,8 +9,8 @@ redirect_from:
- /admin/configuration/configuring-network-settings/configuring-dns-nameservers
versions:
ghes: '*'
-type: how_to
shortTitle: Configure DNS servers
+contentType: how-tos
---
The nameservers you specify must resolve {% data variables.location.product_location %}'s hostname.
diff --git a/content/admin/configuring-settings/configuring-network-settings/configuring-the-hostname-for-your-instance.md b/content/admin/configuring-settings/configuring-network-settings/configuring-the-hostname-for-your-instance.md
index 0705172b6e54..c4cde64ecbf6 100644
--- a/content/admin/configuring-settings/configuring-network-settings/configuring-the-hostname-for-your-instance.md
+++ b/content/admin/configuring-settings/configuring-network-settings/configuring-the-hostname-for-your-instance.md
@@ -1,7 +1,7 @@
---
title: Configuring the hostname for your instance
shortTitle: Configure hostname
-intro: 'You can provide reliable access to {% data variables.location.product_location %} by assigning a hostname that''s accessible over your network.'
+intro: You can provide reliable access to {% data variables.location.product_location %} by assigning a hostname that's accessible over your network.
redirect_from:
- /enterprise/admin/guides/installation/configuring-hostnames
- /enterprise/admin/installation/configuring-a-hostname
@@ -11,7 +11,7 @@ redirect_from:
- /admin/configuration/configuring-network-settings/configuring-the-hostname-for-your-instance
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About the hostname for {% data variables.product.prodname_ghe_server %}
diff --git a/content/admin/configuring-settings/configuring-network-settings/configuring-the-ip-address-using-the-virtual-machine-console.md b/content/admin/configuring-settings/configuring-network-settings/configuring-the-ip-address-using-the-virtual-machine-console.md
index f94223f1fbf0..ddfd3846fdbb 100644
--- a/content/admin/configuring-settings/configuring-network-settings/configuring-the-ip-address-using-the-virtual-machine-console.md
+++ b/content/admin/configuring-settings/configuring-network-settings/configuring-the-ip-address-using-the-virtual-machine-console.md
@@ -1,6 +1,6 @@
---
title: Configuring the IP address using the virtual machine console
-intro: 'By default, {% data variables.product.prodname_ghe_server %} retrieves network settings via the dynamic host configuration protocol (DHCP). If your platform supports it, or if DHCP is unavailable, you can also configure the network settings using the virtual machine console.'
+intro: By default, {% data variables.product.prodname_ghe_server %} retrieves network settings via the dynamic host configuration protocol (DHCP). If your platform supports it, or if DHCP is unavailable, you can also configure the network settings using the virtual machine console.
redirect_from:
- /enterprise/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console
- /enterprise/admin/configuration/configuring-the-ip-address-using-the-virtual-machine-console
@@ -8,8 +8,8 @@ redirect_from:
- /admin/configuration/configuring-network-settings/configuring-the-ip-address-using-the-virtual-machine-console
versions:
ghes: '*'
-type: how_to
shortTitle: Set the IP using the console
+contentType: how-tos
---
> [!NOTE]
diff --git a/content/admin/configuring-settings/configuring-network-settings/configuring-time-synchronization.md b/content/admin/configuring-settings/configuring-network-settings/configuring-time-synchronization.md
index 95483a9e592d..549add358fbc 100644
--- a/content/admin/configuring-settings/configuring-network-settings/configuring-time-synchronization.md
+++ b/content/admin/configuring-settings/configuring-network-settings/configuring-time-synchronization.md
@@ -13,8 +13,8 @@ redirect_from:
- /admin/configuration/configuring-network-settings/configuring-time-synchronization
versions:
ghes: '*'
-type: how_to
shortTitle: Configure time settings
+contentType: how-tos
---
## Default NTP servers
diff --git a/content/admin/configuring-settings/configuring-network-settings/network-ports.md b/content/admin/configuring-settings/configuring-network-settings/network-ports.md
index be81d04ab56b..faac0e512c63 100644
--- a/content/admin/configuring-settings/configuring-network-settings/network-ports.md
+++ b/content/admin/configuring-settings/configuring-network-settings/network-ports.md
@@ -9,10 +9,10 @@ redirect_from:
- /enterprise/admin/configuration/network-ports
- /admin/configuration/network-ports
- /admin/configuration/configuring-network-settings/network-ports
-intro: 'Open network ports selectively based on the network services you need to expose for administrators, end users, and email support.'
+intro: Open network ports selectively based on the network services you need to expose for administrators, end users, and email support.
versions:
ghes: '*'
-type: reference
+contentType: reference
---
## Administrative ports
diff --git a/content/admin/configuring-settings/configuring-network-settings/using-github-enterprise-server-with-a-load-balancer.md b/content/admin/configuring-settings/configuring-network-settings/using-github-enterprise-server-with-a-load-balancer.md
index 7c092cbbca7c..cc6251a8658e 100644
--- a/content/admin/configuring-settings/configuring-network-settings/using-github-enterprise-server-with-a-load-balancer.md
+++ b/content/admin/configuring-settings/configuring-network-settings/using-github-enterprise-server-with-a-load-balancer.md
@@ -1,6 +1,6 @@
---
title: Using GitHub Enterprise Server with a load balancer
-intro: 'Use a load balancer in front of a single {% data variables.product.prodname_ghe_server %} instance or a pair of instances in a High Availability configuration.'
+intro: Use a load balancer in front of a single {% data variables.product.prodname_ghe_server %} instance or a pair of instances in a High Availability configuration.
redirect_from:
- /enterprise/admin/guides/installation/using-github-enterprise-with-a-load-balancer
- /enterprise/admin/installation/using-github-enterprise-server-with-a-load-balancer
@@ -9,8 +9,8 @@ redirect_from:
- /admin/configuration/configuring-network-settings/using-github-enterprise-server-with-a-load-balancer
versions:
ghes: '*'
-type: how_to
shortTitle: Use a load balancer
+contentType: how-tos
---
## About load balancers
diff --git a/content/admin/configuring-settings/configuring-network-settings/validating-your-domain-settings.md b/content/admin/configuring-settings/configuring-network-settings/validating-your-domain-settings.md
index c0c04a1ed4d8..cb8e33e33f0f 100644
--- a/content/admin/configuring-settings/configuring-network-settings/validating-your-domain-settings.md
+++ b/content/admin/configuring-settings/configuring-network-settings/validating-your-domain-settings.md
@@ -1,6 +1,6 @@
---
title: Validating your domain settings
-intro: 'Ensure that your domain settings are properly configured before booting up {% data variables.location.product_location %} for the first time.'
+intro: Ensure that your domain settings are properly configured before booting up {% data variables.location.product_location %} for the first time.
redirect_from:
- /enterprise/admin/installation/validating-your-domain-settings
- /enterprise/admin/configuration/validating-your-domain-settings
@@ -8,8 +8,8 @@ redirect_from:
- /admin/configuration/configuring-network-settings/validating-your-domain-settings
versions:
ghes: '*'
-type: how_to
shortTitle: Validate domain settings
+contentType: how-tos
---
{% data reusables.enterprise_site_admin_settings.access-settings %}
{% data reusables.enterprise_site_admin_settings.management-console %}
diff --git a/content/admin/configuring-settings/configuring-private-networking-for-hosted-compute-products/about-azure-private-networking-for-github-hosted-runners-in-your-enterprise.md b/content/admin/configuring-settings/configuring-private-networking-for-hosted-compute-products/about-azure-private-networking-for-github-hosted-runners-in-your-enterprise.md
index cb64d2029d32..3ca19927446c 100644
--- a/content/admin/configuring-settings/configuring-private-networking-for-hosted-compute-products/about-azure-private-networking-for-github-hosted-runners-in-your-enterprise.md
+++ b/content/admin/configuring-settings/configuring-private-networking-for-hosted-compute-products/about-azure-private-networking-for-github-hosted-runners-in-your-enterprise.md
@@ -1,15 +1,15 @@
---
title: About Azure private networking for GitHub-hosted runners in your enterprise
shortTitle: About Azure private networking
-intro: 'You can create a private network configuration for your enterprise to use {% data variables.product.company_short %}-hosted runners in your Azure Virtual Network(s) (VNET).'
+intro: You can create a private network configuration for your enterprise to use {% data variables.product.company_short %}-hosted runners in your Azure Virtual Network(s) (VNET).
versions:
ghec: '*'
-type: overview
-permissions: 'Enterprise owners can create private network configurations at the enterprise level to use {% data variables.product.company_short %}-hosted runners with an Azure VNET.'
+permissions: Enterprise owners can create private network configurations at the enterprise level to use {% data variables.product.company_short %}-hosted runners with an Azure VNET.
redirect_from:
- /actions/using-github-hosted-runners/connecting-to-a-private-network/about-using-github-hosted-runners-in-your-azure-virtual-network
- /admin/configuration/configuring-private-networking-for-hosted-compute-products/about-using-github-hosted-runners-in-your-azure-virtual-network
- /admin/configuration/configuring-private-networking-for-hosted-compute-products/about-azure-private-networking-for-github-hosted-runners-in-your-enterprise
+contentType: concepts
---
## About Azure private networking for {% data variables.product.company_short %}-hosted runners
diff --git a/content/admin/configuring-settings/configuring-private-networking-for-hosted-compute-products/about-networking-for-hosted-compute-products-in-your-enterprise.md b/content/admin/configuring-settings/configuring-private-networking-for-hosted-compute-products/about-networking-for-hosted-compute-products-in-your-enterprise.md
index dcd4dff6d55e..6203016df0ba 100644
--- a/content/admin/configuring-settings/configuring-private-networking-for-hosted-compute-products/about-networking-for-hosted-compute-products-in-your-enterprise.md
+++ b/content/admin/configuring-settings/configuring-private-networking-for-hosted-compute-products/about-networking-for-hosted-compute-products-in-your-enterprise.md
@@ -1,14 +1,14 @@
---
title: About networking for hosted compute products in your enterprise
shortTitle: About hosted compute networking
-intro: 'You can manage private networking for {% data variables.product.company_short %}-hosted products using network configurations.'
+intro: You can manage private networking for {% data variables.product.company_short %}-hosted products using network configurations.
permissions: Enterprise owners can configure private networking for hosted compute products at the enterprise level.
versions:
ghec: '*'
-type: overview
redirect_from:
- /admin/configuration/configuring-private-networking-for-hosted-compute-products/about-networking-for-hosted-compute-products
- /admin/configuration/configuring-private-networking-for-hosted-compute-products/about-networking-for-hosted-compute-products-in-your-enterprise
+contentType: concepts
---
## About network configurations
diff --git a/content/admin/configuring-settings/configuring-private-networking-for-hosted-compute-products/configuring-private-networking-for-github-hosted-runners-in-your-enterprise.md b/content/admin/configuring-settings/configuring-private-networking-for-hosted-compute-products/configuring-private-networking-for-github-hosted-runners-in-your-enterprise.md
index 5db1d827c214..eee2ee20d9f2 100644
--- a/content/admin/configuring-settings/configuring-private-networking-for-hosted-compute-products/configuring-private-networking-for-github-hosted-runners-in-your-enterprise.md
+++ b/content/admin/configuring-settings/configuring-private-networking-for-hosted-compute-products/configuring-private-networking-for-github-hosted-runners-in-your-enterprise.md
@@ -1,10 +1,9 @@
---
title: Configuring private networking for GitHub-hosted runners in your enterprise
shortTitle: Configuring private networking
-intro: 'Learn how to use {% data variables.product.company_short %}-hosted runners with an Azure private network.'
+intro: Learn how to use {% data variables.product.company_short %}-hosted runners with an Azure private network.
versions:
ghec: '*'
-type: how_to
permissions: Enterprise owners can configure private networking for GitHub-hosted runners at the enterprise level.
redirect_from:
- /actions/using-github-hosted-runners/connecting-to-a-private-network/configuring-an-azure-virtual-network-for-your-enterprise
@@ -14,6 +13,7 @@ redirect_from:
- /actions/using-github-hosted-runners/connecting-to-a-private-network/configuring-your-github-settings-for-use-with-azure-virtual-network
- /admin/configuration/configuring-private-networking-for-hosted-compute-products/configuring-private-networking-for-github-hosted-runners
- /admin/configuration/configuring-private-networking-for-hosted-compute-products/configuring-private-networking-for-github-hosted-runners-in-your-enterprise
+contentType: how-tos
---
## About Azure private networking for {% data variables.product.company_short %}-hosted runners
diff --git a/content/admin/configuring-settings/configuring-private-networking-for-hosted-compute-products/troubleshooting-azure-private-network-configurations-for-github-hosted-runners-in-your-enterprise.md b/content/admin/configuring-settings/configuring-private-networking-for-hosted-compute-products/troubleshooting-azure-private-network-configurations-for-github-hosted-runners-in-your-enterprise.md
index da37d06cc74e..9abcd3abf2f7 100644
--- a/content/admin/configuring-settings/configuring-private-networking-for-hosted-compute-products/troubleshooting-azure-private-network-configurations-for-github-hosted-runners-in-your-enterprise.md
+++ b/content/admin/configuring-settings/configuring-private-networking-for-hosted-compute-products/troubleshooting-azure-private-network-configurations-for-github-hosted-runners-in-your-enterprise.md
@@ -1,13 +1,13 @@
---
title: Troubleshooting Azure private network configurations for GitHub-hosted runners in your enterprise
shortTitle: Troubleshooting Azure private networking
-intro: 'Learn how to fix common issues while creating Azure private network configurations to use {% data variables.product.company_short %}-hosted runners with an Azure VNET.'
+intro: Learn how to fix common issues while creating Azure private network configurations to use {% data variables.product.company_short %}-hosted runners with an Azure VNET.
versions:
ghec: '*'
-type: how_to
permissions: Enterprise owners can configure private networking for GitHub-hosted runners at the enterprise level.
redirect_from:
- /admin/configuration/configuring-private-networking-for-hosted-compute-products/troubleshooting-azure-private-network-configurations-for-github-hosted-runners-in-your-enterprise
+contentType: how-tos
---
## Troubleshooting configuring private networking for {% data variables.product.company_short %}-hosted runners in your enterprise
diff --git a/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-applications.md b/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-applications.md
index 83461a99f548..2f0d237366ff 100644
--- a/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-applications.md
+++ b/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-applications.md
@@ -1,6 +1,6 @@
---
title: Configuring applications
-intro: 'You can configure internal application settings for {% data variables.location.product_location %}.'
+intro: You can configure internal application settings for {% data variables.location.product_location %}.
redirect_from:
- /enterprise/admin/installation/configuring-applications
- /enterprise/admin/configuration/configuring-applications
@@ -9,7 +9,7 @@ redirect_from:
- /admin/configuration/configuring-user-applications-for-your-enterprise/configuring-applications
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
## Adjusting image caching
diff --git a/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-email-for-notifications.md b/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-email-for-notifications.md
index 332e4557263c..72b029354116 100644
--- a/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-email-for-notifications.md
+++ b/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-email-for-notifications.md
@@ -1,6 +1,6 @@
---
title: Configuring email for notifications
-intro: 'To make it easy for users to respond quickly to activity, you can configure {% data variables.location.product_location %} to send email notifications for issue, pull request, and commit comments.'
+intro: To make it easy for users to respond quickly to activity, you can configure {% data variables.location.product_location %} to send email notifications for issue, pull request, and commit comments.
redirect_from:
- /enterprise/admin/guides/installation/email-configuration
- /enterprise/admin/articles/configuring-email
@@ -13,8 +13,8 @@ redirect_from:
permissions: Site administrators can configure email for notifications.
versions:
ghes: '*'
-type: how_to
shortTitle: Configure email notifications
+contentType: how-tos
---
## Configuring SMTP for your enterprise
diff --git a/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-github-pages-for-your-enterprise.md b/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-github-pages-for-your-enterprise.md
index 9e98918f0a7c..68c3921000cd 100644
--- a/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-github-pages-for-your-enterprise.md
+++ b/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-github-pages-for-your-enterprise.md
@@ -1,6 +1,6 @@
---
title: Configuring GitHub Pages for your enterprise
-intro: 'You can enable or disable {% data variables.product.prodname_pages %} for your enterprise and choose whether to make sites publicly accessible.'
+intro: You can enable or disable {% data variables.product.prodname_pages %} for your enterprise and choose whether to make sites publicly accessible.
redirect_from:
- /enterprise/admin/guides/installation/disabling-github-enterprise-pages
- /enterprise/admin/guides/installation/configuring-github-enterprise-pages
@@ -13,8 +13,8 @@ redirect_from:
- /admin/configuration/configuring-user-applications-for-your-enterprise/configuring-github-pages-for-your-enterprise
versions:
ghes: '*'
-type: how_to
shortTitle: Configure GitHub Pages
+contentType: how-tos
---
## Enabling public sites for {% data variables.product.prodname_pages %}
diff --git a/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-interactive-maps.md b/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-interactive-maps.md
index 30f0fe028b25..8d92bf47e1e3 100644
--- a/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-interactive-maps.md
+++ b/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-interactive-maps.md
@@ -1,13 +1,13 @@
---
title: Configuring interactive maps
-intro: 'You can enable the display of interactive maps in the web interface for {% data variables.location.product_location %}.'
+intro: You can enable the display of interactive maps in the web interface for {% data variables.location.product_location %}.
shortTitle: Configure interactive maps
-permissions: 'People with access to the {% data variables.enterprise.management_console %} can configure interactive maps.'
+permissions: People with access to the {% data variables.enterprise.management_console %} can configure interactive maps.
versions:
ghes: '*'
-type: how_to
redirect_from:
- /admin/configuration/configuring-user-applications-for-your-enterprise/configuring-interactive-maps
+contentType: how-tos
---
## About interactive maps
diff --git a/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-rate-limits.md b/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-rate-limits.md
index a7e611336537..cf44310a92d8 100644
--- a/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-rate-limits.md
+++ b/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-rate-limits.md
@@ -1,7 +1,7 @@
---
title: Configuring rate limits
-intro: 'You can set rate limits for {% data variables.product.prodname_ghe_server %} using the {% data variables.enterprise.management_console %}.'
-permissions: 'Site administrators can configure rate limits for a {% data variables.product.prodname_ghe_server %} instance.'
+intro: You can set rate limits for {% data variables.product.prodname_ghe_server %} using the {% data variables.enterprise.management_console %}.
+permissions: Site administrators can configure rate limits for a {% data variables.product.prodname_ghe_server %} instance.
redirect_from:
- /enterprise/admin/installation/configuring-rate-limits
- /enterprise/admin/configuration/configuring-rate-limits
@@ -10,7 +10,7 @@ redirect_from:
- /admin/configuration/configuring-user-applications-for-your-enterprise/configuring-rate-limits
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About rate limits for {% data variables.product.prodname_ghe_server %}
diff --git a/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-web-commit-signing.md b/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-web-commit-signing.md
index 771ac9d6d165..8dbf77106427 100644
--- a/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-web-commit-signing.md
+++ b/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-web-commit-signing.md
@@ -1,14 +1,14 @@
---
title: Configuring web commit signing
shortTitle: Configure web commit signing
-intro: 'You can enable auto-signing of commits made in the web interface of {% data variables.product.prodname_ghe_server %}.'
+intro: You can enable auto-signing of commits made in the web interface of {% data variables.product.prodname_ghe_server %}.
versions:
ghes: '*'
-type: how_to
-permissions: 'Site administrators'
+permissions: Site administrators
redirect_from:
- /admin/configuration/configuring-your-enterprise/configuring-web-commit-signing
- /admin/configuration/configuring-user-applications-for-your-enterprise/configuring-web-commit-signing
+contentType: how-tos
---
## About web commit signing
diff --git a/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/disabling-persistent-commit-verification.md b/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/disabling-persistent-commit-verification.md
index d38ad76ae381..760d5944a446 100644
--- a/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/disabling-persistent-commit-verification.md
+++ b/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/disabling-persistent-commit-verification.md
@@ -1,11 +1,11 @@
---
title: Disabling persistent commit verification
shortTitle: Disable persistent commit verification
-intro: 'You can disable persistent commit verification on {% data variables.product.prodname_ghe_server %} to reduce disk usage.'
+intro: You can disable persistent commit verification on {% data variables.product.prodname_ghe_server %} to reduce disk usage.
versions:
ghes: '>=3.17'
-type: how_to
-permissions: 'Site administrators'
+permissions: Site administrators
+contentType: how-tos
---
## About persistent commit verification
diff --git a/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/managing-github-mobile-for-your-enterprise.md b/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/managing-github-mobile-for-your-enterprise.md
index 5a243ef56a2c..0290945149b2 100644
--- a/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/managing-github-mobile-for-your-enterprise.md
+++ b/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/managing-github-mobile-for-your-enterprise.md
@@ -1,16 +1,16 @@
---
title: Managing GitHub Mobile for your enterprise
-intro: 'You can decide whether people can use {% data variables.product.prodname_mobile %} to connect to {% data variables.location.product_location %}.'
-permissions: 'Enterprise owners'
+intro: You can decide whether people can use {% data variables.product.prodname_mobile %} to connect to {% data variables.location.product_location %}.
+permissions: Enterprise owners
versions:
ghes: '*'
-type: how_to
redirect_from:
- /admin/configuration/configuring-your-enterprise/managing-github-for-mobile-for-your-enterprise
- /admin/configuration/managing-github-for-mobile-for-your-enterprise
- /admin/configuration/configuring-your-enterprise/managing-github-mobile-for-your-enterprise
- /admin/configuration/configuring-user-applications-for-your-enterprise/managing-github-mobile-for-your-enterprise
shortTitle: Manage GitHub Mobile
+contentType: how-tos
---
## About {% data variables.product.prodname_mobile %}
diff --git a/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise.md b/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise.md
index 707e52c7f9c9..ba6f5232f023 100644
--- a/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise.md
+++ b/content/admin/configuring-settings/configuring-user-applications-for-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise.md
@@ -1,13 +1,12 @@
---
title: Verifying or approving a domain for your enterprise
shortTitle: Verify or approve a domain
-intro: 'You can verify your ownership of domains with {% data variables.product.company_short %} to confirm the identity of organizations owned by your enterprise account. You can also approve domains where organization members can receive email notifications.'
+intro: You can verify your ownership of domains with {% data variables.product.company_short %} to confirm the identity of organizations owned by your enterprise account. You can also approve domains where organization members can receive email notifications.
product: '{% data reusables.gated-features.verify-and-approve-domain %}'
versions:
ghec: '*'
ghes: '*'
permissions: Enterprise owners can verify or approve a domain for an enterprise account.
-type: how_to
redirect_from:
- /admin/configuration/configuring-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise-account
- /github/setting-up-and-managing-your-enterprise/managing-your-enterprise-account/verifying-or-approving-a-domain-for-your-enterprise-account
@@ -19,6 +18,7 @@ redirect_from:
- /admin/policies/verifying-or-approving-a-domain-for-your-enterprise
- /admin/configuration/configuring-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise
- /admin/configuration/configuring-user-applications-for-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise
+contentType: how-tos
---
## About verification of domains
diff --git a/content/admin/configuring-settings/hardening-security-for-your-enterprise/configuring-host-keys-for-your-instance.md b/content/admin/configuring-settings/hardening-security-for-your-enterprise/configuring-host-keys-for-your-instance.md
index a42427752310..98576fc7de47 100644
--- a/content/admin/configuring-settings/hardening-security-for-your-enterprise/configuring-host-keys-for-your-instance.md
+++ b/content/admin/configuring-settings/hardening-security-for-your-enterprise/configuring-host-keys-for-your-instance.md
@@ -1,14 +1,14 @@
---
title: Configuring host keys for your instance
shortTitle: Configure host keys
-intro: 'You can increase the security of {% data variables.location.product_location %} by configuring the algorithms that your instance uses to generate and advertise host keys for incoming SSH connections.'
+intro: You can increase the security of {% data variables.location.product_location %} by configuring the algorithms that your instance uses to generate and advertise host keys for incoming SSH connections.
permissions: Site administrators
redirect_from:
- /admin/configuration/configuring-your-enterprise/configuring-host-keys-for-your-instance
- /admin/configuration/hardening-security-for-your-enterprise/configuring-host-keys-for-your-instance
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About host keys for your instance
diff --git a/content/admin/configuring-settings/hardening-security-for-your-enterprise/configuring-ssh-connections-to-your-instance.md b/content/admin/configuring-settings/hardening-security-for-your-enterprise/configuring-ssh-connections-to-your-instance.md
index f251dc0ec8fb..da299408ffd5 100644
--- a/content/admin/configuring-settings/hardening-security-for-your-enterprise/configuring-ssh-connections-to-your-instance.md
+++ b/content/admin/configuring-settings/hardening-security-for-your-enterprise/configuring-ssh-connections-to-your-instance.md
@@ -1,14 +1,14 @@
---
title: Configuring SSH connections to your instance
shortTitle: Configure SSH connections
-intro: 'You can increase the security of {% data variables.location.product_location %} by configuring the SSH algorithms that clients can use to establish a connection.'
+intro: You can increase the security of {% data variables.location.product_location %} by configuring the SSH algorithms that clients can use to establish a connection.
permissions: Site administrators
redirect_from:
- /admin/configuration/configuring-your-enterprise/configuring-ssh-connections-to-your-instance
- /admin/configuration/hardening-security-for-your-enterprise/configuring-ssh-connections-to-your-instance
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About SSH connections to your instance
diff --git a/content/admin/configuring-settings/hardening-security-for-your-enterprise/configuring-the-referrer-policy-for-your-enterprise.md b/content/admin/configuring-settings/hardening-security-for-your-enterprise/configuring-the-referrer-policy-for-your-enterprise.md
index 3adfccffce8f..c6d9b0aa7f53 100644
--- a/content/admin/configuring-settings/hardening-security-for-your-enterprise/configuring-the-referrer-policy-for-your-enterprise.md
+++ b/content/admin/configuring-settings/hardening-security-for-your-enterprise/configuring-the-referrer-policy-for-your-enterprise.md
@@ -1,13 +1,13 @@
---
title: Configuring the referrer policy for your enterprise
shortTitle: Configure referrer policy
-intro: 'You can increase the privacy of {% data variables.location.product_location %} by configuring the policy for cross-origin requests.'
+intro: You can increase the privacy of {% data variables.location.product_location %} by configuring the policy for cross-origin requests.
redirect_from:
- /admin/configuration/configuring-your-enterprise/configuring-the-referrer-policy-for-your-enterprise
- /admin/configuration/hardening-security-for-your-enterprise/configuring-the-referrer-policy-for-your-enterprise
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About the referrer policy for your enterprise
diff --git a/content/admin/configuring-settings/hardening-security-for-your-enterprise/configuring-tls-and-ssh-ciphers.md b/content/admin/configuring-settings/hardening-security-for-your-enterprise/configuring-tls-and-ssh-ciphers.md
index 442a2c82c8b0..e8e5342307c0 100644
--- a/content/admin/configuring-settings/hardening-security-for-your-enterprise/configuring-tls-and-ssh-ciphers.md
+++ b/content/admin/configuring-settings/hardening-security-for-your-enterprise/configuring-tls-and-ssh-ciphers.md
@@ -1,7 +1,7 @@
---
title: Configuring TLS and SSH ciphers
shortTitle: Configure TLS and SSH ciphers
-intro: 'You can configure the cipher suites and cryptographic algorithms that {% data variables.product.prodname_ghe_server %} uses for TLS and SSH connections to meet specific compliance or security requirements.'
+intro: You can configure the cipher suites and cryptographic algorithms that {% data variables.product.prodname_ghe_server %} uses for TLS and SSH connections to meet specific compliance or security requirements.
permissions: Site administrators
redirect_from:
- /admin/configuring-settings/hardening-security-for-your-enterprise/configuring-tls#configuring-cipher-suites-and-cryptographic-algorithms
@@ -9,7 +9,7 @@ redirect_from:
- /admin/configuration/hardening-security-for-your-enterprise/configuring-tls#configuring-cipher-suites-and-cryptographic-algorithms
versions:
ghes: '>=3.19'
-type: how_to
+contentType: how-tos
---
diff --git a/content/admin/configuring-settings/hardening-security-for-your-enterprise/configuring-tls.md b/content/admin/configuring-settings/hardening-security-for-your-enterprise/configuring-tls.md
index 0a24759c7d60..d0493bab98dd 100644
--- a/content/admin/configuring-settings/hardening-security-for-your-enterprise/configuring-tls.md
+++ b/content/admin/configuring-settings/hardening-security-for-your-enterprise/configuring-tls.md
@@ -1,6 +1,6 @@
---
title: Configuring TLS
-intro: 'You can configure Transport Layer Security (TLS) on {% data variables.location.product_location %} so that you can use a certificate that is signed by a trusted certificate authority.'
+intro: You can configure Transport Layer Security (TLS) on {% data variables.location.product_location %} so that you can use a certificate that is signed by a trusted certificate authority.
redirect_from:
- /enterprise/admin/articles/ssl-configuration
- /enterprise/admin/guides/installation/about-tls
@@ -11,7 +11,7 @@ redirect_from:
- /admin/configuration/hardening-security-for-your-enterprise/configuring-tls
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About Transport Layer Security
diff --git a/content/admin/configuring-settings/hardening-security-for-your-enterprise/enabling-private-mode.md b/content/admin/configuring-settings/hardening-security-for-your-enterprise/enabling-private-mode.md
index 4113e9a026f6..fbe0cf28c7dd 100644
--- a/content/admin/configuring-settings/hardening-security-for-your-enterprise/enabling-private-mode.md
+++ b/content/admin/configuring-settings/hardening-security-for-your-enterprise/enabling-private-mode.md
@@ -1,6 +1,6 @@
---
title: Enabling private mode
-intro: 'In private mode, {% data variables.product.prodname_ghe_server %} requires every user to sign in to access the installation.'
+intro: In private mode, {% data variables.product.prodname_ghe_server %} requires every user to sign in to access the installation.
redirect_from:
- /enterprise/admin/articles/private-mode
- /enterprise/admin/guides/installation/security
@@ -12,7 +12,7 @@ redirect_from:
- /admin/configuration/hardening-security-for-your-enterprise/enabling-private-mode
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
You must enable private mode if {% data variables.location.product_location %} is publicly accessible over the Internet. In private mode, users cannot anonymously clone repositories. If built-in authentication is also enabled, an administrator must invite new users to create an account on the instance. For more information, see [AUTOTITLE](/admin/identity-and-access-management/using-built-in-authentication/configuring-built-in-authentication).
diff --git a/content/admin/configuring-settings/hardening-security-for-your-enterprise/enabling-subdomain-isolation.md b/content/admin/configuring-settings/hardening-security-for-your-enterprise/enabling-subdomain-isolation.md
index 3a208f70570a..0977ba1412da 100644
--- a/content/admin/configuring-settings/hardening-security-for-your-enterprise/enabling-subdomain-isolation.md
+++ b/content/admin/configuring-settings/hardening-security-for-your-enterprise/enabling-subdomain-isolation.md
@@ -1,6 +1,6 @@
---
title: Enabling subdomain isolation
-intro: 'You can set up subdomain isolation to securely separate user-supplied content from other portions of your {% data variables.product.prodname_ghe_server %} appliance.'
+intro: You can set up subdomain isolation to securely separate user-supplied content from other portions of your {% data variables.product.prodname_ghe_server %} appliance.
redirect_from:
- /enterprise/admin/guides/installation/about-subdomain-isolation
- /enterprise/admin/installation/enabling-subdomain-isolation
@@ -10,8 +10,8 @@ redirect_from:
- /admin/configuration/hardening-security-for-your-enterprise/enabling-subdomain-isolation
versions:
ghes: '*'
-type: how_to
shortTitle: Enable subdomain isolation
+contentType: how-tos
---
## About subdomain isolation
diff --git a/content/admin/configuring-settings/hardening-security-for-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list.md b/content/admin/configuring-settings/hardening-security-for-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list.md
index 1303bcdbd74e..410dc75490bd 100644
--- a/content/admin/configuring-settings/hardening-security-for-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list.md
+++ b/content/admin/configuring-settings/hardening-security-for-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list.md
@@ -5,12 +5,12 @@ intro: You can restrict access to your enterprise and only allow access to your
permissions: Enterprise owners can configure IP allow lists.
versions:
ghec: '*'
-type: how_to
redirect_from:
- /admin/configuration/restricting-network-traffic-to-your-enterprise
- /admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise
- /admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list
- /admin/configuration/hardening-security-for-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list
+contentType: how-tos
---
## About network traffic restrictions
diff --git a/content/admin/configuring-settings/hardening-security-for-your-enterprise/troubleshooting-tls-errors.md b/content/admin/configuring-settings/hardening-security-for-your-enterprise/troubleshooting-tls-errors.md
index ac300b42150c..9133262a1463 100644
--- a/content/admin/configuring-settings/hardening-security-for-your-enterprise/troubleshooting-tls-errors.md
+++ b/content/admin/configuring-settings/hardening-security-for-your-enterprise/troubleshooting-tls-errors.md
@@ -1,6 +1,6 @@
---
title: Troubleshooting TLS errors
-intro: 'If you run into TLS issues with your appliance, you can take actions to resolve them.'
+intro: If you run into TLS issues with your appliance, you can take actions to resolve them.
redirect_from:
- /enterprise/admin/articles/troubleshooting-ssl-errors
- /enterprise/admin/categories/dns-ssl-and-subdomain-configuration
@@ -12,8 +12,8 @@ redirect_from:
- /admin/configuration/hardening-security-for-your-enterprise/troubleshooting-tls-errors
versions:
ghes: '*'
-type: how_to
shortTitle: Troubleshoot TLS errors
+contentType: how-tos
---
## Removing the passphrase from your key file
diff --git a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/control-offboarding.md b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/control-offboarding.md
index ad0977cf895a..fdc92c4ed839 100644
--- a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/control-offboarding.md
+++ b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/control-offboarding.md
@@ -1,13 +1,13 @@
---
title: Controlling user offboarding with the unaffiliated users policy
allowTitleToDifferFromFilename: true
-intro: 'Set a policy to determine what happens when a user is removed from every organization in your enterprise.'
+intro: Set a policy to determine what happens when a user is removed from every organization in your enterprise.
versions:
ghec: '*'
-permissions: 'Enterprise owners'
-product: 'Enterprises with personal accounts on {% data variables.product.prodname_dotcom_the_website %}'
+permissions: Enterprise owners
+product: Enterprises with personal accounts on {% data variables.product.prodname_dotcom_the_website %}
shortTitle: Control offboarding
-type: how_to
+contentType: how-tos
---
## About the unaffiliated users policy
diff --git a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-governance.md b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-governance.md
index 147daa8be363..8e350ac993d4 100644
--- a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-governance.md
+++ b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-governance.md
@@ -1,12 +1,12 @@
---
title: Enforcing code governance in your enterprise with rulesets
allowTitleToDifferFromFilename: true
-intro: 'You can create a ruleset to target multiple repositories in your enterprise.'
+intro: You can create a ruleset to target multiple repositories in your enterprise.
versions:
feature: enterprise-code-rulesets
-permissions: 'Enterprise owners'
+permissions: Enterprise owners
shortTitle: Create rulesets
-type: how_to
+contentType: how-tos
---
## Introduction
diff --git a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-security-and-analysis-for-your-enterprise.md b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-security-and-analysis-for-your-enterprise.md
index 500c059cb12e..926884d7e739 100644
--- a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-security-and-analysis-for-your-enterprise.md
+++ b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-security-and-analysis-for-your-enterprise.md
@@ -1,12 +1,11 @@
---
title: Enforcing policies for code security and analysis for your enterprise
-intro: 'You can enforce policies to manage the use of code security and analysis features within your enterprise''s organizations.'
-permissions: 'Enterprise owners'
+intro: You can enforce policies to manage the use of code security and analysis features within your enterprise's organizations.
+permissions: Enterprise owners
product: '{% data reusables.gated-features.ghas-ghec %}'
versions:
ghec: '*'
ghes: '*'
-type: how_to
redirect_from:
- /admin/policies/enforcing-policies-for-advanced-security-in-your-enterprise
- /github/setting-up-and-managing-your-enterprise/enforcing-policies-for-advanced-security-in-your-enterprise-account
@@ -20,6 +19,7 @@ redirect_from:
- /github/setting-up-and-managing-your-enterprise/setting-policies-for-organizations-in-your-enterprise-account/enforcing-a-policy-on-dependency-insights-in-your-enterprise-account
- /admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-security-and-analysis-for-your-enterprise
shortTitle: Security & analysis
+contentType: how-tos
---
## About policies for using security features in your enterprise
diff --git a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise.md b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise.md
index 4ca35b9bd175..1dec10bf321b 100644
--- a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise.md
+++ b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise.md
@@ -1,7 +1,7 @@
---
title: Enforcing policies for GitHub Actions in your enterprise
-intro: "You can enforce policies to manage how {% data variables.product.prodname_actions %} can be used within your enterprise."
-permissions: "Enterprise owners"
+intro: You can enforce policies to manage how {% data variables.product.prodname_actions %} can be used within your enterprise.
+permissions: Enterprise owners
redirect_from:
- /enterprise/admin/github-actions/enforcing-github-actions-policies-for-your-enterprise
- /admin/github-actions/enforcing-github-actions-policies-for-your-enterprise
@@ -17,8 +17,8 @@ redirect_from:
versions:
ghec: '*'
ghes: '*'
-type: how_to
shortTitle: GitHub Actions policies
+contentType: how-tos
---
## What are policies for {% data variables.product.prodname_actions %}?
diff --git a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-codespaces-in-your-enterprise.md b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-codespaces-in-your-enterprise.md
index 1a3578fa1abc..87fbe7a77219 100644
--- a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-codespaces-in-your-enterprise.md
+++ b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-codespaces-in-your-enterprise.md
@@ -1,13 +1,13 @@
---
title: Enforcing policies for GitHub Codespaces in your enterprise
shortTitle: GitHub Codespaces policies
-intro: 'You can enforce policies for {% data variables.product.prodname_github_codespaces %} within your enterprise''s organizations.'
-permissions: 'Enterprise owners can enforce policies for {% data variables.product.prodname_github_codespaces %} in an enterprise.'
+intro: You can enforce policies for {% data variables.product.prodname_github_codespaces %} within your enterprise's organizations.
+permissions: Enterprise owners can enforce policies for {% data variables.product.prodname_github_codespaces %} in an enterprise.
versions:
ghec: '*'
-type: how_to
redirect_from:
- /admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-codespaces-in-your-enterprise
+contentType: how-tos
---
>[!NOTE] {% data variables.product.prodname_github_codespaces %} is not available for enterprises that use {% data variables.enterprise.data_residency %}.
diff --git a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise.md b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise.md
index 536b802f3a88..0f74f2a15764 100644
--- a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise.md
+++ b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise.md
@@ -1,14 +1,14 @@
---
title: Enforcing policies for GitHub Copilot in your enterprise
-intro: 'You can enforce policies for {% data variables.product.prodname_copilot %} within your enterprise''s organizations, or allow policies to be set in each organization.'
-permissions: 'Enterprise owners can enforce policies for {% data variables.product.prodname_copilot %} in an enterprise.'
+intro: You can enforce policies for {% data variables.product.prodname_copilot %} within your enterprise's organizations, or allow policies to be set in each organization.
+permissions: Enterprise owners can enforce policies for {% data variables.product.prodname_copilot %} in an enterprise.
product: '{% data reusables.gated-features.copilot-billing %}'
versions:
ghec: '*'
-type: how_to
shortTitle: GitHub Copilot policies
redirect_from:
- /admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise
+contentType: how-tos
---
Enterprise admins can:
diff --git a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-sponsors-in-your-enterprise.md b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-sponsors-in-your-enterprise.md
index f5d112e8b816..cb00e879a600 100644
--- a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-sponsors-in-your-enterprise.md
+++ b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-sponsors-in-your-enterprise.md
@@ -1,13 +1,13 @@
---
title: Enforcing policies for GitHub Sponsors in your enterprise
intro: Enterprise owners can control whether to allow the enterprise's organizations to sponsor open source projects.
-permissions: 'Enterprise owners can enforce policies for {% data variables.product.prodname_sponsors %} in an enterprise.'
+permissions: Enterprise owners can enforce policies for {% data variables.product.prodname_sponsors %} in an enterprise.
versions:
feature: enterprise-orgs-sponsors-with-cc
-type: how_to
shortTitle: '{% data variables.product.prodname_sponsors %} policies'
redirect_from:
- /admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-sponsors-in-your-enterprise
+contentType: how-tos
---
## About enterprise policies for {% data variables.product.prodname_sponsors %}
diff --git a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-projects-in-your-enterprise.md b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-projects-in-your-enterprise.md
index 2423459abc5b..6c0cb66df0d0 100644
--- a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-projects-in-your-enterprise.md
+++ b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-projects-in-your-enterprise.md
@@ -1,6 +1,6 @@
---
title: Enforcing policies for projects in your enterprise
-intro: 'You can enforce policies for {% data variables.projects.projects_v2_and_v1 %} within your enterprise''s organizations, or allow policies to be set in each organization.'
+intro: You can enforce policies for {% data variables.projects.projects_v2_and_v1 %} within your enterprise's organizations, or allow policies to be set in each organization.
permissions: Enterprise owners can enforce policies for projects in an enterprise.
redirect_from:
- /articles/enforcing-project-board-settings-for-organizations-in-your-business-account
@@ -14,8 +14,8 @@ redirect_from:
versions:
ghec: '*'
ghes: '*'
-type: how_to
shortTitle: Projects policies
+contentType: how-tos
---
## About policies for projects in your enterprise
diff --git a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise.md b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise.md
index 7589cf60ee58..d3c13e56ed79 100644
--- a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise.md
+++ b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise.md
@@ -1,6 +1,6 @@
---
title: Enforcing policies for security settings in your enterprise
-intro: 'You can enforce policies to manage security settings in your enterprise''s organizations, or allow policies to be set in each organization.'
+intro: You can enforce policies to manage security settings in your enterprise's organizations, or allow policies to be set in each organization.
permissions: Enterprise owners can enforce policies for security settings in an enterprise.
redirect_from:
- /articles/enforcing-security-settings-for-organizations-in-your-business-account
@@ -14,8 +14,8 @@ redirect_from:
versions:
ghec: '*'
ghes: '*'
-type: how_to
shortTitle: Policies for security settings
+contentType: how-tos
---
## About policies for security settings in your enterprise
diff --git a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md
index ee47b20ed411..24aa20cf7d07 100644
--- a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md
+++ b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md
@@ -1,6 +1,6 @@
---
title: Enforcing repository management policies in your enterprise
-intro: 'You can enforce policies for repository management within your enterprise''s organizations, or allow policies to be set in each organization.'
+intro: You can enforce policies for repository management within your enterprise's organizations, or allow policies to be set in each organization.
permissions: Enterprise owners can enforce policies for repository management in an enterprise.
redirect_from:
- /enterprise/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance
@@ -37,8 +37,8 @@ redirect_from:
versions:
ghec: '*'
ghes: '*'
-type: how_to
shortTitle: Repository management policies
+contentType: how-tos
---
## About policies for repository management in your enterprise
diff --git a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/restricting-email-notifications-for-your-enterprise.md b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/restricting-email-notifications-for-your-enterprise.md
index c01fa12bc056..3f4e13ae5734 100644
--- a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/restricting-email-notifications-for-your-enterprise.md
+++ b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/restricting-email-notifications-for-your-enterprise.md
@@ -6,7 +6,6 @@ versions:
ghec: '*'
ghes: '*'
permissions: Enterprise owners can restrict email notifications for an enterprise.
-type: how_to
redirect_from:
- /admin/policies/restricting-email-notifications-for-your-enterprise
- /github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains
@@ -14,6 +13,7 @@ redirect_from:
- /github/setting-up-and-managing-your-enterprise/setting-policies-for-organizations-in-your-enterprise-account/restricting-email-notifications-for-your-enterprise-account
- /admin/policies/enforcing-policies-for-your-enterprise/restricting-email-notifications-for-your-enterprise
shortTitle: Restrict email notifications
+contentType: how-tos
---
## About email restrictions for your enterprise
diff --git a/content/admin/enforcing-policies/enforcing-policy-with-pre-receive-hooks/about-pre-receive-hooks.md b/content/admin/enforcing-policies/enforcing-policy-with-pre-receive-hooks/about-pre-receive-hooks.md
index 0c4c3105a438..5ea4fd045b12 100644
--- a/content/admin/enforcing-policies/enforcing-policy-with-pre-receive-hooks/about-pre-receive-hooks.md
+++ b/content/admin/enforcing-policies/enforcing-policy-with-pre-receive-hooks/about-pre-receive-hooks.md
@@ -8,7 +8,7 @@ redirect_from:
- /admin/policies/enforcing-policy-with-pre-receive-hooks/about-pre-receive-hooks
versions:
ghes: '*'
-type: overview
+contentType: concepts
---
## About pre-receive hooks
diff --git a/content/admin/enforcing-policies/enforcing-policy-with-pre-receive-hooks/creating-a-pre-receive-hook-environment.md b/content/admin/enforcing-policies/enforcing-policy-with-pre-receive-hooks/creating-a-pre-receive-hook-environment.md
index 94b71870c02a..b8977d85deb3 100644
--- a/content/admin/enforcing-policies/enforcing-policy-with-pre-receive-hooks/creating-a-pre-receive-hook-environment.md
+++ b/content/admin/enforcing-policies/enforcing-policy-with-pre-receive-hooks/creating-a-pre-receive-hook-environment.md
@@ -1,6 +1,6 @@
---
title: Creating a pre-receive hook environment
-intro: 'To execute pre-receive hooks, use either the default pre-receive environment, or create a custom environment.'
+intro: To execute pre-receive hooks, use either the default pre-receive environment, or create a custom environment.
redirect_from:
- /enterprise/admin/developer-workflow/creating-a-pre-receive-hook-environment
- /enterprise/admin/policies/creating-a-pre-receive-hook-environment
@@ -8,8 +8,8 @@ redirect_from:
- /admin/policies/enforcing-policy-with-pre-receive-hooks/creating-a-pre-receive-hook-environment
versions:
ghes: '*'
-type: how_to
shortTitle: Pre-receive hook environments
+contentType: how-tos
---
A pre-receive environment for {% data variables.product.prodname_ghe_server %} is a Linux [`chroot`](https://en.wikipedia.org/wiki/Chroot) environment. Because pre-receive hooks execute on every push event, they should be fast and lightweight. The environment needed for such checks will typically be minimal.
diff --git a/content/admin/enforcing-policies/enforcing-policy-with-pre-receive-hooks/creating-a-pre-receive-hook-script.md b/content/admin/enforcing-policies/enforcing-policy-with-pre-receive-hooks/creating-a-pre-receive-hook-script.md
index 6f370b6d75ad..4a8c7428769e 100644
--- a/content/admin/enforcing-policies/enforcing-policy-with-pre-receive-hooks/creating-a-pre-receive-hook-script.md
+++ b/content/admin/enforcing-policies/enforcing-policy-with-pre-receive-hooks/creating-a-pre-receive-hook-script.md
@@ -8,8 +8,8 @@ redirect_from:
- /admin/policies/enforcing-policy-with-pre-receive-hooks/creating-a-pre-receive-hook-script
versions:
ghes: '*'
-type: how_to
shortTitle: Pre-receive hook scripts
+contentType: how-tos
---
{% data reusables.enterprise_site_admin_settings.pre-receive-hook-examples %}
diff --git a/content/admin/enforcing-policies/enforcing-policy-with-pre-receive-hooks/managing-pre-receive-hooks-on-your-instance.md b/content/admin/enforcing-policies/enforcing-policy-with-pre-receive-hooks/managing-pre-receive-hooks-on-your-instance.md
index c696efc09918..fa48d09af281 100644
--- a/content/admin/enforcing-policies/enforcing-policy-with-pre-receive-hooks/managing-pre-receive-hooks-on-your-instance.md
+++ b/content/admin/enforcing-policies/enforcing-policy-with-pre-receive-hooks/managing-pre-receive-hooks-on-your-instance.md
@@ -1,6 +1,6 @@
---
title: Managing pre-receive hooks on your instance
-intro: 'Configure how people will use pre-receive hooks on {% data variables.location.product_location %}.'
+intro: Configure how people will use pre-receive hooks on {% data variables.location.product_location %}.
redirect_from:
- /enterprise/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance
- /enterprise/admin/guides/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-appliance
@@ -10,8 +10,8 @@ redirect_from:
- /admin/policies/enforcing-policy-with-pre-receive-hooks/managing-pre-receive-hooks-on-your-instance
versions:
ghes: '*'
-type: how_to
shortTitle: Manage pre-receive hooks
+contentType: how-tos
---
## Creating pre-receive hooks
diff --git a/content/admin/installing-your-enterprise-server/index.md b/content/admin/installing-your-enterprise-server/index.md
index 75e7d6a52338..7e5d5297f849 100644
--- a/content/admin/installing-your-enterprise-server/index.md
+++ b/content/admin/installing-your-enterprise-server/index.md
@@ -1,8 +1,8 @@
---
-title: 'Installing {% data variables.product.prodname_enterprise %}'
+title: Installing {% data variables.product.prodname_enterprise %}
allowTitleToDifferFromFilename: true
shortTitle: Installation
-intro: 'System administrators and operations and security specialists can install {% data variables.product.prodname_ghe_server %}.'
+intro: System administrators and operations and security specialists can install {% data variables.product.prodname_ghe_server %}.
redirect_from:
- /enterprise/admin-guide
- /enterprise/admin/guides/installation
@@ -13,9 +13,9 @@ redirect_from:
- /admin/installation
versions:
ghes: '*'
-type: how_to
children:
- /setting-up-a-github-enterprise-server-instance
+contentType: how-tos
---
For more information, or to purchase {% data variables.product.prodname_enterprise %}, see [{% data variables.product.prodname_enterprise %}](https://github.com/enterprise).
diff --git a/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-aws.md b/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-aws.md
index aa1ee3a53a2a..42bc05583240 100644
--- a/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-aws.md
+++ b/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-aws.md
@@ -1,6 +1,6 @@
---
title: Installing GitHub Enterprise Server on AWS
-intro: 'To install {% data variables.product.prodname_ghe_server %} on Amazon Web Services (AWS), you must launch an Amazon Elastic Compute Cloud (EC2) instance and create and attach a separate Amazon Elastic Block Store (EBS) data volume.'
+intro: To install {% data variables.product.prodname_ghe_server %} on Amazon Web Services (AWS), you must launch an Amazon Elastic Compute Cloud (EC2) instance and create and attach a separate Amazon Elastic Block Store (EBS) data volume.
redirect_from:
- /enterprise/admin/guides/installation/installing-github-enterprise-on-aws
- /enterprise/admin/installation/installing-github-enterprise-server-on-aws
@@ -8,8 +8,8 @@ redirect_from:
- /admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-aws
versions:
ghes: '*'
-type: tutorial
shortTitle: Install on AWS
+contentType: tutorials
---
## Prerequisites
diff --git a/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-azure.md b/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-azure.md
index 03ebbd1d32ea..4ba36fa22c85 100644
--- a/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-azure.md
+++ b/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-azure.md
@@ -1,6 +1,6 @@
---
title: Installing GitHub Enterprise Server on Azure
-intro: 'To install {% data variables.product.prodname_ghe_server %} on Azure, you must deploy onto a memory-optimized instance that supports premium storage.'
+intro: To install {% data variables.product.prodname_ghe_server %} on Azure, you must deploy onto a memory-optimized instance that supports premium storage.
redirect_from:
- /enterprise/admin/guides/installation/installing-github-enterprise-on-azure
- /enterprise/admin/installation/installing-github-enterprise-server-on-azure
@@ -8,8 +8,8 @@ redirect_from:
- /admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-azure
versions:
ghes: '*'
-type: tutorial
shortTitle: Install on Azure
+contentType: tutorials
---
You can deploy {% data variables.product.prodname_ghe_server %} on global Azure or Azure Government.
diff --git a/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-google-cloud-platform.md b/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-google-cloud-platform.md
index 36684df82766..4ab7d2e25f8c 100644
--- a/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-google-cloud-platform.md
+++ b/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-google-cloud-platform.md
@@ -1,6 +1,6 @@
---
title: Installing GitHub Enterprise Server on Google Cloud Platform
-intro: 'To install {% data variables.product.prodname_ghe_server %} on Google Cloud Platform, you must deploy onto a supported machine type and use a persistent standard disk or a persistent SSD.'
+intro: To install {% data variables.product.prodname_ghe_server %} on Google Cloud Platform, you must deploy onto a supported machine type and use a persistent standard disk or a persistent SSD.
redirect_from:
- /enterprise/admin/guides/installation/installing-github-enterprise-on-google-cloud-platform
- /enterprise/admin/installation/installing-github-enterprise-server-on-google-cloud-platform
@@ -8,8 +8,8 @@ redirect_from:
- /admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-google-cloud-platform
versions:
ghes: '*'
-type: tutorial
shortTitle: Install on GCP
+contentType: tutorials
---
## Prerequisites
diff --git a/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-hyper-v.md b/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-hyper-v.md
index d8a0a33118e0..8e13e8eb898f 100644
--- a/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-hyper-v.md
+++ b/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-hyper-v.md
@@ -1,6 +1,6 @@
---
title: Installing GitHub Enterprise Server on Hyper-V
-intro: 'To install {% data variables.product.prodname_ghe_server %} on Hyper-V, you must deploy onto a machine running Windows Server 2008 through Windows Server 2022.'
+intro: To install {% data variables.product.prodname_ghe_server %} on Hyper-V, you must deploy onto a machine running Windows Server 2008 through Windows Server 2022.
redirect_from:
- /enterprise/admin/guides/installation/installing-github-enterprise-on-hyper-v
- /enterprise/admin/installation/installing-github-enterprise-server-on-hyper-v
@@ -8,8 +8,8 @@ redirect_from:
- /admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-hyper-v
versions:
ghes: '*'
-type: tutorial
shortTitle: Install on Hyper-V
+contentType: tutorials
---
## Prerequisites
diff --git a/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-openstack-kvm.md b/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-openstack-kvm.md
index 4ed39b9cf158..41bc40d6e5d4 100644
--- a/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-openstack-kvm.md
+++ b/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-openstack-kvm.md
@@ -1,6 +1,6 @@
---
title: Installing GitHub Enterprise Server on OpenStack KVM
-intro: 'To install {% data variables.product.prodname_ghe_server %} on OpenStack KVM, you must have OpenStack access and download the {% data variables.product.prodname_ghe_server %} QCOW2 image.'
+intro: To install {% data variables.product.prodname_ghe_server %} on OpenStack KVM, you must have OpenStack access and download the {% data variables.product.prodname_ghe_server %} QCOW2 image.
redirect_from:
- /enterprise/admin/guides/installation/installing-github-enterprise-on-openstack-kvm
- /enterprise/admin/installation/installing-github-enterprise-server-on-openstack-kvm
@@ -8,8 +8,8 @@ redirect_from:
- /admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-openstack-kvm
versions:
ghes: '*'
-type: tutorial
shortTitle: Install on OpenStack
+contentType: tutorials
---
## Prerequisites
diff --git a/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-vmware.md b/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-vmware.md
index ecb09df04837..ba8088ecb505 100644
--- a/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-vmware.md
+++ b/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-vmware.md
@@ -1,6 +1,6 @@
---
title: Installing GitHub Enterprise Server on VMware
-intro: 'To install {% data variables.product.prodname_ghe_server %} on VMware, you must download the VMware vSphere client, and then download and deploy the {% data variables.product.prodname_ghe_server %} software.'
+intro: To install {% data variables.product.prodname_ghe_server %} on VMware, you must download the VMware vSphere client, and then download and deploy the {% data variables.product.prodname_ghe_server %} software.
redirect_from:
- /enterprise/admin/articles/getting-started-with-vmware
- /enterprise/admin/articles/installing-vmware-tools
@@ -11,8 +11,8 @@ redirect_from:
- /admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-vmware
versions:
ghes: '*'
-type: tutorial
shortTitle: Install on VMware
+contentType: tutorials
---
## Prerequisites
diff --git a/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md b/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md
index b198c3ac7069..b340443ae7e6 100644
--- a/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md
+++ b/content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md
@@ -1,14 +1,14 @@
---
title: Setting up a staging instance
-intro: 'You can set up a {% data variables.product.prodname_ghe_server %} instance in a separate, isolated environment, and use the instance to validate and test changes.'
+intro: You can set up a {% data variables.product.prodname_ghe_server %} instance in a separate, isolated environment, and use the instance to validate and test changes.
redirect_from:
- /enterprise/admin/installation/setting-up-a-staging-instance
- /admin/installation/setting-up-a-staging-instance
- /admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance
versions:
ghes: '*'
-type: how_to
shortTitle: Set up a staging instance
+contentType: how-tos
---
## About staging instances
diff --git a/content/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/configuring-custom-footers.md b/content/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/configuring-custom-footers.md
index 861023709890..d44801f85bda 100644
--- a/content/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/configuring-custom-footers.md
+++ b/content/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/configuring-custom-footers.md
@@ -1,14 +1,14 @@
---
title: Configuring custom footers
-intro: 'You can give users easy access to enterprise-specific links by adding custom footers.'
+intro: You can give users easy access to enterprise-specific links by adding custom footers.
permissions: Enterprise owners can configure a custom footer.
versions:
ghec: '*'
ghes: '*'
-type: how_to
shortTitle: Configure custom footers
redirect_from:
- /admin/configuration/configuring-your-enterprise/configuring-custom-footers
+contentType: how-tos
---
## About custom footers for your enterprise
diff --git a/content/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/customizing-user-messages-for-your-enterprise.md b/content/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/customizing-user-messages-for-your-enterprise.md
index da23fc0d57fd..4eeff32ed1df 100644
--- a/content/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/customizing-user-messages-for-your-enterprise.md
+++ b/content/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/customizing-user-messages-for-your-enterprise.md
@@ -7,11 +7,11 @@ redirect_from:
- /admin/user-management/customizing-user-messages-on-your-instance
- /admin/user-management/customizing-user-messages-for-your-enterprise
- /admin/user-management/managing-users-in-your-enterprise/customizing-user-messages-for-your-enterprise
-intro: 'You can create custom messages that users will see on {% data variables.product.github %}.'
+intro: You can create custom messages that users will see on {% data variables.product.github %}.
versions:
ghec: '*'
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About user messages
diff --git a/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise.md b/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise.md
index 9f1df7929cd5..f640bbc7ad9e 100644
--- a/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise.md
+++ b/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise.md
@@ -1,6 +1,6 @@
---
title: Adding organizations to your enterprise
-intro: 'Learn how to add organizations to your enterprise using three different methods.'
+intro: Learn how to add organizations to your enterprise using three different methods.
redirect_from:
- /github/setting-up-and-managing-your-enterprise/managing-organizations-in-your-enterprise-account/adding-organizations-to-your-enterprise-account
- /articles/adding-organizations-to-your-enterprise-account
@@ -9,9 +9,9 @@ redirect_from:
- /admin/user-management/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise
versions:
ghec: '*'
-type: how_to
shortTitle: Add organizations
permissions: Enterprise owners
+contentType: how-tos
---
There are three ways to add organizations to your enterprise.
diff --git a/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/configuring-visibility-for-organization-membership.md b/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/configuring-visibility-for-organization-membership.md
index 7f452684819f..63f602add584 100644
--- a/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/configuring-visibility-for-organization-membership.md
+++ b/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/configuring-visibility-for-organization-membership.md
@@ -7,8 +7,8 @@ redirect_from:
- /admin/user-management/managing-organizations-in-your-enterprise/configuring-visibility-for-organization-membership
versions:
ghes: '*'
-type: how_to
shortTitle: Set membership visibility
+contentType: how-tos
---
You can also enforce your default setting on all current organization members in your instance using a command-line utility. For example, if you'd like to require every organization member's visibility to be public, you can set the default to public and enforce the default for all new members in the admin settings, and then use the command-line utility to enforce the public setting on existing members.
diff --git a/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/managing-projects-using-jira.md b/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/managing-projects-using-jira.md
index d118ab5a47a3..6e08fb965a58 100644
--- a/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/managing-projects-using-jira.md
+++ b/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/managing-projects-using-jira.md
@@ -1,6 +1,6 @@
---
title: Managing projects using Jira
-intro: 'You can integrate Jira with {% data variables.product.prodname_ghe_server %} for project management.'
+intro: You can integrate Jira with {% data variables.product.prodname_ghe_server %} for project management.
redirect_from:
- /enterprise/admin/guides/installation/project-management-using-jira
- /enterprise/admin/articles/project-management-using-jira
@@ -11,8 +11,8 @@ redirect_from:
- /admin/user-management/managing-organizations-in-your-enterprise/managing-projects-using-jira
versions:
ghes: '*'
-type: how_to
shortTitle: Project management with Jira
+contentType: how-tos
---
## Connecting Jira to a {% data variables.product.prodname_enterprise %} organization
diff --git a/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/managing-requests-for-copilot-business.md b/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/managing-requests-for-copilot-business.md
index 468f4c7460fb..0975e034d8e4 100644
--- a/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/managing-requests-for-copilot-business.md
+++ b/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/managing-requests-for-copilot-business.md
@@ -5,10 +5,10 @@ permissions: Enterprise owners
product: Enterprise accounts with a subscription to {% data variables.copilot.copilot_for_business %}.
versions:
ghec: '*'
-type: how_to
redirect_from:
- /admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/managing-requests-for-copilot-business-from-organizations-in-your-enterprise
shortTitle: Manage requests for Copilot
+contentType: how-tos
---
Organization owners might not have the necessary permissions to satisfy requests from members. For example, if an organization owner is not an enterprise owner, and {% data variables.copilot.copilot_for_business %} is not enabled for that organization, they will not have the permissions to approve requests for {% data variables.copilot.copilot_for_business %}.
diff --git a/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/managing-your-role-in-an-organization-owned-by-your-enterprise.md b/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/managing-your-role-in-an-organization-owned-by-your-enterprise.md
index 80bc25c1a7bc..e90f81c8d991 100644
--- a/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/managing-your-role-in-an-organization-owned-by-your-enterprise.md
+++ b/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/managing-your-role-in-an-organization-owned-by-your-enterprise.md
@@ -7,8 +7,8 @@ redirect_from:
versions:
ghec: '*'
ghes: '*'
-type: how_to
shortTitle: Manage your organization roles
+contentType: how-tos
---
## About role management
diff --git a/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/preventing-users-from-creating-organizations.md b/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/preventing-users-from-creating-organizations.md
index 9c0fbbf84734..9f3414d63a00 100644
--- a/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/preventing-users-from-creating-organizations.md
+++ b/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/preventing-users-from-creating-organizations.md
@@ -9,8 +9,8 @@ redirect_from:
intro: You can prevent users from creating organizations in your enterprise.
versions:
ghes: '*'
-type: how_to
shortTitle: Prevent organization creation
+contentType: how-tos
---
{% data reusables.enterprise-accounts.access-enterprise %}
{% data reusables.enterprise-accounts.policies-tab %}
diff --git a/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/removing-organizations-from-your-enterprise.md b/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/removing-organizations-from-your-enterprise.md
index 8632878a610d..6c3fc973a401 100644
--- a/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/removing-organizations-from-your-enterprise.md
+++ b/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/removing-organizations-from-your-enterprise.md
@@ -1,13 +1,13 @@
---
title: Removing organizations from your enterprise
-intro: 'Learn how to remove an organization that should no longer be a part of your enterprise.'
+intro: Learn how to remove an organization that should no longer be a part of your enterprise.
permissions: Enterprise owners can remove any organization from their enterprise.
versions:
ghec: '*'
-type: how_to
shortTitle: Remove organizations
redirect_from:
- /admin/user-management/managing-organizations-in-your-enterprise/removing-organizations-from-your-enterprise
+contentType: how-tos
---
You can remove an organization that is owned by your enterprise account, so the organization stands alone.
diff --git a/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/requiring-two-factor-authentication-for-an-organization.md b/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/requiring-two-factor-authentication-for-an-organization.md
index c1045ca8d1e7..09a1f5116296 100644
--- a/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/requiring-two-factor-authentication-for-an-organization.md
+++ b/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/requiring-two-factor-authentication-for-an-organization.md
@@ -1,14 +1,14 @@
---
title: Requiring two-factor authentication for an organization
-intro: 'You can require organization members and outside collaborators to enable two-factor authentication for their personal accounts in an organization, making it harder for malicious actors to access an organization''s repositories and settings.'
+intro: You can require organization members and outside collaborators to enable two-factor authentication for their personal accounts in an organization, making it harder for malicious actors to access an organization's repositories and settings.
redirect_from:
- /enterprise/admin/user-management/requiring-two-factor-authentication-for-an-organization
- /admin/user-management/requiring-two-factor-authentication-for-an-organization
- /admin/user-management/managing-organizations-in-your-enterprise/requiring-two-factor-authentication-for-an-organization
versions:
ghes: '*'
-type: how_to
shortTitle: Require 2FA
+contentType: how-tos
---
When using LDAP or built-in authentication, two-factor authentication is supported on {% data variables.location.product_location %}. Organization owners can require members to have two-factor authentication enabled.
diff --git a/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/restoring-a-deleted-organization.md b/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/restoring-a-deleted-organization.md
index c7bafbeafb36..5abdafedc937 100644
--- a/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/restoring-a-deleted-organization.md
+++ b/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/restoring-a-deleted-organization.md
@@ -1,13 +1,13 @@
---
title: Restoring a deleted organization
-intro: 'You can partially restore an organization that was previously deleted on {% data variables.location.product_location %}.'
+intro: You can partially restore an organization that was previously deleted on {% data variables.location.product_location %}.
versions:
ghes: '*'
-type: how_to
shortTitle: Restore organization
-permissions: 'Site administrators'
+permissions: Site administrators
redirect_from:
- - /admin/user-management/managing-organizations-in-your-enterprise/restoring-a-deleted-organization
+ - /admin/user-management/managing-organizations-in-your-enterprise/restoring-a-deleted-organization
+contentType: how-tos
---
## About organization restoration
diff --git a/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/accessing-user-owned-repositories-in-your-enterprise.md b/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/accessing-user-owned-repositories-in-your-enterprise.md
index 45211026b899..73d249b57eea 100644
--- a/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/accessing-user-owned-repositories-in-your-enterprise.md
+++ b/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/accessing-user-owned-repositories-in-your-enterprise.md
@@ -1,13 +1,13 @@
---
title: Accessing user-owned repositories in your enterprise
-intro: "You can temporarily access a repository owned by a user within your enterprise."
+intro: You can temporarily access a repository owned by a user within your enterprise.
permissions: Enterprise owners can temporarily access user-owned repositories.
versions:
- feature: 'emu-owned-repos'
-type: how_to
+ feature: emu-owned-repos
shortTitle: Access user-owned repositories
redirect_from:
- /admin/user-management/managing-repositories-in-your-enterprise/accessing-user-owned-repositories-in-your-enterprise
+contentType: how-tos
---
## About temporary access to user-owned repositories
diff --git a/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/configuring-git-large-file-storage-for-your-enterprise.md b/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/configuring-git-large-file-storage-for-your-enterprise.md
index d875d3669f58..5ce609753aa9 100644
--- a/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/configuring-git-large-file-storage-for-your-enterprise.md
+++ b/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/configuring-git-large-file-storage-for-your-enterprise.md
@@ -17,8 +17,8 @@ redirect_from:
- /admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/migrating-to-internal-repositories
versions:
ghes: '*'
-type: how_to
shortTitle: Configure Git LFS
+contentType: how-tos
---
## About {% data variables.large_files.product_name_long %}
diff --git a/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/disabling-git-ssh-access-on-your-enterprise.md b/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/disabling-git-ssh-access-on-your-enterprise.md
index eeb60634b1cb..d5b429327a97 100644
--- a/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/disabling-git-ssh-access-on-your-enterprise.md
+++ b/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/disabling-git-ssh-access-on-your-enterprise.md
@@ -18,8 +18,8 @@ redirect_from:
intro: You can prevent people from using Git over SSH for certain or all repositories on your enterprise.
versions:
ghes: '*'
-type: how_to
shortTitle: Disable SSH for Git
+contentType: how-tos
---
## Disabling Git SSH access to a specific repository
diff --git a/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/governing-how-people-use-repositories-in-your-enterprise.md b/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/governing-how-people-use-repositories-in-your-enterprise.md
index c9ba5015cbc2..8c9f71b07396 100644
--- a/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/governing-how-people-use-repositories-in-your-enterprise.md
+++ b/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/governing-how-people-use-repositories-in-your-enterprise.md
@@ -1,11 +1,11 @@
---
title: Governing how people use repositories in your enterprise
-intro: "Create a repository policy to control who can do things like create and delete repositories."
+intro: Create a repository policy to control who can do things like create and delete repositories.
permissions: Enterprise owners
versions:
feature: repo-policy-rules
-type: how_to
shortTitle: Govern repository usage
+contentType: how-tos
---
{% data reusables.enterprise.repo-policy-rules-preview %}
diff --git a/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/locking-a-repository.md b/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/locking-a-repository.md
index 280bae11ad53..cda92a554db1 100644
--- a/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/locking-a-repository.md
+++ b/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/locking-a-repository.md
@@ -3,10 +3,10 @@ title: Locking a repository
intro: You can prevent changes to a repository's code and other resources, such as issues and pull requests, by locking the repository.
versions:
ghes: '*'
-type: how_to
shortTitle: Lock a repository
-redirect_from:
+redirect_from:
- /admin/user-management/managing-repositories-in-your-enterprise/locking-a-repository
+contentType: how-tos
---
## Locking a repository
diff --git a/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/viewing-user-owned-repositories-in-your-enterprise.md b/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/viewing-user-owned-repositories-in-your-enterprise.md
index 996d1cca0633..28afc318e715 100644
--- a/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/viewing-user-owned-repositories-in-your-enterprise.md
+++ b/content/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/viewing-user-owned-repositories-in-your-enterprise.md
@@ -1,13 +1,13 @@
---
title: Viewing user-owned repositories in your enterprise
-intro: "You can view all repositories owned by users within your enterprise."
+intro: You can view all repositories owned by users within your enterprise.
permissions: Enterprise owners can view user-owned repositories.
versions:
- feature: 'emu-owned-repos'
-type: how_to
+ feature: emu-owned-repos
shortTitle: View user-owned repositories
redirect_from:
- /admin/user-management/managing-repositories-in-your-enterprise/viewing-user-owned-repositories-in-your-enterprise
+contentType: how-tos
---
If your enterprise uses {% data variables.product.prodname_emus %}, and you've allowed users to create repositories owned by their user accounts, you can view all user-owned repositories within your enterprise.
diff --git a/content/admin/managing-accounts-and-repositories/managing-roles-in-your-enterprise/assign-roles.md b/content/admin/managing-accounts-and-repositories/managing-roles-in-your-enterprise/assign-roles.md
index a300ba367b10..0459cfeece08 100644
--- a/content/admin/managing-accounts-and-repositories/managing-roles-in-your-enterprise/assign-roles.md
+++ b/content/admin/managing-accounts-and-repositories/managing-roles-in-your-enterprise/assign-roles.md
@@ -3,10 +3,10 @@ title: Assigning roles to people in an enterprise
intro: Govern what people can do in your enterprise by assigning roles to users and teams.
versions:
feature: enterprise-custom-roles
-type: how_to
shortTitle: Assign roles
redirect_from:
- /admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/assign-roles
+contentType: how-tos
---
{% data reusables.enterprise-onboarding.assign-roles %}
diff --git a/content/admin/managing-accounts-and-repositories/managing-roles-in-your-enterprise/create-custom-roles.md b/content/admin/managing-accounts-and-repositories/managing-roles-in-your-enterprise/create-custom-roles.md
index 88dcf66624d7..04a62874ebfd 100644
--- a/content/admin/managing-accounts-and-repositories/managing-roles-in-your-enterprise/create-custom-roles.md
+++ b/content/admin/managing-accounts-and-repositories/managing-roles-in-your-enterprise/create-custom-roles.md
@@ -3,10 +3,10 @@ title: Creating custom roles in an enterprise
intro: Create roles with fine-grained permissions for consistent access to settings and resources.
versions:
feature: ent-owner-custom-org-roles
-type: how_to
shortTitle: Create custom roles
redirect_from:
- /admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/custom-organization-roles
+contentType: how-tos
---
{% data reusables.enterprise-onboarding.create-custom-roles %}
diff --git a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/about-reserved-usernames-for-github-enterprise-server.md b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/about-reserved-usernames-for-github-enterprise-server.md
index 94b217a39c66..6750e2d94505 100644
--- a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/about-reserved-usernames-for-github-enterprise-server.md
+++ b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/about-reserved-usernames-for-github-enterprise-server.md
@@ -5,7 +5,7 @@ intro: Certain words are reserved for internal use and cannot be used as usernam
permissions: Enterprise owners
versions:
ghes: '*'
-type: reference
+contentType: reference
---
## About reserved usernames
diff --git a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/auditing-ssh-keys.md b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/auditing-ssh-keys.md
index 463da6d1c8cb..74722ae0c5be 100644
--- a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/auditing-ssh-keys.md
+++ b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/auditing-ssh-keys.md
@@ -8,7 +8,7 @@ redirect_from:
- /admin/user-management/managing-users-in-your-enterprise/auditing-ssh-keys
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
Once initiated, the audit disables all existing SSH keys and forces users to approve or reject them before they're able to clone, pull, or push to any repositories. An audit is useful in situations where an employee or contractor leaves the company and you need to ensure that all keys are verified.
diff --git a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/auditing-users-across-your-enterprise.md b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/auditing-users-across-your-enterprise.md
index 01bdf42d3df9..3b39257238f4 100644
--- a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/auditing-users-across-your-enterprise.md
+++ b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/auditing-users-across-your-enterprise.md
@@ -1,6 +1,6 @@
---
title: Auditing users across your enterprise
-intro: 'The audit log dashboard shows site administrators the actions performed by all users and organizations across your enterprise within the last 180 days. The audit log includes details such as who performed the action, what the action was, and when the action was performed.'
+intro: The audit log dashboard shows site administrators the actions performed by all users and organizations across your enterprise within the last 180 days. The audit log includes details such as who performed the action, what the action was, and when the action was performed.
redirect_from:
- /enterprise/admin/guides/user-management/auditing-users-across-an-organization
- /enterprise/admin/user-management/auditing-users-across-your-instance
@@ -9,8 +9,8 @@ redirect_from:
- /admin/user-management/managing-users-in-your-enterprise/auditing-users-across-your-enterprise
versions:
ghes: '*'
-type: how_to
shortTitle: Audit users
+contentType: how-tos
---
## Accessing the audit log
diff --git a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/best-practices-for-user-security.md b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/best-practices-for-user-security.md
index 18bea9d5f3e4..121052d932fb 100644
--- a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/best-practices-for-user-security.md
+++ b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/best-practices-for-user-security.md
@@ -1,14 +1,14 @@
---
title: Best practices for user security
-intro: 'Outside of instance-level security measures (SSL, subdomain isolation, configuring a firewall) that a site administrator can implement, there are steps your users can take to help protect your enterprise.'
+intro: Outside of instance-level security measures (SSL, subdomain isolation, configuring a firewall) that a site administrator can implement, there are steps your users can take to help protect your enterprise.
redirect_from:
- /enterprise/admin/user-management/best-practices-for-user-security
- /admin/user-management/best-practices-for-user-security
- /admin/user-management/managing-users-in-your-enterprise/best-practices-for-user-security
versions:
ghes: '*'
-type: reference
shortTitle: User security best practices
+contentType: reference
---
## Enabling two-factor authentication
diff --git a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/create-enterprise-teams.md b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/create-enterprise-teams.md
index 4055501b997c..b62c52e2053b 100644
--- a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/create-enterprise-teams.md
+++ b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/create-enterprise-teams.md
@@ -1,14 +1,14 @@
---
title: Creating enterprise teams
-intro: 'Organize users into teams to simplify license management.'
+intro: Organize users into teams to simplify license management.
versions:
feature: enterprise-teams
-type: how_to
shortTitle: Create enterprise teams
permissions: Enterprise owners
redirect_from:
- /admin/user-management/managing-users-in-your-enterprise/managing-organization-members-in-your-enterprise
- /admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/managing-organization-members-in-your-enterprise
+contentType: how-tos
---
To simplify administration at scale, you can create enterprise teams. {% data reusables.enterprise.enterprise-teams-can %}
diff --git a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/deleting-users-from-your-instance.md b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/deleting-users-from-your-instance.md
index e0fd08950fd8..cfbbee4087ca 100644
--- a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/deleting-users-from-your-instance.md
+++ b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/deleting-users-from-your-instance.md
@@ -1,11 +1,11 @@
---
title: Deleting users from your instance
-intro: "You can delete a user's account to permanently remove their data from {% data variables.location.product_location %}."
+intro: You can delete a user's account to permanently remove their data from {% data variables.location.product_location %}.
versions:
ghes: '*'
-type: how_to
shortTitle: Delete a user
permissions: Site administrators
+contentType: how-tos
---
## What happens when I delete a user account?
diff --git a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/impersonating-a-user.md b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/impersonating-a-user.md
index 3582562a7d4a..7a8c4a46f15e 100644
--- a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/impersonating-a-user.md
+++ b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/impersonating-a-user.md
@@ -1,13 +1,13 @@
---
title: Impersonating a user
-intro: 'You can impersonate users and perform actions on their behalf, for troubleshooting, unblocking, and other legitimate reasons.'
+intro: You can impersonate users and perform actions on their behalf, for troubleshooting, unblocking, and other legitimate reasons.
permissions: Enterprise owners can impersonate users within their enterprise.
versions:
ghes: '*'
-type: how_to
shortTitle: Impersonate a user
redirect_from:
- /admin/user-management/managing-users-in-your-enterprise/impersonating-a-user
+contentType: how-tos
---
## About user impersonation
diff --git a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/invite-users-directly.md b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/invite-users-directly.md
index da841bf78957..9d8faa0c9e8f 100644
--- a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/invite-users-directly.md
+++ b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/invite-users-directly.md
@@ -1,12 +1,12 @@
---
title: Inviting users to your enterprise directly
shortTitle: Invite users directly
-intro: 'You can invite people directly to your enterprise as unaffiliated users.'
-permissions: 'Enterprise owners'
+intro: You can invite people directly to your enterprise as unaffiliated users.
+permissions: Enterprise owners
versions:
ghec: '*'
-type: how_to
-product: 'Enterprises that use **personal accounts** on {% data variables.product.prodname_dotcom_the_website %}.'
+product: Enterprises that use **personal accounts** on {% data variables.product.prodname_dotcom_the_website %}.
+contentType: how-tos
---
You can invite people directly to your enterprise as **unaffiliated users**. You can then add these users to organizations or enterprise teams and assign {% data variables.product.prodname_copilot_short %} licenses to them. For more information about unaffiliated users, see [AUTOTITLE](/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/roles-in-an-enterprise#unaffiliated-users).
diff --git a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/inviting-people-to-manage-your-enterprise.md b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/inviting-people-to-manage-your-enterprise.md
index 4aaf0681ba17..1f9337255144 100644
--- a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/inviting-people-to-manage-your-enterprise.md
+++ b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/inviting-people-to-manage-your-enterprise.md
@@ -1,7 +1,7 @@
---
title: Inviting people to manage your enterprise
-intro: 'You can {% ifversion ghec %}invite{% else %}add{% endif %} and remove enterprise owners{% ifversion ghec %} and billing managers{% endif %} for your enterprise account.'
-permissions: 'Enterprise owners can {% ifversion ghec %}invite other people to become{% elsif ghes %}add{% endif %} additional enterprise administrators.'
+intro: You can {% ifversion ghec %}invite{% else %}add{% endif %} and remove enterprise owners{% ifversion ghec %} and billing managers{% endif %} for your enterprise account.
+permissions: Enterprise owners can {% ifversion ghec %}invite other people to become{% elsif ghes %}add{% endif %} additional enterprise administrators.
redirect_from:
- /github/setting-up-and-managing-your-enterprise/managing-users-in-your-enterprise/inviting-people-to-manage-your-enterprise
- /github/setting-up-and-managing-your-enterprise-account/inviting-people-to-manage-your-enterprise-account
@@ -12,8 +12,8 @@ redirect_from:
versions:
ghec: '*'
ghes: '*'
-type: how_to
shortTitle: Invite people to manage
+contentType: how-tos
---
## About administrator management
diff --git a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/managing-dormant-users.md b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/managing-dormant-users.md
index 3c6287f56afc..038cc1202bb3 100644
--- a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/managing-dormant-users.md
+++ b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/managing-dormant-users.md
@@ -8,11 +8,11 @@ redirect_from:
- /admin/user-management/managing-dormant-users
- /admin/user-management/managing-users-in-your-enterprise/managing-dormant-users
intro: '{% data reusables.enterprise-accounts.dormant-user-activity-threshold %}'
-permissions: "{% ifversion ghec %}Enterprise owners{% elsif ghes %}Site administrators{% endif %}"
+permissions: '{% ifversion ghec %}Enterprise owners{% elsif ghes %}Site administrators{% endif %}'
versions:
ghec: '*'
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About dormant users
diff --git a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/managing-invitations-to-organizations-within-your-enterprise.md b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/managing-invitations-to-organizations-within-your-enterprise.md
index 32620de57b91..f62c1379c242 100644
--- a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/managing-invitations-to-organizations-within-your-enterprise.md
+++ b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/managing-invitations-to-organizations-within-your-enterprise.md
@@ -1,13 +1,13 @@
---
title: Managing invitations to organizations within your enterprise
-intro: 'You can retry or cancel invitations to organizations within your enterprise, either one by one or multiple at a time.'
+intro: You can retry or cancel invitations to organizations within your enterprise, either one by one or multiple at a time.
versions:
feature: enterprise-manage-organization-members
-type: how_to
shortTitle: Manage organization invitations
permissions: Enterprise owners can manage invitations to organizations within their enterprise.
redirect_from:
- /admin/user-management/managing-users-in-your-enterprise/managing-invitations-to-organizations-within-your-enterprise
+contentType: how-tos
---
You can manage invitations to your enterprise or organizations within your enterprise.
diff --git a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/placing-a-legal-hold-on-a-user-or-organization.md b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/placing-a-legal-hold-on-a-user-or-organization.md
index 3d649bfde83c..e9ff5a682408 100644
--- a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/placing-a-legal-hold-on-a-user-or-organization.md
+++ b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/placing-a-legal-hold-on-a-user-or-organization.md
@@ -7,8 +7,8 @@ redirect_from:
- /admin/user-management/managing-users-in-your-enterprise/placing-a-legal-hold-on-a-user-or-organization
versions:
ghes: '*'
-type: how_to
shortTitle: Place a legal hold
+contentType: how-tos
---
Usually, if someone deletes a repository, it will be available on disk for 90 days and can be restored via the site admin dashboard. After 90 days the repository is purged and deleted forever. If you place a legal hold on a user or organization, repositories they own are available for restore indefinitely.
diff --git a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/promoting-or-demoting-a-site-administrator.md b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/promoting-or-demoting-a-site-administrator.md
index e90740c012bc..d5b7fa66c43a 100644
--- a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/promoting-or-demoting-a-site-administrator.md
+++ b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/promoting-or-demoting-a-site-administrator.md
@@ -6,11 +6,11 @@ redirect_from:
- /enterprise/admin/user-management/promoting-or-demoting-a-site-administrator
- /admin/user-management/promoting-or-demoting-a-site-administrator
- /admin/user-management/managing-users-in-your-enterprise/promoting-or-demoting-a-site-administrator
-intro: 'Site administrators can promote any normal user account to a site administrator, as well as demote other site administrators to regular users.'
+intro: Site administrators can promote any normal user account to a site administrator, as well as demote other site administrators to regular users.
versions:
ghes: '*'
-type: how_to
shortTitle: Manage administrators
+contentType: how-tos
---
> [!NOTE] For information about promoting a user to an organization owner, see the `ghe-org-admin-promote` section of [AUTOTITLE](/admin/configuration/configuring-your-enterprise/command-line-utilities#ghe-org-admin-promote).
diff --git a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/rebuilding-contributions-data.md b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/rebuilding-contributions-data.md
index 35aeb574772f..3a33f7959cc1 100644
--- a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/rebuilding-contributions-data.md
+++ b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/rebuilding-contributions-data.md
@@ -8,8 +8,8 @@ redirect_from:
- /admin/user-management/managing-users-in-your-enterprise/rebuilding-contributions-data
versions:
ghes: '*'
-type: how_to
shortTitle: Rebuild contributions
+contentType: how-tos
---
Whenever a commit is pushed to {% data variables.product.prodname_enterprise %}, it is linked to a user account if they are both associated with the same email address. However, existing commits are _not_ retroactively linked when a user registers a new email address or creates a new account.
diff --git a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/removing-a-member-from-your-enterprise.md b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/removing-a-member-from-your-enterprise.md
index 66932d1ee60b..76b87f7ef69c 100644
--- a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/removing-a-member-from-your-enterprise.md
+++ b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/removing-a-member-from-your-enterprise.md
@@ -4,10 +4,10 @@ intro: Offboard users from an enterprise by following the recommended approach f
permissions: Enterprise owners or IdP administrators
versions:
feature: remove-enterprise-members
-type: how_to
shortTitle: Remove member
redirect_from:
- /admin/user-management/managing-users-in-your-enterprise/removing-a-member-from-your-enterprise
+contentType: how-tos
---
The recommended offboarding approach for your enterprise depends on whether you use personal accounts or {% data variables.product.prodname_emus %}. To learn more about the effects of offboarding users, see [AUTOTITLE](/admin/concepts/identity-and-access-management/user-offboarding).
diff --git a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/suspending-and-unsuspending-users.md b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/suspending-and-unsuspending-users.md
index c678bdb83071..0e92ce9f5ccd 100644
--- a/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/suspending-and-unsuspending-users.md
+++ b/content/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/suspending-and-unsuspending-users.md
@@ -9,11 +9,11 @@ redirect_from:
- /enterprise/admin/user-management/suspending-and-unsuspending-users
- /admin/user-management/suspending-and-unsuspending-users
- /admin/user-management/managing-users-in-your-enterprise/suspending-and-unsuspending-users
-intro: 'If a user leaves or moves to a different part of the company, you should remove or modify their ability to access {% data variables.location.product_location %}.'
+intro: If a user leaves or moves to a different part of the company, you should remove or modify their ability to access {% data variables.location.product_location %}.
versions:
ghes: '*'
-type: how_to
shortTitle: Manage user suspension
+contentType: how-tos
---
## About suspended users
diff --git a/content/admin/managing-code-security/managing-github-advanced-security-for-your-enterprise/managing-github-advanced-security-features-for-your-enterprise.md b/content/admin/managing-code-security/managing-github-advanced-security-for-your-enterprise/managing-github-advanced-security-features-for-your-enterprise.md
index 495629b328dd..44948d6a9a3d 100644
--- a/content/admin/managing-code-security/managing-github-advanced-security-for-your-enterprise/managing-github-advanced-security-features-for-your-enterprise.md
+++ b/content/admin/managing-code-security/managing-github-advanced-security-for-your-enterprise/managing-github-advanced-security-features-for-your-enterprise.md
@@ -1,14 +1,14 @@
---
title: Managing {% data variables.product.prodname_GHAS %} features for your enterprise
-intro: 'You can control {% data variables.product.prodname_GHAS %} features that secure and analyze code across all organizations owned by your enterprise.'
-permissions: 'Enterprise owners can manage {% data variables.product.prodname_AS %} features for organizations in an enterprise.'
+intro: You can control {% data variables.product.prodname_GHAS %} features that secure and analyze code across all organizations owned by your enterprise.
+permissions: Enterprise owners can manage {% data variables.product.prodname_AS %} features for organizations in an enterprise.
allowTitleToDifferFromFilename: true
versions:
- ghes: '<= 3.15'
-type: how_to
+ ghes: '<=3.15'
shortTitle: Manage {% data variables.product.prodname_GHAS %}
redirect_from:
- /admin/code-security/managing-github-advanced-security-for-your-enterprise/managing-github-advanced-security-features-for-your-enterprise
+contentType: how-tos
---
## About management of {% data variables.product.prodname_AS %} features
diff --git a/content/admin/managing-github-actions-for-your-enterprise/advanced-configuration-and-troubleshooting/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled.md b/content/admin/managing-github-actions-for-your-enterprise/advanced-configuration-and-troubleshooting/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled.md
index 73fdf925fde9..945503f4bca6 100644
--- a/content/admin/managing-github-actions-for-your-enterprise/advanced-configuration-and-troubleshooting/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled.md
+++ b/content/admin/managing-github-actions-for-your-enterprise/advanced-configuration-and-troubleshooting/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled.md
@@ -1,13 +1,13 @@
---
title: Backing up and restoring GitHub Enterprise Server with GitHub Actions enabled
shortTitle: Backing up and restoring
-intro: 'To restore a backup of {% data variables.location.product_location %} when {% data variables.product.prodname_actions %} is enabled, you must configure {% data variables.product.prodname_actions %} before restoring the backup with {% data variables.product.prodname_enterprise_backup_utilities %}.'
+intro: To restore a backup of {% data variables.location.product_location %} when {% data variables.product.prodname_actions %} is enabled, you must configure {% data variables.product.prodname_actions %} before restoring the backup with {% data variables.product.prodname_enterprise_backup_utilities %}.
versions:
ghes: '*'
-type: how_to
redirect_from:
- /admin/github-actions/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled
- /admin/github-actions/advanced-configuration-and-troubleshooting/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled
+contentType: how-tos
---
## About backups of {% data variables.product.prodname_ghe_server %} when using {% data variables.product.prodname_actions %}
diff --git a/content/admin/managing-github-actions-for-your-enterprise/advanced-configuration-and-troubleshooting/high-availability-for-github-actions.md b/content/admin/managing-github-actions-for-your-enterprise/advanced-configuration-and-troubleshooting/high-availability-for-github-actions.md
index 50f671e2a780..a5e44bf21d93 100644
--- a/content/admin/managing-github-actions-for-your-enterprise/advanced-configuration-and-troubleshooting/high-availability-for-github-actions.md
+++ b/content/admin/managing-github-actions-for-your-enterprise/advanced-configuration-and-troubleshooting/high-availability-for-github-actions.md
@@ -1,13 +1,13 @@
---
title: High availability for GitHub Actions
-intro: 'There are some special considerations for administering {% data variables.product.prodname_actions %} in a high availability configuration.'
+intro: There are some special considerations for administering {% data variables.product.prodname_actions %} in a high availability configuration.
versions:
ghes: '*'
-type: reference
redirect_from:
- /admin/github-actions/high-availability-for-github-actions
- /admin/github-actions/advanced-configuration-and-troubleshooting/high-availability-for-github-actions
shortTitle: HA for GitHub Actions
+contentType: reference
---
## Replication or redundancy of your {% data variables.product.prodname_actions %} data
diff --git a/content/admin/managing-github-actions-for-your-enterprise/advanced-configuration-and-troubleshooting/troubleshooting-github-actions-for-your-enterprise.md b/content/admin/managing-github-actions-for-your-enterprise/advanced-configuration-and-troubleshooting/troubleshooting-github-actions-for-your-enterprise.md
index f56238b1888b..b2e9331a42e8 100644
--- a/content/admin/managing-github-actions-for-your-enterprise/advanced-configuration-and-troubleshooting/troubleshooting-github-actions-for-your-enterprise.md
+++ b/content/admin/managing-github-actions-for-your-enterprise/advanced-configuration-and-troubleshooting/troubleshooting-github-actions-for-your-enterprise.md
@@ -1,14 +1,14 @@
---
title: Troubleshooting GitHub Actions for your enterprise
-intro: 'Troubleshooting common issues that occur when using {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %}.'
-permissions: 'Site administrators can troubleshoot {% data variables.product.prodname_actions %} issues and modify {% data variables.product.prodname_ghe_server %} configurations.'
+intro: Troubleshooting common issues that occur when using {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %}.
+permissions: Site administrators can troubleshoot {% data variables.product.prodname_actions %} issues and modify {% data variables.product.prodname_ghe_server %} configurations.
versions:
ghes: '*'
-type: how_to
redirect_from:
- /admin/github-actions/troubleshooting-github-actions-for-your-enterprise
- /admin/github-actions/advanced-configuration-and-troubleshooting/troubleshooting-github-actions-for-your-enterprise
shortTitle: Troubleshoot GitHub Actions
+contentType: how-tos
---
## Checking the health of {% data variables.product.prodname_actions %}
diff --git a/content/admin/managing-github-actions-for-your-enterprise/advanced-configuration-and-troubleshooting/using-a-staging-environment.md b/content/admin/managing-github-actions-for-your-enterprise/advanced-configuration-and-troubleshooting/using-a-staging-environment.md
index 73bf1aad2105..105e5a17ded7 100644
--- a/content/admin/managing-github-actions-for-your-enterprise/advanced-configuration-and-troubleshooting/using-a-staging-environment.md
+++ b/content/admin/managing-github-actions-for-your-enterprise/advanced-configuration-and-troubleshooting/using-a-staging-environment.md
@@ -1,13 +1,13 @@
---
title: Using a staging environment
-intro: 'Learn about using {% data variables.product.prodname_actions %} with {% data variables.product.prodname_ghe_server %} staging instances.'
+intro: Learn about using {% data variables.product.prodname_actions %} with {% data variables.product.prodname_ghe_server %} staging instances.
versions:
ghes: '*'
-type: how_to
redirect_from:
- /admin/github-actions/using-a-staging-environment
- /admin/github-actions/advanced-configuration-and-troubleshooting/using-a-staging-environment
shortTitle: Use staging environment
+contentType: how-tos
---
## About staging environments for {% data variables.product.prodname_ghe_server %}
diff --git a/content/admin/managing-github-actions-for-your-enterprise/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-amazon-s3-storage.md b/content/admin/managing-github-actions-for-your-enterprise/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-amazon-s3-storage.md
index 8cc9f57e06b4..24b3b477599f 100644
--- a/content/admin/managing-github-actions-for-your-enterprise/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-amazon-s3-storage.md
+++ b/content/admin/managing-github-actions-for-your-enterprise/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-amazon-s3-storage.md
@@ -1,14 +1,14 @@
---
title: Enabling GitHub Actions with Amazon S3 storage
-intro: 'You can enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} and use Amazon S3 storage to store data generated by workflow runs.'
-permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.'
+intro: You can enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} and use Amazon S3 storage to store data generated by workflow runs.
+permissions: Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.
versions:
ghes: '*'
-type: how_to
redirect_from:
- /admin/github-actions/enabling-github-actions-with-amazon-s3-storage
- /admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-amazon-s3-storage
shortTitle: Amazon S3 storage
+contentType: how-tos
---
{% data reusables.actions.enterprise-storage-about %}
diff --git a/content/admin/managing-github-actions-for-your-enterprise/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-azure-blob-storage.md b/content/admin/managing-github-actions-for-your-enterprise/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-azure-blob-storage.md
index cfab111ab509..1b02b6a4d600 100644
--- a/content/admin/managing-github-actions-for-your-enterprise/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-azure-blob-storage.md
+++ b/content/admin/managing-github-actions-for-your-enterprise/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-azure-blob-storage.md
@@ -1,14 +1,14 @@
---
title: Enabling GitHub Actions with Azure Blob storage
-intro: 'You can enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} and use Azure Blob storage to store data generated by workflow runs.'
-permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.'
+intro: You can enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} and use Azure Blob storage to store data generated by workflow runs.
+permissions: Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.
versions:
ghes: '*'
-type: how_to
redirect_from:
- /admin/github-actions/enabling-github-actions-with-azure-blob-storage
- /admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-azure-blob-storage
shortTitle: Azure Blob storage
+contentType: how-tos
---
{% data reusables.actions.enterprise-storage-about %}
diff --git a/content/admin/managing-github-actions-for-your-enterprise/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-google-cloud-storage.md b/content/admin/managing-github-actions-for-your-enterprise/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-google-cloud-storage.md
index 034723c80f37..00c3fbfff3d8 100644
--- a/content/admin/managing-github-actions-for-your-enterprise/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-google-cloud-storage.md
+++ b/content/admin/managing-github-actions-for-your-enterprise/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-google-cloud-storage.md
@@ -1,13 +1,13 @@
---
title: Enabling GitHub Actions with Google Cloud Storage
-intro: 'You can enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} and use Google Cloud Storage to store data generated by workflow runs.'
-permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.'
+intro: You can enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} and use Google Cloud Storage to store data generated by workflow runs.
+permissions: Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.
versions:
ghes: '*'
-type: how_to
shortTitle: Google Cloud Storage
redirect_from:
- /admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-google-cloud-storage
+contentType: how-tos
---
> [!NOTE]
diff --git a/content/admin/managing-github-actions-for-your-enterprise/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-storage.md b/content/admin/managing-github-actions-for-your-enterprise/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-storage.md
index 3b40013b2d26..9a675daea333 100644
--- a/content/admin/managing-github-actions-for-your-enterprise/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-storage.md
+++ b/content/admin/managing-github-actions-for-your-enterprise/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-storage.md
@@ -1,15 +1,15 @@
---
title: Enabling GitHub Actions with MinIO storage
-intro: 'You can enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} and use MinIO storage to store data generated by workflow runs.'
-permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.'
+intro: You can enable {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} and use MinIO storage to store data generated by workflow runs.
+permissions: Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.
versions:
ghes: '*'
-type: how_to
redirect_from:
- /admin/github-actions/enabling-github-actions-with-minio-gateway-for-nas-storage
- /admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-gateway-for-nas-storage
- /admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-minio-storage
shortTitle: MinIO storage
+contentType: how-tos
---
{% data reusables.actions.enterprise-storage-about %}
diff --git a/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/about-github-actions-for-enterprises.md b/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/about-github-actions-for-enterprises.md
index e6221b4bab98..5eb247e6f044 100644
--- a/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/about-github-actions-for-enterprises.md
+++ b/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/about-github-actions-for-enterprises.md
@@ -5,9 +5,9 @@ intro: '{% data variables.product.prodname_actions %} can improve developer prod
versions:
ghec: '*'
ghes: '*'
-type: overview
redirect_from:
- /admin/github-actions/getting-started-with-github-actions-for-your-enterprise/about-github-actions-for-enterprises
+contentType: concepts
---
diff --git a/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-cloud.md b/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-cloud.md
index e09ec58bdb7e..84c567df01f5 100644
--- a/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-cloud.md
+++ b/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-cloud.md
@@ -1,13 +1,13 @@
---
title: Getting started with GitHub Actions for GitHub Enterprise Cloud
shortTitle: Get started
-intro: 'Learn how to configure {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_cloud %}.'
-permissions: 'Enterprise owners can configure {% data variables.product.prodname_actions %}.{% ifversion custom-org-roles %}
Users with the "Manage organization Actions policies" permission manage all settings on the "Actions General" settings page, except for self-hosted runners settings.
Users with the "Manage organization runners and runner groups" permission can manage GitHub-hosted runners, self-hosted runners, and runner groups, and control where self-hosted runners can be created.{% endif %}'
+intro: Learn how to configure {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_cloud %}.
+permissions: Enterprise owners can configure {% data variables.product.prodname_actions %}.{% ifversion custom-org-roles %}
Users with the "Manage organization Actions policies" permission manage all settings on the "Actions General" settings page, except for self-hosted runners settings.
Users with the "Manage organization runners and runner groups" permission can manage GitHub-hosted runners, self-hosted runners, and runner groups, and control where self-hosted runners can be created.{% endif %}
versions:
ghec: '*'
-type: how_to
redirect_from:
- /admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-cloud
+contentType: how-tos
---
## About {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_cloud %}
diff --git a/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md b/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md
index 81d8568a7ef8..04e6bd1e185f 100644
--- a/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md
+++ b/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server.md
@@ -1,8 +1,8 @@
---
title: Getting started with GitHub Actions for GitHub Enterprise Server
shortTitle: Get started
-intro: 'Learn about enabling and configuring {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} for the first time.'
-permissions: 'Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.'
+intro: Learn about enabling and configuring {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} for the first time.
+permissions: Site administrators can enable {% data variables.product.prodname_actions %} and configure enterprise settings.
redirect_from:
- /enterprise/admin/github-actions/enabling-github-actions-and-configuring-storage
- /admin/github-actions/enabling-github-actions-and-configuring-storage
@@ -11,7 +11,7 @@ redirect_from:
- /admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
diff --git a/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/getting-started-with-self-hosted-runners-for-your-enterprise.md b/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/getting-started-with-self-hosted-runners-for-your-enterprise.md
index ef4325790b97..c3673e009f8a 100644
--- a/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/getting-started-with-self-hosted-runners-for-your-enterprise.md
+++ b/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/getting-started-with-self-hosted-runners-for-your-enterprise.md
@@ -1,14 +1,14 @@
---
title: Getting started with self-hosted runners for your enterprise
shortTitle: Self-hosted runners
-intro: 'You can configure a runner machine for your enterprise so your developers can start automating workflows with {% data variables.product.prodname_actions %}.'
+intro: You can configure a runner machine for your enterprise so your developers can start automating workflows with {% data variables.product.prodname_actions %}.
versions:
ghec: '*'
ghes: '*'
-permissions: 'Enterprise owners{% ifversion custom-org-roles %} and users with permissions{% endif %} can configure policies for {% data variables.product.prodname_actions %} and add self-hosted runners to the enterprise.'
-type: quick_start
+permissions: Enterprise owners{% ifversion custom-org-roles %} and users with permissions{% endif %} can configure policies for {% data variables.product.prodname_actions %} and add self-hosted runners to the enterprise.
redirect_from:
- /admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-self-hosted-runners-for-your-enterprise
+contentType: get-started
---
## About self-hosted runners for {% data variables.product.prodname_actions %}
diff --git a/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md b/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md
index 274827001d30..f7b1873f024b 100644
--- a/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md
+++ b/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md
@@ -1,13 +1,13 @@
---
title: Introducing GitHub Actions to your enterprise
shortTitle: Introduce Actions
-intro: 'You can plan how to roll out {% data variables.product.prodname_actions %} in your enterprise.'
+intro: You can plan how to roll out {% data variables.product.prodname_actions %} in your enterprise.
versions:
ghec: '*'
ghes: '*'
-type: how_to
redirect_from:
- /admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise
+contentType: how-tos
---
## About {% data variables.product.prodname_actions %} for enterprises
diff --git a/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions.md b/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions.md
index c04b2d51570e..481b7da3b234 100644
--- a/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions.md
+++ b/content/admin/managing-github-actions-for-your-enterprise/getting-started-with-github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions.md
@@ -1,13 +1,13 @@
---
title: Migrating your enterprise to GitHub Actions
shortTitle: Migrate to Actions
-intro: 'Learn how to plan a migration to {% data variables.product.prodname_actions %} for your enterprise from another provider.'
+intro: Learn how to plan a migration to {% data variables.product.prodname_actions %} for your enterprise from another provider.
versions:
ghec: '*'
ghes: '*'
-type: how_to
redirect_from:
- /admin/github-actions/getting-started-with-github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions
+contentType: how-tos
---
## About enterprise migrations to {% data variables.product.prodname_actions %}
diff --git a/content/admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/about-using-actions-in-your-enterprise.md b/content/admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/about-using-actions-in-your-enterprise.md
index 11cb06fcca97..876c7f6dd077 100644
--- a/content/admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/about-using-actions-in-your-enterprise.md
+++ b/content/admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/about-using-actions-in-your-enterprise.md
@@ -9,8 +9,8 @@ redirect_from:
- /admin/github-actions/managing-access-to-actions-from-githubcom/about-using-actions-in-your-enterprise
versions:
ghes: '*'
-type: overview
shortTitle: About actions in your enterprise
+contentType: concepts
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/enabling-automatic-access-to-githubcom-actions-using-github-connect.md b/content/admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/enabling-automatic-access-to-githubcom-actions-using-github-connect.md
index 6ea028effe28..389d3077a024 100644
--- a/content/admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/enabling-automatic-access-to-githubcom-actions-using-github-connect.md
+++ b/content/admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/enabling-automatic-access-to-githubcom-actions-using-github-connect.md
@@ -1,15 +1,15 @@
---
title: Enabling automatic access to GitHub.com actions using GitHub Connect
-intro: 'To allow {% data variables.product.prodname_actions %} in your enterprise to use actions from {% data variables.product.prodname_dotcom_the_website %}, you can connect your enterprise instance to {% data variables.product.prodname_ghe_cloud %}.'
-permissions: 'Enterprise owners can enable access to public {% data variables.product.prodname_dotcom_the_website %} actions.'
+intro: To allow {% data variables.product.prodname_actions %} in your enterprise to use actions from {% data variables.product.prodname_dotcom_the_website %}, you can connect your enterprise instance to {% data variables.product.prodname_ghe_cloud %}.
+permissions: Enterprise owners can enable access to public {% data variables.product.prodname_dotcom_the_website %} actions.
redirect_from:
- /enterprise/admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect
- /admin/github-actions/enabling-automatic-access-to-githubcom-actions-using-github-connect
- /admin/github-actions/managing-access-to-actions-from-githubcom/enabling-automatic-access-to-githubcom-actions-using-github-connect
versions:
ghes: '*'
-type: how_to
shortTitle: Use GitHub Connect for actions
+contentType: how-tos
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/manually-syncing-actions-from-githubcom.md b/content/admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/manually-syncing-actions-from-githubcom.md
index 57fbcbf4edd9..95b22f079d9d 100644
--- a/content/admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/manually-syncing-actions-from-githubcom.md
+++ b/content/admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/manually-syncing-actions-from-githubcom.md
@@ -1,14 +1,14 @@
---
title: Manually syncing actions from GitHub.com
-intro: 'For users that need access to actions from {% data variables.product.prodname_dotcom_the_website %}, you can sync specific actions to your enterprise.'
+intro: For users that need access to actions from {% data variables.product.prodname_dotcom_the_website %}, you can sync specific actions to your enterprise.
redirect_from:
- /enterprise/admin/github-actions/manually-syncing-actions-from-githubcom
- /admin/github-actions/manually-syncing-actions-from-githubcom
- /admin/github-actions/managing-access-to-actions-from-githubcom/manually-syncing-actions-from-githubcom
versions:
ghes: '*'
-type: tutorial
shortTitle: Manually sync actions
+contentType: tutorials
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md b/content/admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md
index 32e94e2940b3..5a4e9476567a 100644
--- a/content/admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md
+++ b/content/admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access.md
@@ -1,14 +1,14 @@
---
title: Setting up the tool cache on self-hosted runners without internet access
-intro: 'To use the included `actions/setup` actions on self-hosted runners without internet access, you must first populate the runner''s tool cache for your workflows.'
+intro: To use the included `actions/setup` actions on self-hosted runners without internet access, you must first populate the runner's tool cache for your workflows.
redirect_from:
- /enterprise/admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access
- /admin/github-actions/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access
- /admin/github-actions/managing-access-to-actions-from-githubcom/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access
versions:
ghes: '*'
-type: tutorial
shortTitle: Tool cache for offline runners
+contentType: tutorials
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/using-the-latest-version-of-the-official-bundled-actions.md b/content/admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/using-the-latest-version-of-the-official-bundled-actions.md
index 30b0425d0029..a4e4d6daeef3 100644
--- a/content/admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/using-the-latest-version-of-the-official-bundled-actions.md
+++ b/content/admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/using-the-latest-version-of-the-official-bundled-actions.md
@@ -1,13 +1,13 @@
---
title: Using the latest version of the official bundled actions
-intro: 'You can update the actions that are bundled with your enterprise, or use actions directly from {% data variables.product.prodname_dotcom_the_website %}.'
+intro: You can update the actions that are bundled with your enterprise, or use actions directly from {% data variables.product.prodname_dotcom_the_website %}.
versions:
ghes: '*'
-type: how_to
redirect_from:
- /admin/github-actions/using-the-latest-version-of-the-official-bundled-actions
- /admin/github-actions/managing-access-to-actions-from-githubcom/using-the-latest-version-of-the-official-bundled-actions
shortTitle: Use the latest bundled actions
+contentType: how-tos
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/admin/managing-github-apps-for-your-enterprise/adding-and-removing-github-app-managers-in-your-enterprise.md b/content/admin/managing-github-apps-for-your-enterprise/adding-and-removing-github-app-managers-in-your-enterprise.md
index fd83d72fbf3a..f0e1b8443b50 100644
--- a/content/admin/managing-github-apps-for-your-enterprise/adding-and-removing-github-app-managers-in-your-enterprise.md
+++ b/content/admin/managing-github-apps-for-your-enterprise/adding-and-removing-github-app-managers-in-your-enterprise.md
@@ -3,12 +3,11 @@ title: Adding and removing GitHub App managers in your enterprise
intro: Enterprise owners can grant or revoke access for a user to manage {% data variables.product.prodname_github_apps %} owned by the enterprise.
versions:
feature: enterprise-app-manager
-type: how_to
permissions: Enterprise owners.
shortTitle: Add app managers
redirect_from:
- /admin/managing-your-enterprise-account/adding-and-removing-github-app-managers-in-your-enterprise
-contentType: other
+contentType: how-tos
---
## About {% data variables.product.prodname_github_app %} managers
diff --git a/content/admin/managing-github-apps-for-your-enterprise/creating-github-apps-for-your-enterprise.md b/content/admin/managing-github-apps-for-your-enterprise/creating-github-apps-for-your-enterprise.md
index 22f5ab868cc4..14c09de11655 100644
--- a/content/admin/managing-github-apps-for-your-enterprise/creating-github-apps-for-your-enterprise.md
+++ b/content/admin/managing-github-apps-for-your-enterprise/creating-github-apps-for-your-enterprise.md
@@ -3,12 +3,11 @@ title: Creating GitHub Apps for your enterprise
intro: Learn how to create a {% data variables.product.prodname_github_app %} for your enterprise.
versions:
feature: enterprise-apps-public-beta
-type: how_to
permissions: Enterprise owners.
shortTitle: Create a GitHub App
redirect_from:
- /admin/managing-your-enterprise-account/creating-github-apps-for-your-enterprise
-contentType: other
+contentType: how-tos
---
{% data reusables.enterprise-onboarding.create-enterprise-apps %}
diff --git a/content/admin/managing-iam/configuring-authentication-for-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users.md b/content/admin/managing-iam/configuring-authentication-for-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users.md
index d5512014edab..63ec0cd6a191 100644
--- a/content/admin/managing-iam/configuring-authentication-for-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users.md
+++ b/content/admin/managing-iam/configuring-authentication-for-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users.md
@@ -1,7 +1,7 @@
---
title: Configuring SAML single sign-on for Enterprise Managed Users
shortTitle: Configure SAML
-intro: 'You can automatically manage access to your enterprise account on {% data variables.product.prodname_dotcom %} by configuring Security Assertion Markup Language (SAML) single sign-on (SSO).'
+intro: You can automatically manage access to your enterprise account on {% data variables.product.prodname_dotcom %} by configuring Security Assertion Markup Language (SAML) single sign-on (SSO).
product: '{% data reusables.gated-features.emus %}'
redirect_from:
- /github/setting-up-and-managing-your-enterprise/managing-your-enterprise-users-with-your-identity-provider/configuring-saml-single-sign-on-for-enterprise-managed-users
@@ -12,7 +12,7 @@ redirect_from:
- /admin/identity-and-access-management/configuring-authentication-for-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users
versions:
ghec: '*'
-type: tutorial
+contentType: tutorials
---
**Before** following the steps in this article, make sure that your enterprise uses **managed users** and that you are signed in as the setup user whose username is your enterprise's shortcode suffixed with `_admin`. You can verify you are signed in with the correct user by checking whether your enterprise view has the "Viewing as SHORTCODE_admin" header bar at the top of the screen. If you see this, you are signed in with the correct user and you can follow the steps in this article. For more information about the setup user, see [AUTOTITLE](/admin/managing-iam/understanding-iam-for-enterprises/getting-started-with-enterprise-managed-users).
diff --git a/content/admin/managing-iam/configuring-authentication-for-enterprise-managed-users/disabling-authentication-and-provisioning-for-enterprise-managed-users.md b/content/admin/managing-iam/configuring-authentication-for-enterprise-managed-users/disabling-authentication-and-provisioning-for-enterprise-managed-users.md
index e290a3c5d625..cb507e4ef3a3 100644
--- a/content/admin/managing-iam/configuring-authentication-for-enterprise-managed-users/disabling-authentication-and-provisioning-for-enterprise-managed-users.md
+++ b/content/admin/managing-iam/configuring-authentication-for-enterprise-managed-users/disabling-authentication-and-provisioning-for-enterprise-managed-users.md
@@ -2,15 +2,15 @@
title: Disabling authentication for Enterprise Managed Users
allowTitleToDifferFromFilename: true
shortTitle: Disable authentication
-intro: 'You can disable SAML or OIDC single sign-on (SSO) authentication for {% data variables.product.prodname_emus %} by using a recovery code to sign in as the setup user.'
+intro: You can disable SAML or OIDC single sign-on (SSO) authentication for {% data variables.product.prodname_emus %} by using a recovery code to sign in as the setup user.
versions:
ghec: '*'
-type: overview
-permissions: 'The setup user can disable SAML or OIDC authentication for {% data variables.product.prodname_emus %}.'
+permissions: The setup user can disable SAML or OIDC authentication for {% data variables.product.prodname_emus %}.
redirect_from:
- /admin/identity-and-access-management/using-enterprise-managed-users-for-iam/disabling-authentication-for-enterprise-managed-users
- /admin/identity-and-access-management/configuring-authentication-for-enterprise-managed-users/disabling-authentication-for-enterprise-managed-users
- /admin/identity-and-access-management/configuring-authentication-for-enterprise-managed-users/disabling-authentication-and-provisioning-for-enterprise-managed-users
+contentType: concepts
---
## About disabled authentication for {% data variables.product.prodname_emus %}
diff --git a/content/admin/managing-iam/iam-configuration-reference/saml-configuration-reference.md b/content/admin/managing-iam/iam-configuration-reference/saml-configuration-reference.md
index 3d285f499784..29a857f34810 100644
--- a/content/admin/managing-iam/iam-configuration-reference/saml-configuration-reference.md
+++ b/content/admin/managing-iam/iam-configuration-reference/saml-configuration-reference.md
@@ -1,14 +1,14 @@
---
title: SAML configuration reference
shortTitle: SAML reference
-intro: 'You can see SAML metadata for {% ifversion ghec %}your organization or enterprise{% elsif ghes %}{% data variables.location.product_location %}{% endif %}, and you can learn more about available SAML attributes and response requirements.'
+intro: You can see SAML metadata for {% ifversion ghec %}your organization or enterprise{% elsif ghes %}{% data variables.location.product_location %}{% endif %}, and you can learn more about available SAML attributes and response requirements.
versions:
ghec: '*'
ghes: '*'
-type: reference
redirect_from:
- /admin/identity-and-access-management/using-saml-for-enterprise-iam/saml-configuration-reference
- /admin/identity-and-access-management/iam-configuration-reference/saml-configuration-reference
+contentType: reference
---
## About SAML configuration
diff --git a/content/admin/managing-iam/iam-configuration-reference/username-considerations-for-external-authentication.md b/content/admin/managing-iam/iam-configuration-reference/username-considerations-for-external-authentication.md
index 0147e2742eef..ae72a7b15448 100644
--- a/content/admin/managing-iam/iam-configuration-reference/username-considerations-for-external-authentication.md
+++ b/content/admin/managing-iam/iam-configuration-reference/username-considerations-for-external-authentication.md
@@ -1,15 +1,15 @@
---
title: Username considerations for external authentication
shortTitle: Username considerations
-intro: 'When you use {% ifversion ghes %}CAS, LDAP, or SAML for authentication{% elsif ghec %}{% data variables.product.prodname_emus %}{% endif %}, {% data variables.product.github %} follows certain rules to determine the username for each user account {% ifversion ghec %}in your enterprise{% elsif ghes %}on your instance{% endif %}.'
+intro: When you use {% ifversion ghes %}CAS, LDAP, or SAML for authentication{% elsif ghec %}{% data variables.product.prodname_emus %}{% endif %}, {% data variables.product.github %} follows certain rules to determine the username for each user account {% ifversion ghec %}in your enterprise{% elsif ghes %}on your instance{% endif %}.
versions:
ghec: '*'
ghes: '*'
-type: reference
redirect_from:
- /admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication
- /admin/identity-and-access-management/understanding-iam-for-enterprises/username-considerations-for-external-authentication
- /admin/identity-and-access-management/iam-configuration-reference/username-considerations-for-external-authentication
+contentType: reference
---
{% ifversion ghec %}
diff --git a/content/admin/managing-iam/managing-recovery-codes-for-your-enterprise/accessing-your-enterprise-account-if-your-identity-provider-is-unavailable.md b/content/admin/managing-iam/managing-recovery-codes-for-your-enterprise/accessing-your-enterprise-account-if-your-identity-provider-is-unavailable.md
index ae1432f4101e..1c69e6ad2eec 100644
--- a/content/admin/managing-iam/managing-recovery-codes-for-your-enterprise/accessing-your-enterprise-account-if-your-identity-provider-is-unavailable.md
+++ b/content/admin/managing-iam/managing-recovery-codes-for-your-enterprise/accessing-your-enterprise-account-if-your-identity-provider-is-unavailable.md
@@ -1,13 +1,13 @@
---
title: Accessing your enterprise account if your identity provider is unavailable
shortTitle: Access your enterprise account
-intro: 'You can sign into {% data variables.product.github %} even if your identity provider is unavailable by bypassing single sign-on (SSO) with a recovery code.'
+intro: You can sign into {% data variables.product.github %} even if your identity provider is unavailable by bypassing single sign-on (SSO) with a recovery code.
versions:
ghec: '*'
-type: how_to
permissions: Enterprise owners can use a recovery code to access an enterprise account.
redirect_from:
- /admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise/accessing-your-enterprise-account-if-your-identity-provider-is-unavailable
+contentType: how-tos
---
## About recovery codes
diff --git a/content/admin/managing-iam/managing-recovery-codes-for-your-enterprise/downloading-your-enterprise-accounts-single-sign-on-recovery-codes.md b/content/admin/managing-iam/managing-recovery-codes-for-your-enterprise/downloading-your-enterprise-accounts-single-sign-on-recovery-codes.md
index ff6709018414..aee79907a2f7 100644
--- a/content/admin/managing-iam/managing-recovery-codes-for-your-enterprise/downloading-your-enterprise-accounts-single-sign-on-recovery-codes.md
+++ b/content/admin/managing-iam/managing-recovery-codes-for-your-enterprise/downloading-your-enterprise-accounts-single-sign-on-recovery-codes.md
@@ -1,14 +1,14 @@
---
title: Downloading your enterprise account's single sign-on recovery codes
shortTitle: Download recovery codes
-intro: 'To ensure that you can access {% data variables.product.github %} if your identity provider (IdP) is unavailable, you should download your enterprise account''s single sign-on (SSO) recovery codes.'
+intro: To ensure that you can access {% data variables.product.github %} if your identity provider (IdP) is unavailable, you should download your enterprise account's single sign-on (SSO) recovery codes.
versions:
ghec: '*'
-type: how_to
redirect_from:
- /admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise/downloading-your-enterprise-accounts-saml-single-sign-on-recovery-codes
- /admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise/downloading-your-enterprise-accounts-single-sign-on-recovery-codes
permissions: Enterprise owners can download the SSO recovery codes for the enterprise account.
+contentType: how-tos
---
In the event that your IdP is unavailable, you can use a recovery code to sign in and access your enterprise on {% data variables.product.github %}. For more information, see [AUTOTITLE](/admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise/accessing-your-enterprise-account-if-your-identity-provider-is-unavailable).
diff --git a/content/admin/managing-iam/provisioning-user-accounts-with-scim/configuring-authentication-and-provisioning-with-entra-id.md b/content/admin/managing-iam/provisioning-user-accounts-with-scim/configuring-authentication-and-provisioning-with-entra-id.md
index 80763f1e9324..0804a7028389 100644
--- a/content/admin/managing-iam/provisioning-user-accounts-with-scim/configuring-authentication-and-provisioning-with-entra-id.md
+++ b/content/admin/managing-iam/provisioning-user-accounts-with-scim/configuring-authentication-and-provisioning-with-entra-id.md
@@ -1,11 +1,10 @@
---
title: Configuring authentication and provisioning with Entra ID
shortTitle: Set up Entra ID
-intro: 'You can use a tenant in Microsoft Entra ID (previously known as Azure AD) as an identity provider (IdP) to centrally manage authentication and user provisioning for {% data variables.location.product_location %}.'
+intro: You can use a tenant in Microsoft Entra ID (previously known as Azure AD) as an identity provider (IdP) to centrally manage authentication and user provisioning for {% data variables.location.product_location %}.
permissions: Site administrators with admin access to the IdP
versions:
ghes: '*'
-type: how_to
redirect_from:
- /admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad
- /admin/authentication/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad
@@ -13,6 +12,7 @@ redirect_from:
- /admin/identity-and-access-management/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad
- /admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-entra-id
- /admin/managing-iam/using-saml-for-enterprise-iam/configuring-authentication-and-provisioning-for-your-enterprise-using-entra-id
+contentType: how-tos
---
{% data reusables.scim.ghes-beta-note %}
diff --git a/content/admin/managing-iam/provisioning-user-accounts-with-scim/configuring-authentication-and-provisioning-with-pingfederate.md b/content/admin/managing-iam/provisioning-user-accounts-with-scim/configuring-authentication-and-provisioning-with-pingfederate.md
index 2858768ca616..5e701501d8d0 100644
--- a/content/admin/managing-iam/provisioning-user-accounts-with-scim/configuring-authentication-and-provisioning-with-pingfederate.md
+++ b/content/admin/managing-iam/provisioning-user-accounts-with-scim/configuring-authentication-and-provisioning-with-pingfederate.md
@@ -1,12 +1,12 @@
---
title: Configuring authentication and provisioning with PingFederate
-intro: 'Set up PingFederate as an identity provider (IdP) {% ifversion ghes %}to centrally manage authentication and provisioning for your enterprise{% else %}for {% data variables.product.prodname_emus %} on {% data variables.product.prodname_dotcom_the_website %} or {% data variables.enterprise.data_residency_site %}{% endif %}.'
+intro: Set up PingFederate as an identity provider (IdP) {% ifversion ghes %}to centrally manage authentication and provisioning for your enterprise{% else %}for {% data variables.product.prodname_emus %} on {% data variables.product.prodname_dotcom_the_website %} or {% data variables.enterprise.data_residency_site %}{% endif %}.
permissions: Enterprise owners with admin access to the IdP
shortTitle: Set up PingFederate
versions:
feature: scim-for-ghes-public-beta
ghec: '*'
-type: how_to
+contentType: how-tos
---
{% data reusables.scim.ghes-beta-note %}
diff --git a/content/admin/managing-iam/provisioning-user-accounts-with-scim/configuring-scim-provisioning-with-okta.md b/content/admin/managing-iam/provisioning-user-accounts-with-scim/configuring-scim-provisioning-with-okta.md
index 74c3fbfbd8b3..1de94f997b4a 100644
--- a/content/admin/managing-iam/provisioning-user-accounts-with-scim/configuring-scim-provisioning-with-okta.md
+++ b/content/admin/managing-iam/provisioning-user-accounts-with-scim/configuring-scim-provisioning-with-okta.md
@@ -1,7 +1,7 @@
---
title: Configuring {% ifversion ghec %}SCIM{% else %}authentication and{% endif %} provisioning with Okta
shortTitle: Set up Okta
-intro: 'Learn how to configure Okta to communicate with your enterprise{% ifversion ghec %} on {% data variables.product.prodname_dotcom_the_website %} or {% data variables.enterprise.data_residency_site %}{% endif %}.'
+intro: Learn how to configure Okta to communicate with your enterprise{% ifversion ghec %} on {% data variables.product.prodname_dotcom_the_website %} or {% data variables.enterprise.data_residency_site %}{% endif %}.
product: '{% data reusables.gated-features.emus %}'
permissions: '{% ifversion ghes %}Site administrators{% else %}People{% endif %} with admin access to the IdP'
allowTitleToDifferFromFilename: true
@@ -17,7 +17,7 @@ redirect_from:
- /admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-scim-provisioning-for-enterprise-managed-users-with-okta
- /admin/identity-and-access-management/provisioning-user-accounts-for-enterprise-managed-users/configuring-scim-provisioning-with-okta
- /admin/managing-iam/provisioning-user-accounts-for-enterprise-managed-users/configuring-scim-provisioning-with-okta
-type: tutorial
+contentType: tutorials
---
{% data reusables.scim.ghes-beta-note %}
diff --git a/content/admin/managing-iam/provisioning-user-accounts-with-scim/deprovisioning-and-reinstating-users.md b/content/admin/managing-iam/provisioning-user-accounts-with-scim/deprovisioning-and-reinstating-users.md
index adba82e519a9..80a701f98084 100644
--- a/content/admin/managing-iam/provisioning-user-accounts-with-scim/deprovisioning-and-reinstating-users.md
+++ b/content/admin/managing-iam/provisioning-user-accounts-with-scim/deprovisioning-and-reinstating-users.md
@@ -1,13 +1,13 @@
---
title: Deprovisioning and reinstating users with SCIM
shortTitle: Deprovision and reinstate users
-intro: 'Learn details about deprovisioning or reinstating users{% ifversion ghec %} with {% data variables.product.prodname_emus %}{% endif %}.'
+intro: Learn details about deprovisioning or reinstating users{% ifversion ghec %} with {% data variables.product.prodname_emus %}{% endif %}.
versions:
ghec: '*'
feature: scim-for-ghes-public-beta
-type: overview
allowTitleToDifferFromFilename: true
-product: 'Enterprises that use {% data variables.product.prodname_emus %}, or {% data variables.product.prodname_ghe_server %} instances with SCIM enabled'
+product: Enterprises that use {% data variables.product.prodname_emus %}, or {% data variables.product.prodname_ghe_server %} instances with SCIM enabled
+contentType: concepts
---
{% data reusables.scim.ghes-beta-note %}
diff --git a/content/admin/managing-iam/provisioning-user-accounts-with-scim/managing-team-memberships-with-identity-provider-groups.md b/content/admin/managing-iam/provisioning-user-accounts-with-scim/managing-team-memberships-with-identity-provider-groups.md
index 1777611748bd..11dcbf5ecbd1 100644
--- a/content/admin/managing-iam/provisioning-user-accounts-with-scim/managing-team-memberships-with-identity-provider-groups.md
+++ b/content/admin/managing-iam/provisioning-user-accounts-with-scim/managing-team-memberships-with-identity-provider-groups.md
@@ -1,7 +1,7 @@
---
title: Managing team memberships with identity provider groups
shortTitle: Manage teams with your IdP
-intro: 'Connect IdP groups with teams on {% data variables.product.prodname_dotcom %} to manage team and organization membership through your identity provider.'
+intro: Connect IdP groups with teams on {% data variables.product.prodname_dotcom %} to manage team and organization membership through your identity provider.
product: '{% data reusables.gated-features.emus %}'
redirect_from:
- /github/setting-up-and-managing-your-enterprise/managing-your-enterprise-users-with-your-identity-provider/managing-team-memberships-with-identity-provider-groups
@@ -14,7 +14,7 @@ redirect_from:
versions:
ghec: '*'
feature: scim-for-ghes-public-beta
-type: how_to
+contentType: how-tos
---
{% data reusables.scim.ghes-beta-note %}
diff --git a/content/admin/managing-iam/provisioning-user-accounts-with-scim/migrating-from-ldap-to-saml-with-scim.md b/content/admin/managing-iam/provisioning-user-accounts-with-scim/migrating-from-ldap-to-saml-with-scim.md
index 0d706cb19174..f85d4447fb8e 100644
--- a/content/admin/managing-iam/provisioning-user-accounts-with-scim/migrating-from-ldap-to-saml-with-scim.md
+++ b/content/admin/managing-iam/provisioning-user-accounts-with-scim/migrating-from-ldap-to-saml-with-scim.md
@@ -1,11 +1,11 @@
---
-title: 'Migrating from LDAP to SAML with SCIM'
-shortTitle: 'Migrate from LDAP'
-intro: 'Learn how to migrate your {% data variables.product.prodname_ghe_server %} instance from LDAP authentication to SAML single sign-on with SCIM provisioning for centralized user management.'
-permissions: 'Site administrators can migrate authentication methods on {% data variables.product.prodname_ghe_server %}.'
+title: Migrating from LDAP to SAML with SCIM
+shortTitle: Migrate from LDAP
+intro: Learn how to migrate your {% data variables.product.prodname_ghe_server %} instance from LDAP authentication to SAML single sign-on with SCIM provisioning for centralized user management.
+permissions: Site administrators can migrate authentication methods on {% data variables.product.prodname_ghe_server %}.
versions:
ghes: '>=3.17'
-type: how_to
+contentType: how-tos
---
## About migrating from LDAP to SAML and SCIM
diff --git a/content/admin/managing-iam/provisioning-user-accounts-with-scim/provisioning-users-and-groups-with-scim-using-the-rest-api.md b/content/admin/managing-iam/provisioning-user-accounts-with-scim/provisioning-users-and-groups-with-scim-using-the-rest-api.md
index 0276dd506b34..6fd2aaf691f1 100644
--- a/content/admin/managing-iam/provisioning-user-accounts-with-scim/provisioning-users-and-groups-with-scim-using-the-rest-api.md
+++ b/content/admin/managing-iam/provisioning-user-accounts-with-scim/provisioning-users-and-groups-with-scim-using-the-rest-api.md
@@ -1,16 +1,16 @@
---
title: Provisioning users and groups with SCIM using the REST API
shortTitle: SCIM using REST API
-intro: 'Manage the lifecycle of user accounts from your identity provider using {% data variables.product.company_short %}''s REST API for System for Cross-domain Identity Management (SCIM).'
+intro: Manage the lifecycle of user accounts from your identity provider using {% data variables.product.company_short %}'s REST API for System for Cross-domain Identity Management (SCIM).
product: '{% data reusables.gated-features.emus %}'
versions:
ghec: '*'
feature: scim-for-ghes-public-beta
-type: tutorial
redirect_from:
- /admin/identity-and-access-management/provisioning-user-accounts-for-enterprise-managed-users/provisioning-users-with-scim-using-the-rest-api
- /admin/identity-and-access-management/provisioning-user-accounts-for-enterprise-managed-users/provisioning-users-and-groups-with-scim-using-the-rest-api
- /admin/managing-iam/provisioning-user-accounts-for-enterprise-managed-users/provisioning-users-and-groups-with-scim-using-the-rest-api
+contentType: tutorials
---
{% ifversion ghec %}
diff --git a/content/admin/managing-iam/provisioning-user-accounts-with-scim/troubleshooting-team-membership-with-identity-provider-groups.md b/content/admin/managing-iam/provisioning-user-accounts-with-scim/troubleshooting-team-membership-with-identity-provider-groups.md
index 96adf3fb5fac..2c8c87e550d3 100644
--- a/content/admin/managing-iam/provisioning-user-accounts-with-scim/troubleshooting-team-membership-with-identity-provider-groups.md
+++ b/content/admin/managing-iam/provisioning-user-accounts-with-scim/troubleshooting-team-membership-with-identity-provider-groups.md
@@ -1,16 +1,16 @@
---
title: Troubleshooting team membership with identity provider groups
shortTitle: Troubleshoot team membership with IdP
-intro: 'If you manage team membership using groups on your identity provider (IdP), but team membership is not in sync, you can troubleshoot the problem.'
+intro: If you manage team membership using groups on your identity provider (IdP), but team membership is not in sync, you can troubleshoot the problem.
product: '{% data reusables.gated-features.emus %}'
versions:
ghec: '*'
feature: scim-for-ghes-public-beta
-type: how_to
redirect_from:
- /admin/identity-and-access-management/using-enterprise-managed-users-for-iam/troubleshooting-team-membership-with-identity-provider-groups
- /admin/identity-and-access-management/provisioning-user-accounts-for-enterprise-managed-users/troubleshooting-team-membership-with-identity-provider-groups
- /admin/managing-iam/provisioning-user-accounts-for-enterprise-managed-users/troubleshooting-team-membership-with-identity-provider-groups
+contentType: how-tos
---
{% data reusables.scim.ghes-beta-note %}
diff --git a/content/admin/managing-iam/provisioning-user-accounts-with-scim/user-provisioning-with-scim-on-ghes.md b/content/admin/managing-iam/provisioning-user-accounts-with-scim/user-provisioning-with-scim-on-ghes.md
index 502e6901c025..eb91117aeb45 100644
--- a/content/admin/managing-iam/provisioning-user-accounts-with-scim/user-provisioning-with-scim-on-ghes.md
+++ b/content/admin/managing-iam/provisioning-user-accounts-with-scim/user-provisioning-with-scim-on-ghes.md
@@ -1,18 +1,18 @@
---
-title: 'About user provisioning with SCIM on GitHub Enterprise Server'
-shortTitle: 'About SCIM provisioning'
-intro: 'Learn about managing the lifecycle of user accounts with SCIM on {% data variables.location.product_location %}.'
+title: About user provisioning with SCIM on GitHub Enterprise Server
+shortTitle: About SCIM provisioning
+intro: Learn about managing the lifecycle of user accounts with SCIM on {% data variables.location.product_location %}.
permissions: ''
versions:
ghes: '*'
allowTitleToDifferFromFilename: true
-type: how_to
redirect_from:
- /admin/authentication/configuring-user-provisioning-for-your-enterprise
- /admin/identity-and-access-management/managing-iam-for-your-enterprise/configuring-user-provisioning-for-your-enterprise
- /admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-for-your-enterprise
- /admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-user-provisioning-with-scim-for-your-enterprise
- /admin/managing-iam/using-saml-for-enterprise-iam/configuring-user-provisioning-with-scim-for-your-enterprise
+contentType: how-tos
---
{% data reusables.scim.ghes-beta-note %}
diff --git a/content/admin/managing-iam/respond-to-incidents/lock-down-sso.md b/content/admin/managing-iam/respond-to-incidents/lock-down-sso.md
index 479803106f28..c2618a7886cf 100644
--- a/content/admin/managing-iam/respond-to-incidents/lock-down-sso.md
+++ b/content/admin/managing-iam/respond-to-incidents/lock-down-sso.md
@@ -1,12 +1,12 @@
---
title: Locking down single sign-on in your enterprise
-intro: 'Take action in a security incident by blocking SSO for all users except enterprise owners.'
-permissions: 'Enterprise owners and users with the "Manage enterprise single sign-on configuration" fine-grained permission'
-product: 'Enterprises with managed users, or enterprises that have enabled SAML SSO for the enterprise or its organizations'
+intro: Take action in a security incident by blocking SSO for all users except enterprise owners.
+permissions: Enterprise owners and users with the "Manage enterprise single sign-on configuration" fine-grained permission
+product: Enterprises with managed users, or enterprises that have enabled SAML SSO for the enterprise or its organizations
versions:
feature: revoke-enterprise-tokens
-type: how_to
shortTitle: Lock down SSO
+contentType: how-tos
---
When your enterprise is affected by a major security incident, you can temporarily block single sign-on for all users except enterprise owners. This allows you to lock down access to your enterprise in order to investigate the incident within a more isolated surface area.
diff --git a/content/admin/managing-iam/respond-to-incidents/revoke-authorizations-or-tokens.md b/content/admin/managing-iam/respond-to-incidents/revoke-authorizations-or-tokens.md
index c30f5d78330e..6a3248dd7002 100644
--- a/content/admin/managing-iam/respond-to-incidents/revoke-authorizations-or-tokens.md
+++ b/content/admin/managing-iam/respond-to-incidents/revoke-authorizations-or-tokens.md
@@ -1,12 +1,12 @@
---
title: Revoking SSO authorizations or deleting credentials in your enterprise
-intro: 'Respond to a security incident by taking bulk action on credentials with access to your enterprise.'
-permissions: 'Enterprise owners and users with the "Manage enterprise credentials" fine-grained permission'
-product: 'Enterprises with managed users, or enterprises that have enabled SAML SSO for the enterprise or its organizations'
+intro: Respond to a security incident by taking bulk action on credentials with access to your enterprise.
+permissions: Enterprise owners and users with the "Manage enterprise credentials" fine-grained permission
+product: Enterprises with managed users, or enterprises that have enabled SAML SSO for the enterprise or its organizations
versions:
feature: revoke-enterprise-tokens
-type: how_to
shortTitle: Revoke authorizations or tokens
+contentType: how-tos
---
When your enterprise is affected by a major security incident, you can respond by preventing programmatic access to your enterprise or its organizations.
diff --git a/content/admin/managing-iam/understanding-iam-for-enterprises/abilities-and-restrictions-of-managed-user-accounts.md b/content/admin/managing-iam/understanding-iam-for-enterprises/abilities-and-restrictions-of-managed-user-accounts.md
index d7c90f922cd9..a9087d76def4 100644
--- a/content/admin/managing-iam/understanding-iam-for-enterprises/abilities-and-restrictions-of-managed-user-accounts.md
+++ b/content/admin/managing-iam/understanding-iam-for-enterprises/abilities-and-restrictions-of-managed-user-accounts.md
@@ -1,13 +1,13 @@
---
title: Abilities and restrictions of managed user accounts
shortTitle: Restrictions for managed users
-intro: 'Learn what users can and cannot do if you manage accounts from an identity provider (IdP).'
+intro: Learn what users can and cannot do if you manage accounts from an identity provider (IdP).
versions:
ghec: '*'
-type: reference
redirect_from:
- /admin/identity-and-access-management/managing-iam-for-your-enterprise/abilities-and-restrictions-of-managed-user-accounts
- /admin/identity-and-access-management/understanding-iam-for-enterprises/abilities-and-restrictions-of-managed-user-accounts
+contentType: reference
---
With {% data variables.product.prodname_emus %}, you can control the user accounts of your enterprise members through your identity provider (IdP). See [AUTOTITLE](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users).
diff --git a/content/admin/managing-iam/understanding-iam-for-enterprises/about-saml-for-enterprise-iam.md b/content/admin/managing-iam/understanding-iam-for-enterprises/about-saml-for-enterprise-iam.md
index 31bbcc62a6bf..c9658ca33b0d 100644
--- a/content/admin/managing-iam/understanding-iam-for-enterprises/about-saml-for-enterprise-iam.md
+++ b/content/admin/managing-iam/understanding-iam-for-enterprises/about-saml-for-enterprise-iam.md
@@ -1,11 +1,10 @@
---
title: About SAML for enterprise IAM
shortTitle: About SAML for IAM
-intro: 'You can use SAML single sign-on (SSO) to centrally manage access {% ifversion ghec %}to organizations owned by your enterprise on {% data variables.product.prodname_dotcom_the_website %}{% elsif ghes %}to {% data variables.location.product_location %}{% endif %}.'
+intro: You can use SAML single sign-on (SSO) to centrally manage access {% ifversion ghec %}to organizations owned by your enterprise on {% data variables.product.prodname_dotcom_the_website %}{% elsif ghes %}to {% data variables.location.product_location %}{% endif %}.
versions:
ghec: '*'
ghes: '*'
-type: overview
redirect_from:
- /admin/authentication/about-identity-and-access-management-for-your-enterprise
- /github/setting-up-and-managing-your-enterprise/about-identity-and-access-management-for-your-enterprise-account
@@ -18,6 +17,7 @@ redirect_from:
- /admin/identity-and-access-management/using-saml-for-enterprise-iam/about-saml-for-enterprise-iam
- /admin/identity-and-access-management/managing-iam-for-your-enterprise/about-saml-for-enterprise-iam
- /admin/identity-and-access-management/understanding-iam-for-enterprises/about-saml-for-enterprise-iam
+contentType: concepts
---
## About SAML SSO for your enterprise
diff --git a/content/admin/managing-iam/understanding-iam-for-enterprises/allowing-built-in-authentication-for-users-outside-your-provider.md b/content/admin/managing-iam/understanding-iam-for-enterprises/allowing-built-in-authentication-for-users-outside-your-provider.md
index 5c6adddc35ab..fb8da2b28497 100644
--- a/content/admin/managing-iam/understanding-iam-for-enterprises/allowing-built-in-authentication-for-users-outside-your-provider.md
+++ b/content/admin/managing-iam/understanding-iam-for-enterprises/allowing-built-in-authentication-for-users-outside-your-provider.md
@@ -1,6 +1,6 @@
---
title: Allowing built-in authentication for users outside your provider
-intro: 'You can configure fallback authentication to allow built-in authentication for people who don''t have an account on your CAS, LDAP, or SAML authentication provider.'
+intro: You can configure fallback authentication to allow built-in authentication for people who don't have an account on your CAS, LDAP, or SAML authentication provider.
redirect_from:
- /enterprise/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider
- /enterprise/admin/authentication/allowing-built-in-authentication-for-users-outside-your-identity-provider
@@ -11,8 +11,8 @@ redirect_from:
- /admin/identity-and-access-management/understanding-iam-for-enterprises/allowing-built-in-authentication-for-users-outside-your-provider
versions:
ghes: '*'
-type: how_to
shortTitle: Fallback authentication
+contentType: how-tos
---
## About built-in authentication for users outside your provider
diff --git a/content/admin/managing-iam/understanding-iam-for-enterprises/changing-authentication-methods.md b/content/admin/managing-iam/understanding-iam-for-enterprises/changing-authentication-methods.md
index 168ed266df2f..f01e69de0b32 100644
--- a/content/admin/managing-iam/understanding-iam-for-enterprises/changing-authentication-methods.md
+++ b/content/admin/managing-iam/understanding-iam-for-enterprises/changing-authentication-methods.md
@@ -1,6 +1,6 @@
---
title: Changing authentication methods
-intro: 'You can change the way {% data variables.product.prodname_ghe_server %} authenticates with your existing accounts at any time.'
+intro: You can change the way {% data variables.product.prodname_ghe_server %} authenticates with your existing accounts at any time.
redirect_from:
- /enterprise/admin/user-management/changing-authentication-methods
- /enterprise/admin/authentication/changing-authentication-methods
@@ -11,8 +11,8 @@ redirect_from:
- /admin/identity-and-access-management/understanding-iam-for-enterprises/changing-authentication-methods
versions:
ghes: '*'
-type: overview
shortTitle: Change authentication methods
+contentType: concepts
---
User accounts on {% data variables.location.product_location %} are preserved when you change the authentication method and users will continue to log into the same account as long as their username doesn't change.
diff --git a/content/admin/managing-iam/understanding-iam-for-enterprises/getting-started-with-enterprise-managed-users.md b/content/admin/managing-iam/understanding-iam-for-enterprises/getting-started-with-enterprise-managed-users.md
index 1eb6f2d7ed74..4723a7a5d706 100644
--- a/content/admin/managing-iam/understanding-iam-for-enterprises/getting-started-with-enterprise-managed-users.md
+++ b/content/admin/managing-iam/understanding-iam-for-enterprises/getting-started-with-enterprise-managed-users.md
@@ -1,13 +1,13 @@
---
-title: 'Getting started with {% data variables.product.prodname_emus %}'
+title: Getting started with {% data variables.product.prodname_emus %}
shortTitle: Get started with managed users
-intro: 'Learn how to create and configure an {% data variables.enterprise.prodname_emu_enterprise %}.'
+intro: Learn how to create and configure an {% data variables.enterprise.prodname_emu_enterprise %}.
versions:
ghec: '*'
-type: overview
allowTitleToDifferFromFilename: true
redirect_from:
- /admin/identity-and-access-management/understanding-iam-for-enterprises/getting-started-with-enterprise-managed-users
+contentType: concepts
---
Before your developers can use {% data variables.product.prodname_ghe_cloud %} with {% data variables.product.prodname_emus %}, you must follow a series of configuration steps.
diff --git a/content/admin/managing-iam/understanding-iam-for-enterprises/troubleshooting-identity-and-access-management-for-your-enterprise.md b/content/admin/managing-iam/understanding-iam-for-enterprises/troubleshooting-identity-and-access-management-for-your-enterprise.md
index 6255c164826e..fb1828f1c2cf 100644
--- a/content/admin/managing-iam/understanding-iam-for-enterprises/troubleshooting-identity-and-access-management-for-your-enterprise.md
+++ b/content/admin/managing-iam/understanding-iam-for-enterprises/troubleshooting-identity-and-access-management-for-your-enterprise.md
@@ -5,10 +5,10 @@ intro: Review common issues and solutions for identity and access management for
versions:
ghec: '*'
ghes: '*'
-type: how_to
redirect_from:
- /admin/identity-and-access-management/managing-iam-for-your-enterprise/troubleshooting-identity-and-access-management-for-your-enterprise
- /admin/identity-and-access-management/understanding-iam-for-enterprises/troubleshooting-identity-and-access-management-for-your-enterprise
+contentType: how-tos
---
{% ifversion ghec %}
diff --git a/content/admin/managing-iam/using-built-in-authentication/configuring-built-in-authentication.md b/content/admin/managing-iam/using-built-in-authentication/configuring-built-in-authentication.md
index 610e764d799d..2c4634bf913a 100644
--- a/content/admin/managing-iam/using-built-in-authentication/configuring-built-in-authentication.md
+++ b/content/admin/managing-iam/using-built-in-authentication/configuring-built-in-authentication.md
@@ -1,7 +1,7 @@
---
title: Configuring built-in authentication
-intro: 'When you use the default authentication method, all authentication details are stored on {% data variables.location.product_location %}.'
-permissions: 'Site administrators can configure authentication for a {% data variables.product.prodname_ghe_server %} instance.'
+intro: When you use the default authentication method, all authentication details are stored on {% data variables.location.product_location %}.
+permissions: Site administrators can configure authentication for a {% data variables.product.prodname_ghe_server %} instance.
redirect_from:
- /enterprise/admin/user-management/using-built-in-authentication
- /enterprise/admin/authentication/using-built-in-authentication
@@ -11,8 +11,8 @@ redirect_from:
- /admin/identity-and-access-management/using-built-in-authentication/configuring-built-in-authentication
versions:
ghes: '*'
-type: how_to
shortTitle: Configure built-in authentication
+contentType: how-tos
---
## About built-in authentication
diff --git a/content/admin/managing-iam/using-built-in-authentication/disabling-passkeys-for-your-instance.md b/content/admin/managing-iam/using-built-in-authentication/disabling-passkeys-for-your-instance.md
index 8a515d405c36..5059d879bf4c 100644
--- a/content/admin/managing-iam/using-built-in-authentication/disabling-passkeys-for-your-instance.md
+++ b/content/admin/managing-iam/using-built-in-authentication/disabling-passkeys-for-your-instance.md
@@ -4,8 +4,8 @@ intro: Learn how to disable passkeys for all users on your instance.
permissions: Site administrators
versions:
ghes: '*'
-type: how_to
shortTitle: Disable passkeys
+contentType: how-tos
---
Passkeys are enabled by default.
diff --git a/content/admin/managing-iam/using-built-in-authentication/disabling-unauthenticated-sign-ups.md b/content/admin/managing-iam/using-built-in-authentication/disabling-unauthenticated-sign-ups.md
index 903340ff32f0..be5b5be54bb6 100644
--- a/content/admin/managing-iam/using-built-in-authentication/disabling-unauthenticated-sign-ups.md
+++ b/content/admin/managing-iam/using-built-in-authentication/disabling-unauthenticated-sign-ups.md
@@ -8,12 +8,12 @@ redirect_from:
- /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance/disabling-unauthenticated-sign-ups
- /admin/identity-and-access-management/authenticating-users-for-your-github-enterprise-server-instance/disabling-unauthenticated-sign-ups
- /admin/identity-and-access-management/using-built-in-authentication/disabling-unauthenticated-sign-ups
-intro: 'If you''re using built-in authentication for {% data variables.location.product_location %}, you can block unauthenticated people from creating new user accounts on your instance.'
-permissions: 'Site administrators can disable unauthenticated sign-ups on a {% data variables.product.prodname_ghe_server %} instance.'
+intro: If you're using built-in authentication for {% data variables.location.product_location %}, you can block unauthenticated people from creating new user accounts on your instance.
+permissions: Site administrators can disable unauthenticated sign-ups on a {% data variables.product.prodname_ghe_server %} instance.
versions:
ghes: '*'
-type: how_to
shortTitle: Block unauthenticated sign-up
+contentType: how-tos
---
## About unauthenticated sign-ups
diff --git a/content/admin/managing-iam/using-built-in-authentication/inviting-people-to-use-your-instance.md b/content/admin/managing-iam/using-built-in-authentication/inviting-people-to-use-your-instance.md
index d3c2c26f92fc..a17137bcf488 100644
--- a/content/admin/managing-iam/using-built-in-authentication/inviting-people-to-use-your-instance.md
+++ b/content/admin/managing-iam/using-built-in-authentication/inviting-people-to-use-your-instance.md
@@ -1,13 +1,13 @@
---
title: Inviting people to use your instance
-intro: 'When you use built-in authentication for {% data variables.product.prodname_ghe_server %}, you can invite people by email address to create a user account on your instance.'
+intro: When you use built-in authentication for {% data variables.product.prodname_ghe_server %}, you can invite people by email address to create a user account on your instance.
versions:
ghes: '*'
-permissions: 'Enterprise owners can invite people to create a user account on a {% data variables.product.prodname_ghe_server %} instance.'
-type: how_to
+permissions: Enterprise owners can invite people to create a user account on a {% data variables.product.prodname_ghe_server %} instance.
shortTitle: Invite people
redirect_from:
- /admin/identity-and-access-management/using-built-in-authentication/inviting-people-to-use-your-instance
+contentType: how-tos
---
## About invitations for new users
diff --git a/content/admin/managing-iam/using-cas-for-enterprise-iam/using-cas.md b/content/admin/managing-iam/using-cas-for-enterprise-iam/using-cas.md
index ed170a841743..7d054b4de28c 100644
--- a/content/admin/managing-iam/using-cas-for-enterprise-iam/using-cas.md
+++ b/content/admin/managing-iam/using-cas-for-enterprise-iam/using-cas.md
@@ -9,10 +9,10 @@ redirect_from:
- /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance/using-cas
- /admin/identity-and-access-management/authenticating-users-for-your-github-enterprise-server-instance/using-cas
- /admin/identity-and-access-management/using-cas-for-enterprise-iam/using-cas
-intro: 'If you use Central Authentication Service (CAS) to centralize access to multiple web applications, you can integrate {% data variables.product.prodname_ghe_server %} by configuring CAS authentication for your instance.'
+intro: If you use Central Authentication Service (CAS) to centralize access to multiple web applications, you can integrate {% data variables.product.prodname_ghe_server %} by configuring CAS authentication for your instance.
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About CAS authentication for {% data variables.product.prodname_ghe_server %}
diff --git a/content/admin/managing-iam/using-ldap-for-enterprise-iam/using-ldap.md b/content/admin/managing-iam/using-ldap-for-enterprise-iam/using-ldap.md
index 89e20a4482ca..4f76d1f2737d 100644
--- a/content/admin/managing-iam/using-ldap-for-enterprise-iam/using-ldap.md
+++ b/content/admin/managing-iam/using-ldap-for-enterprise-iam/using-ldap.md
@@ -12,10 +12,10 @@ redirect_from:
- /enterprise/admin/authentication/authenticating-users-for-your-github-enterprise-server-instance/using-ldap
- /admin/identity-and-access-management/authenticating-users-for-your-github-enterprise-server-instance/using-ldap
- /admin/identity-and-access-management/using-ldap-for-enterprise-iam/using-ldap
-intro: 'If you use Lightweight Directory Access Protocol (LDAP) to centralize access across applications, you can integrate {% data variables.product.prodname_ghe_server %} by configuring LDAP authentication for your instance.'
+intro: If you use Lightweight Directory Access Protocol (LDAP) to centralize access across applications, you can integrate {% data variables.product.prodname_ghe_server %} by configuring LDAP authentication for your instance.
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About LDAP authentication for {% data variables.product.prodname_ghe_server %}
diff --git a/content/admin/managing-iam/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise-using-okta.md b/content/admin/managing-iam/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise-using-okta.md
index b52a4c61a20b..8c10ade9ba83 100644
--- a/content/admin/managing-iam/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise-using-okta.md
+++ b/content/admin/managing-iam/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise-using-okta.md
@@ -1,6 +1,6 @@
---
title: Configuring SAML single sign-on for your enterprise using Okta
-intro: 'You can use Security Assertion Markup Language (SAML) single sign-on (SSO) with Okta to automatically manage access to your enterprise account on {% data variables.product.github %}.'
+intro: You can use Security Assertion Markup Language (SAML) single sign-on (SSO) with Okta to automatically manage access to your enterprise account on {% data variables.product.github %}.
redirect_from:
- /github/setting-up-and-managing-your-enterprise/configuring-single-sign-on-for-your-enterprise-account-using-okta
- /github/setting-up-and-managing-your-enterprise-account/configuring-saml-single-sign-on-for-your-enterprise-account-using-okta
@@ -11,8 +11,8 @@ redirect_from:
- /admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise-using-okta
versions:
ghec: '*'
-type: how_to
shortTitle: Configure SAML SSO with Okta
+contentType: how-tos
---
{% data reusables.enterprise-accounts.emu-saml-note %}
diff --git a/content/admin/managing-iam/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise.md b/content/admin/managing-iam/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise.md
index 473d26caa799..9a2a214ffddd 100644
--- a/content/admin/managing-iam/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise.md
+++ b/content/admin/managing-iam/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise.md
@@ -1,12 +1,11 @@
---
title: Configuring SAML single sign-on for your enterprise
shortTitle: Configure SAML SSO
-intro: 'You can control and secure access to {% ifversion ghec %}resources like repositories, issues, and pull requests within your enterprise''s organizations{% elsif ghes %}{% data variables.location.product_location %}{% endif %} by {% ifversion ghec %}enforcing{% elsif ghes %}configuring{% endif %} SAML single sign-on (SSO) through your identity provider (IdP).'
+intro: You can control and secure access to {% ifversion ghec %}resources like repositories, issues, and pull requests within your enterprise's organizations{% elsif ghes %}{% data variables.location.product_location %}{% endif %} by {% ifversion ghec %}enforcing{% elsif ghes %}configuring{% endif %} SAML single sign-on (SSO) through your identity provider (IdP).
permissions: '{% ifversion ghes %}Site administrators{% elsif ghec %}Enterprise owners{% endif %} can configure SAML SSO for {% ifversion ghec %}an enterprise on {% data variables.product.github %}{% elsif ghes %}a {% data variables.product.prodname_ghe_server %} instance{% endif %}.'
versions:
ghec: '*'
ghes: '*'
-type: how_to
redirect_from:
- /admin/authentication/configuring-saml-single-sign-on-for-your-enterprise
- /github/setting-up-and-managing-your-enterprise/enabling-saml-single-sign-on-for-organizations-in-your-enterprise-account
@@ -15,6 +14,7 @@ redirect_from:
- /admin/authentication/managing-identity-and-access-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise
- /admin/identity-and-access-management/managing-iam-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise
- /admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise
+contentType: how-tos
---
{% ifversion ghec %}
diff --git a/content/admin/managing-iam/using-saml-for-enterprise-iam/deciding-whether-to-configure-saml-for-your-enterprise-or-your-organizations.md b/content/admin/managing-iam/using-saml-for-enterprise-iam/deciding-whether-to-configure-saml-for-your-enterprise-or-your-organizations.md
index 1bee4d4da4ea..a0afab2110d9 100644
--- a/content/admin/managing-iam/using-saml-for-enterprise-iam/deciding-whether-to-configure-saml-for-your-enterprise-or-your-organizations.md
+++ b/content/admin/managing-iam/using-saml-for-enterprise-iam/deciding-whether-to-configure-saml-for-your-enterprise-or-your-organizations.md
@@ -1,12 +1,12 @@
---
title: Deciding whether to configure SAML for your enterprise or your organizations
shortTitle: Enterprise or organization
-intro: 'You can configure SAML for your enterprise account, with the same configuration applying to all of its organizations, or you can create separate configurations for individual organizations.'
+intro: You can configure SAML for your enterprise account, with the same configuration applying to all of its organizations, or you can create separate configurations for individual organizations.
versions:
ghec: '*'
-type: overview
redirect_from:
- /admin/identity-and-access-management/using-saml-for-enterprise-iam/deciding-whether-to-configure-saml-for-your-enterprise-or-your-organizations
+contentType: concepts
---
{% data reusables.enterprise.ghec-authentication-options %} For more information, see [AUTOTITLE](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise).
diff --git a/content/admin/managing-iam/using-saml-for-enterprise-iam/disabling-saml-single-sign-on-for-your-enterprise.md b/content/admin/managing-iam/using-saml-for-enterprise-iam/disabling-saml-single-sign-on-for-your-enterprise.md
index 1ca3a9e1dd2f..4d0167e20aa5 100644
--- a/content/admin/managing-iam/using-saml-for-enterprise-iam/disabling-saml-single-sign-on-for-your-enterprise.md
+++ b/content/admin/managing-iam/using-saml-for-enterprise-iam/disabling-saml-single-sign-on-for-your-enterprise.md
@@ -3,10 +3,10 @@ title: Disabling SAML single sign-on for your enterprise
intro: You can disable SAML single sign-on (SSO) for your enterprise account.
versions:
ghec: '*'
-type: how_to
shortTitle: Disable SAML SSO
redirect_from:
- /admin/identity-and-access-management/using-saml-for-enterprise-iam/disabling-saml-single-sign-on-for-your-enterprise
+contentType: how-tos
---
## About disabled SAML SSO for your enterprise
diff --git a/content/admin/managing-iam/using-saml-for-enterprise-iam/enabling-encrypted-assertions.md b/content/admin/managing-iam/using-saml-for-enterprise-iam/enabling-encrypted-assertions.md
index 086e21b56bc4..13a9fcdfa08a 100644
--- a/content/admin/managing-iam/using-saml-for-enterprise-iam/enabling-encrypted-assertions.md
+++ b/content/admin/managing-iam/using-saml-for-enterprise-iam/enabling-encrypted-assertions.md
@@ -1,13 +1,13 @@
---
title: Enabling encrypted assertions
shortTitle: Enable encrypted assertions
-intro: 'You can improve {% data variables.location.product_location %}''s security with SAML single sign-on (SSO) by encrypting the messages that your SAML identity provider (IdP) sends.'
+intro: You can improve {% data variables.location.product_location %}'s security with SAML single sign-on (SSO) by encrypting the messages that your SAML identity provider (IdP) sends.
permissions: Site administrators
versions:
ghes: '*'
-type: how_to
redirect_from:
- /admin/identity-and-access-management/using-saml-for-enterprise-iam/enabling-encrypted-assertions
+contentType: how-tos
---
## About encrypted assertions
diff --git a/content/admin/managing-iam/using-saml-for-enterprise-iam/managing-team-synchronization-for-organizations-in-your-enterprise.md b/content/admin/managing-iam/using-saml-for-enterprise-iam/managing-team-synchronization-for-organizations-in-your-enterprise.md
index 13623221b353..0b26e4293e0f 100644
--- a/content/admin/managing-iam/using-saml-for-enterprise-iam/managing-team-synchronization-for-organizations-in-your-enterprise.md
+++ b/content/admin/managing-iam/using-saml-for-enterprise-iam/managing-team-synchronization-for-organizations-in-your-enterprise.md
@@ -1,10 +1,9 @@
---
title: Managing team synchronization for organizations in your enterprise
-intro: 'You can enable team synchronization between Microsoft Entra ID (previously known as Azure AD) and {% data variables.product.github %} to allow organizations owned by your enterprise account to manage team membership through IdP groups.'
+intro: You can enable team synchronization between Microsoft Entra ID (previously known as Azure AD) and {% data variables.product.github %} to allow organizations owned by your enterprise account to manage team membership through IdP groups.
permissions: Enterprise owners can manage team synchronization for an enterprise account.
versions:
ghec: '*'
-type: how_to
redirect_from:
- /github/setting-up-and-managing-your-enterprise/managing-team-synchronization-for-organizations-in-your-enterprise-account
- /github/setting-up-and-managing-your-enterprise/configuring-identity-and-access-management-for-your-enterprise-account/managing-team-synchronization-for-organizations-in-your-enterprise-account
@@ -12,6 +11,7 @@ redirect_from:
- /admin/identity-and-access-management/managing-iam-for-your-enterprise/managing-team-synchronization-for-organizations-in-your-enterprise
- /admin/identity-and-access-management/using-saml-for-enterprise-iam/managing-team-synchronization-for-organizations-in-your-enterprise
shortTitle: Manage team synchronization
+contentType: how-tos
---
{% data reusables.enterprise-accounts.emu-scim-note %}
diff --git a/content/admin/managing-iam/using-saml-for-enterprise-iam/switching-your-saml-configuration-from-an-organization-to-an-enterprise-account.md b/content/admin/managing-iam/using-saml-for-enterprise-iam/switching-your-saml-configuration-from-an-organization-to-an-enterprise-account.md
index ef7b22cc671d..d7bf7f9491ef 100644
--- a/content/admin/managing-iam/using-saml-for-enterprise-iam/switching-your-saml-configuration-from-an-organization-to-an-enterprise-account.md
+++ b/content/admin/managing-iam/using-saml-for-enterprise-iam/switching-your-saml-configuration-from-an-organization-to-an-enterprise-account.md
@@ -4,13 +4,13 @@ intro: Learn special considerations and best practices for replacing an organiza
permissions: Enterprise owners can configure SAML single sign-on for an enterprise account.
versions:
ghec: '*'
-type: how_to
shortTitle: From organization to enterprise
redirect_from:
- /github/setting-up-and-managing-your-enterprise/configuring-identity-and-access-management-for-your-enterprise-account/switching-your-saml-configuration-from-an-organization-to-an-enterprise-account
- /admin/authentication/managing-identity-and-access-for-your-enterprise/switching-your-saml-configuration-from-an-organization-to-an-enterprise-account
- /admin/identity-and-access-management/managing-iam-for-your-enterprise/switching-your-saml-configuration-from-an-organization-to-an-enterprise-account
- /admin/identity-and-access-management/using-saml-for-enterprise-iam/switching-your-saml-configuration-from-an-organization-to-an-enterprise-account
+contentType: how-tos
---
## About SAML single sign-on for enterprise accounts
diff --git a/content/admin/managing-iam/using-saml-for-enterprise-iam/troubleshooting-saml-authentication.md b/content/admin/managing-iam/using-saml-for-enterprise-iam/troubleshooting-saml-authentication.md
index afe73d43c512..066ae089b3c3 100644
--- a/content/admin/managing-iam/using-saml-for-enterprise-iam/troubleshooting-saml-authentication.md
+++ b/content/admin/managing-iam/using-saml-for-enterprise-iam/troubleshooting-saml-authentication.md
@@ -1,13 +1,13 @@
---
title: Troubleshooting SAML authentication
shortTitle: Troubleshoot SAML SSO
-intro: 'If you use SAML single sign-on (SSO) and people are unable to authenticate to access {% data variables.product.github %}, you can troubleshoot the problem.'
+intro: If you use SAML single sign-on (SSO) and people are unable to authenticate to access {% data variables.product.github %}, you can troubleshoot the problem.
versions:
ghes: '*'
ghec: '*'
-type: how_to
redirect_from:
- /admin/identity-and-access-management/using-saml-for-enterprise-iam/troubleshooting-saml-authentication
+contentType: how-tos
---
{% ifversion ghes %}
diff --git a/content/admin/managing-iam/using-saml-for-enterprise-iam/updating-a-users-saml-nameid.md b/content/admin/managing-iam/using-saml-for-enterprise-iam/updating-a-users-saml-nameid.md
index 9116f24efd52..2f6f8fc96732 100644
--- a/content/admin/managing-iam/using-saml-for-enterprise-iam/updating-a-users-saml-nameid.md
+++ b/content/admin/managing-iam/using-saml-for-enterprise-iam/updating-a-users-saml-nameid.md
@@ -1,12 +1,12 @@
---
title: Updating a user's SAML NameID
shortTitle: Update SAML NameID
-intro: 'When an account''s `NameID` changes on your identity provider (IdP) and the person can no longer sign into {% data variables.location.product_location %}, you must update the `NameID` mapping on {% data variables.location.product_location %}.'
+intro: When an account's `NameID` changes on your identity provider (IdP) and the person can no longer sign into {% data variables.location.product_location %}, you must update the `NameID` mapping on {% data variables.location.product_location %}.
versions:
ghes: '*'
-type: how_to
redirect_from:
- /admin/identity-and-access-management/using-saml-for-enterprise-iam/updating-a-users-saml-nameid
+contentType: how-tos
---
## About updates to users' SAML `NameID`
diff --git a/content/admin/managing-your-enterprise-account/changing-the-url-for-your-enterprise.md b/content/admin/managing-your-enterprise-account/changing-the-url-for-your-enterprise.md
index 83031b6e0268..cadf12deb98b 100644
--- a/content/admin/managing-your-enterprise-account/changing-the-url-for-your-enterprise.md
+++ b/content/admin/managing-your-enterprise-account/changing-the-url-for-your-enterprise.md
@@ -1,11 +1,11 @@
---
title: Changing the URL for your enterprise
-intro: 'If you want to change the URL where your enterprise is accessed, you can change your enterprise slug.'
+intro: If you want to change the URL where your enterprise is accessed, you can change your enterprise slug.
versions:
ghec: '*'
-type: how_to
permissions: Enterprise owners can change the URL for the enterprise.
shortTitle: Change enterprise URL
+contentType: how-tos
---
## About changes to enterprise slugs
diff --git a/content/admin/managing-your-enterprise-account/creating-a-readme-for-an-enterprise.md b/content/admin/managing-your-enterprise-account/creating-a-readme-for-an-enterprise.md
index 5f5929100a15..d4cd4c5cc0cc 100644
--- a/content/admin/managing-your-enterprise-account/creating-a-readme-for-an-enterprise.md
+++ b/content/admin/managing-your-enterprise-account/creating-a-readme-for-an-enterprise.md
@@ -1,13 +1,13 @@
---
title: Creating a README for an enterprise
-intro: 'You can create a README to tell your members what is happening in your enterprise.'
+intro: You can create a README to tell your members what is happening in your enterprise.
versions:
feature: enterprise-readme
-type: how_to
permissions: Enterprise owners can create and edit an enterprise README.
shortTitle: Create a README
redirect_from:
- /enterprise-onboarding/feature-enhancements/create-a-readme-for-your-enterprise
+contentType: how-tos
---
## About READMEs for enterprises
diff --git a/content/admin/managing-your-enterprise-account/creating-an-enterprise-account.md b/content/admin/managing-your-enterprise-account/creating-an-enterprise-account.md
index 0f384d43d7ea..8ae5786d03fa 100644
--- a/content/admin/managing-your-enterprise-account/creating-an-enterprise-account.md
+++ b/content/admin/managing-your-enterprise-account/creating-an-enterprise-account.md
@@ -1,14 +1,14 @@
---
title: Creating an enterprise account
-intro: "Learn the steps and effects of creating an enterprise account."
+intro: Learn the steps and effects of creating an enterprise account.
versions:
ghec: '*'
-type: how_to
permissions: Organization owners
product: '{% data variables.product.prodname_ghe_cloud %}'
shortTitle: Create enterprise account
redirect_from:
- /admin/overview/creating-an-enterprise-account
+contentType: how-tos
---
diff --git a/content/admin/managing-your-enterprise-account/deleting-an-enterprise-account.md b/content/admin/managing-your-enterprise-account/deleting-an-enterprise-account.md
index c0e61d25069a..5fb8d136babb 100644
--- a/content/admin/managing-your-enterprise-account/deleting-an-enterprise-account.md
+++ b/content/admin/managing-your-enterprise-account/deleting-an-enterprise-account.md
@@ -1,13 +1,13 @@
---
title: Deleting an enterprise account
-intro: 'You can delete an enterprise account to stop paying for {% data variables.product.prodname_enterprise %}.'
+intro: You can delete an enterprise account to stop paying for {% data variables.product.prodname_enterprise %}.
versions:
ghec: '*'
-type: how_to
permissions: Enterprise owners can delete an enterprise account if the company pays by credit card or PayPal.
shortTitle: Delete enterprise account
redirect_from:
- /admin/overview/deleting-an-enterprise-account
+contentType: how-tos
---
## Prerequisites
diff --git a/content/admin/monitoring-activity-in-your-enterprise/exploring-user-activity-in-your-enterprise/log-forwarding.md b/content/admin/monitoring-activity-in-your-enterprise/exploring-user-activity-in-your-enterprise/log-forwarding.md
index 8b818c58d65a..40b734221b3c 100644
--- a/content/admin/monitoring-activity-in-your-enterprise/exploring-user-activity-in-your-enterprise/log-forwarding.md
+++ b/content/admin/monitoring-activity-in-your-enterprise/exploring-user-activity-in-your-enterprise/log-forwarding.md
@@ -11,7 +11,7 @@ redirect_from:
- /admin/monitoring-activity-in-your-enterprise/exploring-user-activity/log-forwarding
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About log forwarding
diff --git a/content/admin/monitoring-activity-in-your-enterprise/exploring-user-activity-in-your-enterprise/managing-global-webhooks.md b/content/admin/monitoring-activity-in-your-enterprise/exploring-user-activity-in-your-enterprise/managing-global-webhooks.md
index b2bed6140056..835c7d9a4ffe 100644
--- a/content/admin/monitoring-activity-in-your-enterprise/exploring-user-activity-in-your-enterprise/managing-global-webhooks.md
+++ b/content/admin/monitoring-activity-in-your-enterprise/exploring-user-activity-in-your-enterprise/managing-global-webhooks.md
@@ -18,7 +18,7 @@ redirect_from:
versions:
ghec: '*'
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About global webhooks
diff --git a/content/admin/monitoring-activity-in-your-enterprise/exploring-user-activity-in-your-enterprise/viewing-push-logs.md b/content/admin/monitoring-activity-in-your-enterprise/exploring-user-activity-in-your-enterprise/viewing-push-logs.md
index 19c80f7556cd..475aa6fc3e8d 100644
--- a/content/admin/monitoring-activity-in-your-enterprise/exploring-user-activity-in-your-enterprise/viewing-push-logs.md
+++ b/content/admin/monitoring-activity-in-your-enterprise/exploring-user-activity-in-your-enterprise/viewing-push-logs.md
@@ -10,7 +10,7 @@ redirect_from:
- /admin/monitoring-activity-in-your-enterprise/exploring-user-activity/viewing-push-logs
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
Push log entries show:
diff --git a/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/accessing-the-audit-log-for-your-enterprise.md b/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/accessing-the-audit-log-for-your-enterprise.md
index 52688ec45ee7..346678d5e028 100644
--- a/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/accessing-the-audit-log-for-your-enterprise.md
+++ b/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/accessing-the-audit-log-for-your-enterprise.md
@@ -2,7 +2,7 @@
title: Accessing the audit log for your enterprise
intro: You can view aggregated actions from all of the organizations owned by an enterprise account in the enterprise's audit log.
shortTitle: Access audit logs
-permissions: 'Enterprise owners {% ifversion ghes %}and site administrators {% endif %}can access the audit log.'
+permissions: Enterprise owners {% ifversion ghes %}and site administrators {% endif %}can access the audit log.
redirect_from:
- /github/setting-up-and-managing-your-enterprise/managing-organizations-in-your-enterprise-account/viewing-the-audit-logs-for-organizations-in-your-enterprise-account
- /articles/viewing-the-audit-logs-for-organizations-in-your-business-account
@@ -13,7 +13,7 @@ redirect_from:
versions:
ghec: '*'
ghes: '*'
-type: how_to
+contentType: how-tos
---
{% data reusables.audit_log.retention-periods %}
diff --git a/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise.md b/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise.md
index bb8aa031a681..77f1bff8493c 100644
--- a/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise.md
+++ b/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise.md
@@ -2,7 +2,7 @@
title: Audit log events for your enterprise
intro: Review the events recorded in an enterprise's audit log.
shortTitle: Audit log events
-permissions: 'Enterprise owners {% ifversion ghes %}and site administrators {% endif %}'
+permissions: Enterprise owners {% ifversion ghes %}and site administrators {% endif %}
redirect_from:
- /enterprise/admin/articles/audited-actions
- /enterprise/admin/installation/audited-actions
@@ -12,8 +12,8 @@ redirect_from:
versions:
ghec: '*'
ghes: '*'
-type: reference
autogenerated: audit-logs
+contentType: reference
---
> [!NOTE] This article lists events that may appear in the audit log for an **enterprise**. For the events that can appear in a user account's security log or the audit log for an organization, see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/security-log-events) and [AUTOTITLE](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/audit-log-events-for-your-organization).
diff --git a/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/configuring-the-audit-log-for-your-enterprise.md b/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/configuring-the-audit-log-for-your-enterprise.md
index 6d78be2cf421..d69fe86f4a12 100644
--- a/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/configuring-the-audit-log-for-your-enterprise.md
+++ b/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/configuring-the-audit-log-for-your-enterprise.md
@@ -5,7 +5,7 @@ shortTitle: Configure audit logs
permissions: Enterprise owners can configure the audit log.
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About audit log configuration
diff --git a/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/displaying-ip-addresses-in-the-audit-log-for-your-enterprise.md b/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/displaying-ip-addresses-in-the-audit-log-for-your-enterprise.md
index f1492144b8c7..d9c71fa130fe 100644
--- a/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/displaying-ip-addresses-in-the-audit-log-for-your-enterprise.md
+++ b/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/displaying-ip-addresses-in-the-audit-log-for-your-enterprise.md
@@ -5,7 +5,7 @@ shortTitle: IP addresses in audit log
permissions: Enterprise owners can display IP addresses in the audit log for an enterprise.
versions:
feature: enterprise-audit-log-ip-addresses
-type: how_to
+contentType: how-tos
---
## About display of IP addresses in the audit log
diff --git a/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/exporting-audit-log-activity-for-your-enterprise.md b/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/exporting-audit-log-activity-for-your-enterprise.md
index 0a4ac3d75d9a..3d6b8fcfde30 100644
--- a/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/exporting-audit-log-activity-for-your-enterprise.md
+++ b/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/exporting-audit-log-activity-for-your-enterprise.md
@@ -5,7 +5,7 @@ shortTitle: Export audit logs
permissions: Enterprise owners
versions:
ghec: '*'
-type: tutorial
+contentType: tutorials
---
## About exports of audit log and Git events data
diff --git a/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/searching-the-audit-log-for-your-enterprise.md b/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/searching-the-audit-log-for-your-enterprise.md
index 1fcbacdd6075..1444e31a41a8 100644
--- a/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/searching-the-audit-log-for-your-enterprise.md
+++ b/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/searching-the-audit-log-for-your-enterprise.md
@@ -2,7 +2,7 @@
title: Searching the audit log for your enterprise
intro: You can search an extensive list of audited actions in your enterprise.
shortTitle: Search audit logs
-permissions: 'Enterprise owners {% ifversion ghes %}and site administrators {% endif %}can search the audit log.'
+permissions: Enterprise owners {% ifversion ghes %}and site administrators {% endif %}can search the audit log.
redirect_from:
- /enterprise/admin/articles/searching-the-audit-log
- /enterprise/admin/installation/searching-the-audit-log
@@ -12,7 +12,7 @@ redirect_from:
versions:
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## About search for the enterprise audit log
diff --git a/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/streaming-the-audit-log-for-your-enterprise.md b/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/streaming-the-audit-log-for-your-enterprise.md
index d1fe13422a98..321d78f54c9c 100644
--- a/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/streaming-the-audit-log-for-your-enterprise.md
+++ b/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/streaming-the-audit-log-for-your-enterprise.md
@@ -1,15 +1,15 @@
---
title: Streaming the audit log for your enterprise
-intro: 'Learn how to stream audit and Git events data from {% data variables.product.prodname_dotcom %} to an external data management system.'
+intro: Learn how to stream audit and Git events data from {% data variables.product.prodname_dotcom %} to an external data management system.
versions:
ghes: '*'
ghec: '*'
-type: tutorial
shortTitle: Stream audit logs
redirect_from:
- /github/setting-up-and-managing-your-enterprise/managing-organizations-in-your-enterprise-account/streaming-the-audit-logs-for-organizations-in-your-enterprise-account
- /admin/user-management/managing-organizations-in-your-enterprise/streaming-the-audit-logs-for-organizations-in-your-enterprise-account
permissions: Enterprise owners
+contentType: tutorials
---
diff --git a/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/using-the-audit-log-api-for-your-enterprise.md b/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/using-the-audit-log-api-for-your-enterprise.md
index 80c2f099ad82..a66de3a71dc2 100644
--- a/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/using-the-audit-log-api-for-your-enterprise.md
+++ b/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/using-the-audit-log-api-for-your-enterprise.md
@@ -2,11 +2,11 @@
title: Using the audit log API for your enterprise
intro: Learn how to programmatically retrieve enterprise events with the REST API.
shortTitle: Audit log API
-permissions: 'Enterprise owners {% ifversion ghes %}and site administrators {% endif %}'
+permissions: Enterprise owners {% ifversion ghes %}and site administrators {% endif %}
versions:
ghec: '*'
ghes: '*'
-type: tutorial
+contentType: tutorials
---
>[!NOTE] {% data reusables.webhooks.webhooks-as-audit-log-alternative %}
diff --git a/content/admin/monitoring-and-managing-your-instance/additional-nodes/configuring-additional-nodes.md b/content/admin/monitoring-and-managing-your-instance/additional-nodes/configuring-additional-nodes.md
index 9015fc1c7fee..af2fe0417ed1 100644
--- a/content/admin/monitoring-and-managing-your-instance/additional-nodes/configuring-additional-nodes.md
+++ b/content/admin/monitoring-and-managing-your-instance/additional-nodes/configuring-additional-nodes.md
@@ -4,7 +4,7 @@ shortTitle: Adding nodes to HA
intro: 'Add nodes to the primary high availability (HA) datacenter. This is intended to offload CPU-intensive tasks from the primary node, allowing for horizontal scaling of the {% data variables.product.prodname_ghe_server %} instance.'
versions:
ghes: '>= 3.18'
-type: how_to
+contentType: how-tos
topics:
- High availability
- Enterprise
diff --git a/content/admin/monitoring-and-managing-your-instance/caching-repositories/about-repository-caching.md b/content/admin/monitoring-and-managing-your-instance/caching-repositories/about-repository-caching.md
index f82050bdd311..1054653cc6f6 100644
--- a/content/admin/monitoring-and-managing-your-instance/caching-repositories/about-repository-caching.md
+++ b/content/admin/monitoring-and-managing-your-instance/caching-repositories/about-repository-caching.md
@@ -3,10 +3,10 @@ title: About repository caching
intro: You can increase the performance of Git read operations for distributed teams and CI farms with repository caching.
versions:
ghes: '*'
-type: overview
redirect_from:
- /admin/enterprise-management/caching-repositories/about-repository-caching
- /admin/monitoring-managing-and-updating-your-instance/caching-repositories/about-repository-caching
+contentType: concepts
---
If you have teams and CI farms located around the world, you may experience reduced performance on your primary {% data variables.product.prodname_ghe_server %} instance. While active geo-replicas can improve the performance of read requests, this comes at the cost of limiting write throughput. To reduce load on your primary instance and improve write throughput performance, you can configure a repository cache, an asynchronous read-only mirror of repositories located near these geographically-distributed clients.
diff --git a/content/admin/monitoring-and-managing-your-instance/caching-repositories/configuring-a-repository-cache.md b/content/admin/monitoring-and-managing-your-instance/caching-repositories/configuring-a-repository-cache.md
index c2290873f906..150bc739bf4a 100644
--- a/content/admin/monitoring-and-managing-your-instance/caching-repositories/configuring-a-repository-cache.md
+++ b/content/admin/monitoring-and-managing-your-instance/caching-repositories/configuring-a-repository-cache.md
@@ -1,12 +1,12 @@
---
title: Configuring a repository cache
-intro: 'You can configure a repository cache for {% data variables.product.prodname_ghe_server %} by creating a new instance, connecting the repository cache to your primary instance, and configuring replication of repository networks to the repository cache.'
+intro: You can configure a repository cache for {% data variables.product.prodname_ghe_server %} by creating a new instance, connecting the repository cache to your primary instance, and configuring replication of repository networks to the repository cache.
versions:
ghes: '*'
-type: how_to
redirect_from:
- /admin/enterprise-management/caching-repositories/configuring-a-repository-cache
- /admin/monitoring-managing-and-updating-your-instance/caching-repositories/configuring-a-repository-cache
+contentType: how-tos
---
## About configuration for repository caching
diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/about-cluster-nodes.md b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/about-cluster-nodes.md
index 3bc6d5da13df..7f16d374d249 100644
--- a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/about-cluster-nodes.md
+++ b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/about-cluster-nodes.md
@@ -1,7 +1,7 @@
---
title: About cluster nodes
product: '{% data reusables.gated-features.cluster %}'
-intro: 'In a {% data variables.product.prodname_ghe_server %} cluster, nodes are individual virtual machines (VMs) running the {% data variables.product.prodname_ghe_server %} software that comprise the instance. Each node runs a set of services.'
+intro: In a {% data variables.product.prodname_ghe_server %} cluster, nodes are individual virtual machines (VMs) running the {% data variables.product.prodname_ghe_server %} software that comprise the instance. Each node runs a set of services.
redirect_from:
- /enterprise/admin/clustering/about-cluster-nodes
- /enterprise/admin/enterprise-management/about-cluster-nodes
@@ -10,7 +10,7 @@ redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/configuring-clustering/about-cluster-nodes
versions:
ghes: '*'
-type: overview
+contentType: concepts
---
## About {% data variables.product.prodname_ghe_server %} cluster nodes
diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/about-clustering.md b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/about-clustering.md
index ad0cc4a982a9..b83debc9bfd8 100644
--- a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/about-clustering.md
+++ b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/about-clustering.md
@@ -1,6 +1,6 @@
---
title: About clustering
-intro: 'The cluster topology for {% data variables.product.prodname_ghe_server %} is designed to support tens of thousands of users where other topologies would experience resource exhaustion. In a cluster, the instance''s services scale horizontally across multiple nodes.'
+intro: The cluster topology for {% data variables.product.prodname_ghe_server %} is designed to support tens of thousands of users where other topologies would experience resource exhaustion. In a cluster, the instance's services scale horizontally across multiple nodes.
product: '{% data variables.product.company_short %} determines eligibility for clustering, and must enable the configuration for your instance''s license. Clustering requires careful planning and additional administrative overhead.'
redirect_from:
- /enterprise/admin/clustering/overview
@@ -12,7 +12,7 @@ redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/configuring-clustering/about-clustering
versions:
ghes: '*'
-type: overview
+contentType: concepts
---
## About clustering for {% data variables.product.prodname_ghe_server %}
diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/cluster-network-configuration.md b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/cluster-network-configuration.md
index 20d3a6542b9a..5f4245ccd805 100644
--- a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/cluster-network-configuration.md
+++ b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/cluster-network-configuration.md
@@ -1,6 +1,6 @@
---
title: Cluster network configuration
-intro: 'A {% data variables.product.prodname_ghe_server %} cluster requires proper DNS name resolution, load balancing, and communication between nodes.'
+intro: A {% data variables.product.prodname_ghe_server %} cluster requires proper DNS name resolution, load balancing, and communication between nodes.
product: '{% data reusables.gated-features.cluster %}'
redirect_from:
- /enterprise/admin/clustering/cluster-network-configuration
@@ -10,8 +10,8 @@ redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/configuring-clustering/cluster-network-configuration
versions:
ghes: '*'
-type: reference
shortTitle: Configure a cluster network
+contentType: reference
---
## About networking for a {% data variables.product.prodname_ghe_server %} cluster
diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/configuring-high-availability-replication-for-a-cluster.md b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/configuring-high-availability-replication-for-a-cluster.md
index cbf61b8eea13..bb256c877caf 100644
--- a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/configuring-high-availability-replication-for-a-cluster.md
+++ b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/configuring-high-availability-replication-for-a-cluster.md
@@ -1,14 +1,14 @@
---
title: Configuring high availability replication for a cluster
-intro: 'You can configure a replica of your entire {% data variables.product.prodname_ghe_server %} cluster in a separate datacenter, allowing your cluster to fail over to redundant nodes.'
+intro: You can configure a replica of your entire {% data variables.product.prodname_ghe_server %} cluster in a separate datacenter, allowing your cluster to fail over to redundant nodes.
redirect_from:
- /enterprise/admin/enterprise-management/configuring-high-availability-replication-for-a-cluster
- /admin/enterprise-management/configuring-high-availability-replication-for-a-cluster
- /admin/monitoring-managing-and-updating-your-instance/configuring-clustering/configuring-high-availability-replication-for-a-cluster
versions:
ghes: '*'
-type: how_to
shortTitle: Configure HA replication
+contentType: how-tos
---
## About high availability replication for clusters
diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/deferring-database-seeding.md b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/deferring-database-seeding.md
index 2f145fbbfe9e..1c3cff93f2df 100644
--- a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/deferring-database-seeding.md
+++ b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/deferring-database-seeding.md
@@ -4,9 +4,9 @@ intro: You can speed up the process of adding a new MySQL replica node to your c
product: '{% data reusables.gated-features.cluster %}'
versions:
ghes: '*'
-type: how_to
redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/configuring-clustering/deferring-database-seeding
+contentType: how-tos
---
## About deferring database seeding of a MySQL replica node
diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/differences-between-clustering-and-high-availability-ha.md b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/differences-between-clustering-and-high-availability-ha.md
index 1b6e3757227a..6bc77b48f34b 100644
--- a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/differences-between-clustering-and-high-availability-ha.md
+++ b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/differences-between-clustering-and-high-availability-ha.md
@@ -1,6 +1,6 @@
---
title: Differences between clustering and high availability (HA)
-intro: 'Learn about the differences between deployment topologies for the virtual machines (VMs) that comprise a {% data variables.product.prodname_ghe_server %} instance.'
+intro: Learn about the differences between deployment topologies for the virtual machines (VMs) that comprise a {% data variables.product.prodname_ghe_server %} instance.
product: '{% data reusables.gated-features.cluster %}'
redirect_from:
- /enterprise/admin/clustering/differences-between-clustering-and-high-availability-ha
@@ -10,8 +10,8 @@ redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/configuring-clustering/differences-between-clustering-and-high-availability-ha
versions:
ghes: '*'
-type: reference
shortTitle: Choosing cluster or HA
+contentType: reference
---
## About deployment topologies for {% data variables.product.prodname_ghe_server %}
diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/initializing-the-cluster.md b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/initializing-the-cluster.md
index 9d98412cee46..ed1f51699ed0 100644
--- a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/initializing-the-cluster.md
+++ b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/initializing-the-cluster.md
@@ -1,6 +1,6 @@
---
title: Initializing the cluster
-intro: 'A {% data variables.product.prodname_ghe_server %} cluster must be set up with a license and initialized using the administrative shell (SSH).'
+intro: A {% data variables.product.prodname_ghe_server %} cluster must be set up with a license and initialized using the administrative shell (SSH).
product: '{% data reusables.gated-features.cluster %}'
redirect_from:
- /enterprise/admin/clustering/initializing-the-cluster
@@ -10,7 +10,7 @@ redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/configuring-clustering/initializing-the-cluster
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About initialization of a {% data variables.product.prodname_ghe_server %} cluster
diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/initiating-a-failover-to-your-replica-cluster.md b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/initiating-a-failover-to-your-replica-cluster.md
index 85d68e8cf4c5..9149d9c17981 100644
--- a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/initiating-a-failover-to-your-replica-cluster.md
+++ b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/initiating-a-failover-to-your-replica-cluster.md
@@ -1,14 +1,14 @@
---
title: Initiating a failover to your replica cluster
-intro: 'If your {% data variables.product.prodname_ghe_server %} cluster fails, you can fail over to the replica.'
+intro: If your {% data variables.product.prodname_ghe_server %} cluster fails, you can fail over to the replica.
redirect_from:
- /enterprise/admin/enterprise-management/initiating-a-failover-to-your-replica-cluster
- /admin/enterprise-management/initiating-a-failover-to-your-replica-cluster
- /admin/monitoring-managing-and-updating-your-instance/configuring-clustering/initiating-a-failover-to-your-replica-cluster
versions:
ghes: '*'
-type: how_to
shortTitle: Initiate a failover to replica
+contentType: how-tos
---
## About failover to your replica cluster
diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/monitoring-the-health-of-your-cluster-nodes-with-node-eligibility-service.md b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/monitoring-the-health-of-your-cluster-nodes-with-node-eligibility-service.md
index 8988c119b87f..3da8b8bdd091 100644
--- a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/monitoring-the-health-of-your-cluster-nodes-with-node-eligibility-service.md
+++ b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/monitoring-the-health-of-your-cluster-nodes-with-node-eligibility-service.md
@@ -1,15 +1,15 @@
---
title: Monitoring the health of your cluster nodes with Node Eligibility Service
shortTitle: Node Eligibility Service
-intro: 'You can monitor when nodes in a {% data variables.product.prodname_ghe_server %} cluster have been offline long enough to cause issues by using {% data variables.product.prodname_nes %}.'
-permissions: 'People with administrative SSH access to a {% data variables.product.prodname_ghe_server %} instance can monitor cluster nodes.'
+intro: You can monitor when nodes in a {% data variables.product.prodname_ghe_server %} cluster have been offline long enough to cause issues by using {% data variables.product.prodname_nes %}.
+permissions: People with administrative SSH access to a {% data variables.product.prodname_ghe_server %} instance can monitor cluster nodes.
product: '{% data reusables.gated-features.cluster %}'
versions:
ghes: '*'
-type: how_to
redirect_from:
- /admin/enterprise-management/configuring-clustering/monitoring-the-health-of-your-cluster-nodes-with-node-eligibility-service
- /admin/monitoring-managing-and-updating-your-instance/configuring-clustering/monitoring-the-health-of-your-cluster-nodes-with-node-eligibility-service
+contentType: how-tos
---
## About {% data variables.product.prodname_nes %}
diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/monitoring-the-health-of-your-cluster.md b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/monitoring-the-health-of-your-cluster.md
index 1134f5e6f796..a4376a238add 100644
--- a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/monitoring-the-health-of-your-cluster.md
+++ b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/monitoring-the-health-of-your-cluster.md
@@ -1,7 +1,7 @@
---
title: Monitoring the health of your cluster
shortTitle: Monitor cluster health
-intro: 'To ensure the performance and redundancy of a {% data variables.product.prodname_ghe_server %} cluster, you can monitor the cluster''s health.'
+intro: To ensure the performance and redundancy of a {% data variables.product.prodname_ghe_server %} cluster, you can monitor the cluster's health.
product: '{% data reusables.gated-features.cluster %}'
redirect_from:
- /enterprise/admin/clustering/monitoring-cluster-nodes
@@ -12,7 +12,7 @@ redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/configuring-clustering/monitoring-the-health-of-your-cluster
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About {% data variables.product.prodname_ghe_server %} cluster health
diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/rebalancing-cluster-workloads.md b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/rebalancing-cluster-workloads.md
index c9d4152bdf16..0a472f6501ab 100644
--- a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/rebalancing-cluster-workloads.md
+++ b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/rebalancing-cluster-workloads.md
@@ -1,15 +1,15 @@
---
title: Rebalancing cluster workloads
shortTitle: Rebalance workloads
-intro: 'You can force your {% data variables.product.prodname_ghe_server %} cluster to evenly distribute job allocations for workloads on the cluster''s nodes.'
+intro: You can force your {% data variables.product.prodname_ghe_server %} cluster to evenly distribute job allocations for workloads on the cluster's nodes.
product: '{% data reusables.gated-features.cluster %}'
-permissions: 'People with administrative SSH access to a {% data variables.product.prodname_ghe_server %} instance can rebalance cluster workloads on the instance.'
+permissions: People with administrative SSH access to a {% data variables.product.prodname_ghe_server %} instance can rebalance cluster workloads on the instance.
versions:
ghes: '*'
-type: how_to
redirect_from:
- /admin/enterprise-management/configuring-clustering/rebalancing-cluster-workloads
- /admin/monitoring-managing-and-updating-your-instance/configuring-clustering/rebalancing-cluster-workloads
+contentType: how-tos
---
## About workload balance for a {% data variables.product.prodname_ghe_server %} cluster
diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/replacing-a-cluster-node.md b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/replacing-a-cluster-node.md
index 8de6d802d621..85d98459040d 100644
--- a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/replacing-a-cluster-node.md
+++ b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/replacing-a-cluster-node.md
@@ -1,6 +1,6 @@
---
title: Replacing a cluster node
-intro: 'If a node fails in a {% data variables.product.prodname_ghe_server %} cluster, or if you want to add a new node with more resources, mark any nodes to replace as offline, then add the new node.'
+intro: If a node fails in a {% data variables.product.prodname_ghe_server %} cluster, or if you want to add a new node with more resources, mark any nodes to replace as offline, then add the new node.
product: '{% data reusables.gated-features.cluster %}'
redirect_from:
- /enterprise/admin/clustering/replacing-a-cluster-node
@@ -10,7 +10,7 @@ redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/configuring-clustering/replacing-a-cluster-node
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About replacement of {% data variables.product.prodname_ghe_server %} cluster nodes
diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/upgrading-a-cluster.md b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/upgrading-a-cluster.md
index 90cd012fa1b8..f7a5d4d4336b 100644
--- a/content/admin/monitoring-and-managing-your-instance/configuring-clustering/upgrading-a-cluster.md
+++ b/content/admin/monitoring-and-managing-your-instance/configuring-clustering/upgrading-a-cluster.md
@@ -1,6 +1,6 @@
---
title: Upgrading a cluster
-intro: 'To upgrade a {% data variables.product.prodname_ghe_server %} cluster to the latest release, use the administrative shell (SSH).'
+intro: To upgrade a {% data variables.product.prodname_ghe_server %} cluster to the latest release, use the administrative shell (SSH).
product: '{% data reusables.gated-features.cluster %}'
redirect_from:
- /enterprise/admin/clustering/upgrading-a-cluster
@@ -10,7 +10,7 @@ redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/configuring-clustering/upgrading-a-cluster
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
## About upgrades to a {% data variables.product.prodname_ghe_server %} cluster
diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/about-geo-replication.md b/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/about-geo-replication.md
index 301cfbe65cf5..9fd103343de0 100644
--- a/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/about-geo-replication.md
+++ b/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/about-geo-replication.md
@@ -1,6 +1,6 @@
---
title: About geo-replication
-intro: 'Geo-replication on {% data variables.product.prodname_ghe_server %} uses multiple active replicas to fulfill requests from geographically distributed data centers.'
+intro: Geo-replication on {% data variables.product.prodname_ghe_server %} uses multiple active replicas to fulfill requests from geographically distributed data centers.
redirect_from:
- /enterprise/admin/installation/about-geo-replication
- /enterprise/admin/enterprise-management/about-geo-replication
@@ -9,7 +9,7 @@ redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/configuring-high-availability/about-geo-replication
versions:
ghes: '*'
-type: overview
+contentType: concepts
---
Multiple active replicas can provide a shorter distance to the nearest replica. For example, an organization with offices in San Francisco, New York, and London could run the primary appliance in a datacenter near New York and two replicas in datacenters near San Francisco and London. Using geolocation-aware DNS, users can be directed to the closest server available and access repository data faster. Designating the appliance near New York as the primary helps reduce the latency between the hosts, compared to the appliance near San Francisco being the primary which has a higher latency to London.
diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/about-high-availability-configuration.md b/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/about-high-availability-configuration.md
index 7306c599962d..25887519ff99 100644
--- a/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/about-high-availability-configuration.md
+++ b/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/about-high-availability-configuration.md
@@ -1,6 +1,6 @@
---
title: About high availability configuration
-intro: 'In a high availability configuration, a fully redundant secondary {% data variables.product.prodname_ghe_server %} appliance is kept in sync with the primary appliance through replication of all major datastores.'
+intro: In a high availability configuration, a fully redundant secondary {% data variables.product.prodname_ghe_server %} appliance is kept in sync with the primary appliance through replication of all major datastores.
redirect_from:
- /enterprise/admin/installation/about-high-availability-configuration
- /enterprise/admin/enterprise-management/about-high-availability-configuration
@@ -9,8 +9,8 @@ redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/configuring-high-availability/about-high-availability-configuration
versions:
ghes: '*'
-type: overview
shortTitle: About HA configuration
+contentType: concepts
---
When you configure high availability, there is an automated setup of one-way, asynchronous replication of all datastores (Git repositories, MySQL, Redis, and Elasticsearch) from the primary to the replica appliance. Most {% data variables.product.prodname_ghe_server %} configuration settings are also replicated, including the {% data variables.enterprise.management_console %} password. For more information, see [AUTOTITLE](/admin/configuration/administering-your-instance-from-the-management-console).
diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/creating-a-high-availability-replica.md b/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/creating-a-high-availability-replica.md
index d9a8ce4e91de..7f43574c9c6e 100644
--- a/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/creating-a-high-availability-replica.md
+++ b/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/creating-a-high-availability-replica.md
@@ -1,6 +1,6 @@
---
title: Creating a high availability replica
-intro: 'In an active/passive configuration, the replica appliance is a redundant copy of the primary appliance. If the primary appliance fails, high availability mode allows the replica to act as the primary appliance, allowing minimal service disruption.'
+intro: In an active/passive configuration, the replica appliance is a redundant copy of the primary appliance. If the primary appliance fails, high availability mode allows the replica to act as the primary appliance, allowing minimal service disruption.
redirect_from:
- /enterprise/admin/installation/creating-a-high-availability-replica
- /enterprise/admin/enterprise-management/creating-a-high-availability-replica
@@ -9,8 +9,8 @@ redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/configuring-high-availability/creating-a-high-availability-replica
versions:
ghes: '*'
-type: how_to
shortTitle: Create HA replica
+contentType: how-tos
---
{% data reusables.enterprise_installation.replica-limit %}
diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/initiating-a-failover-to-your-replica-appliance.md b/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/initiating-a-failover-to-your-replica-appliance.md
index e1bc540a9852..fc0208cd0b57 100644
--- a/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/initiating-a-failover-to-your-replica-appliance.md
+++ b/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/initiating-a-failover-to-your-replica-appliance.md
@@ -1,6 +1,6 @@
---
title: Initiating a failover to your replica appliance
-intro: 'You can failover to a {% data variables.product.prodname_ghe_server %} replica appliance using the command line for maintenance and testing, or if the primary appliance fails.'
+intro: You can failover to a {% data variables.product.prodname_ghe_server %} replica appliance using the command line for maintenance and testing, or if the primary appliance fails.
redirect_from:
- /enterprise/admin/installation/initiating-a-failover-to-your-replica-appliance
- /enterprise/admin/enterprise-management/initiating-a-failover-to-your-replica-appliance
@@ -9,8 +9,8 @@ redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/configuring-high-availability/initiating-a-failover-to-your-replica-appliance
versions:
ghes: '*'
-type: how_to
shortTitle: Initiate failover to appliance
+contentType: how-tos
---
The time required to failover depends on how long it takes to manually promote the replica and redirect traffic. The average time ranges between 20-30 minutes.
diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/monitoring-a-high-availability-configuration.md b/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/monitoring-a-high-availability-configuration.md
index fff1e0b3ec01..084a9545cf4c 100644
--- a/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/monitoring-a-high-availability-configuration.md
+++ b/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/monitoring-a-high-availability-configuration.md
@@ -1,14 +1,14 @@
---
title: Monitoring a high-availability configuration
-intro: 'After configuration of high availability for {% data variables.location.product_location %}, you can monitor the status of data replication among to your instance''s replica nodes.'
+intro: After configuration of high availability for {% data variables.location.product_location %}, you can monitor the status of data replication among to your instance's replica nodes.
versions:
ghes: '*'
-permissions: 'Site administrators can monitor a high-availability configuration for a {% data variables.product.prodname_ghe_server %} instance.'
-type: how_to
+permissions: Site administrators can monitor a high-availability configuration for a {% data variables.product.prodname_ghe_server %} instance.
shortTitle: Monitor HA configuration
redirect_from:
- /admin/enterprise-management/configuring-high-availability/monitoring-a-high-availability-configuration
- /admin/monitoring-managing-and-updating-your-instance/configuring-high-availability/monitoring-a-high-availability-configuration
+contentType: how-tos
---
## About observability for high availability
diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/recovering-a-high-availability-configuration.md b/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/recovering-a-high-availability-configuration.md
index 03bb3dd6686e..37df36d754f4 100644
--- a/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/recovering-a-high-availability-configuration.md
+++ b/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/recovering-a-high-availability-configuration.md
@@ -1,6 +1,6 @@
---
title: Recovering a high availability configuration
-intro: 'After failing over to a {% data variables.product.prodname_ghe_server %} appliance, you should regain redundancy as soon as possible rather than rely on a single appliance.'
+intro: After failing over to a {% data variables.product.prodname_ghe_server %} appliance, you should regain redundancy as soon as possible rather than rely on a single appliance.
redirect_from:
- /enterprise/admin/installation/recovering-a-high-availability-configuration
- /enterprise/admin/enterprise-management/recovering-a-high-availability-configuration
@@ -9,8 +9,8 @@ redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/configuring-high-availability/recovering-a-high-availability-configuration
versions:
ghes: '*'
-type: how_to
shortTitle: Recover a HA configuration
+contentType: how-tos
---
## About recovery for a high availability configuration
diff --git a/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/removing-a-high-availability-replica.md b/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/removing-a-high-availability-replica.md
index 171d6a9b5b04..d31a2dac24ea 100644
--- a/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/removing-a-high-availability-replica.md
+++ b/content/admin/monitoring-and-managing-your-instance/configuring-high-availability/removing-a-high-availability-replica.md
@@ -1,6 +1,6 @@
---
title: Removing a high availability replica
-intro: 'You can stop replication to a {% data variables.product.prodname_ghe_server %} replica temporarily, or permanently remove replication.'
+intro: You can stop replication to a {% data variables.product.prodname_ghe_server %} replica temporarily, or permanently remove replication.
redirect_from:
- /enterprise/admin/installation/removing-a-high-availability-replica
- /enterprise/admin/enterprise-management/removing-a-high-availability-replica
@@ -9,8 +9,8 @@ redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/configuring-high-availability/removing-a-high-availability-replica
versions:
ghes: '*'
-type: how_to
shortTitle: Remove a HA replica
+contentType: how-tos
---
## Stopping replication temporarily
diff --git a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/about-system-logs.md b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/about-system-logs.md
index b59d6f80a01a..9d45ecafd9be 100644
--- a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/about-system-logs.md
+++ b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/about-system-logs.md
@@ -1,13 +1,13 @@
---
title: About system logs
-intro: 'To help administrators understand activity and errors, {% data variables.product.prodname_ghe_server %} stores system logs.'
+intro: To help administrators understand activity and errors, {% data variables.product.prodname_ghe_server %} stores system logs.
versions:
ghes: '*'
-type: overview
redirect_from:
- /admin/enterprise-management/monitoring-your-appliance/about-system-logs
- /admin/monitoring-managing-and-updating-your-instance/monitoring-your-appliance/about-system-logs
- /admin/monitoring-managing-and-updating-your-instance/monitoring-your-instance/about-system-logs
+contentType: concepts
---
## About system logs for {% data variables.product.prodname_ghe_server %}
diff --git a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/about-the-monitor-dashboards.md b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/about-the-monitor-dashboards.md
index 6f46316a67a8..b0ed6e26f7f5 100644
--- a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/about-the-monitor-dashboards.md
+++ b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/about-the-monitor-dashboards.md
@@ -1,7 +1,7 @@
---
-title: 'About the monitor {% ifversion ghes > 3.15 %}dashboards{% else %}dashboard{% endif %}'
+title: About the monitor {% ifversion ghes > 3.15 %}dashboards{% else %}dashboard{% endif %}
allowTitleToDifferFromFilename: true
-intro: 'View historical data for details like CPU and storage usage, application and authentication response times, and general system health.'
+intro: View historical data for details like CPU and storage usage, application and authentication response times, and general system health.
redirect_from:
- /enterprise/admin/installation/accessing-the-monitor-dashboard
- /enterprise/admin/enterprise-management/accessing-the-monitor-dashboard
@@ -12,8 +12,8 @@ redirect_from:
- /admin/monitoring-and-managing-your-instance/monitoring-your-instance/accessing-the-monitor-dashboard
versions:
ghes: '*'
-type: how_to
shortTitle: About monitor {% ifversion ghes > 3.15 %}dashboards{% else %}dashboard{% endif %}
+contentType: how-tos
---
## Accessing the monitor {% ifversion ghes > 3.15 %}dashboards{% else %}dashboard{% endif %}
diff --git a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/collectd-metrics/about-collectd-metrics.md b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/collectd-metrics/about-collectd-metrics.md
index af893f9d50df..315189629dce 100644
--- a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/collectd-metrics/about-collectd-metrics.md
+++ b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/collectd-metrics/about-collectd-metrics.md
@@ -3,8 +3,8 @@ title: About Collectd metrics
intro: '{% ifversion ghes-opentelemetry %}Collectd metrics provide a legacy monitoring solution for {% data variables.product.prodname_ghe_server %} instances that is supported alongside a {% data variables.release-phases.public_preview %} of OpenTelemetry metrics.{% else %}Collectd metrics provide a monitoring solution for {% data variables.product.prodname_ghe_server %} instances.{% endif %}'
versions:
ghes: '*'
-type: overview
shortTitle: About Collectd metrics
+contentType: concepts
---
{% data reusables.enterprise.collectd-metrics-future %}
diff --git a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/collectd-metrics/collectd-metrics-for-github-enterprise-server.md b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/collectd-metrics/collectd-metrics-for-github-enterprise-server.md
index 0720ba94ebb4..f2f269a8a3e5 100644
--- a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/collectd-metrics/collectd-metrics-for-github-enterprise-server.md
+++ b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/collectd-metrics/collectd-metrics-for-github-enterprise-server.md
@@ -1,12 +1,12 @@
---
title: collectd metrics for GitHub Enterprise Server
shortTitle: collectd metrics
-intro: 'You can review the metrics that `collectd` gathers for {% data variables.location.product_location %}.'
+intro: You can review the metrics that `collectd` gathers for {% data variables.location.product_location %}.
versions:
ghes: '*'
-type: reference
redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/monitoring-your-instance/collectd-metrics-for-github-enterprise-server
+contentType: reference
---
{% data reusables.enterprise.collectd-metrics-future %}
diff --git a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/collectd-metrics/exporting-and-scraping-prometheus-metrics.md b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/collectd-metrics/exporting-and-scraping-prometheus-metrics.md
index 2769f6ea6f01..369b2ad1f675 100644
--- a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/collectd-metrics/exporting-and-scraping-prometheus-metrics.md
+++ b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/collectd-metrics/exporting-and-scraping-prometheus-metrics.md
@@ -1,12 +1,12 @@
---
title: Exporting and scraping Prometheus metrics
shortTitle: Export and scrape Prometheus metrics
-intro: "{% data variables.product.prodname_ghe_server %} provides Prometheus-compatible metrics by transforming `collectd` data. These metrics can be scraped from a dedicated endpoint, allowing integration with observability and monitoring tools for performance insights."
+intro: '{% data variables.product.prodname_ghe_server %} provides Prometheus-compatible metrics by transforming `collectd` data. These metrics can be scraped from a dedicated endpoint, allowing integration with observability and monitoring tools for performance insights.'
versions:
feature: prometheus-metrics-exporter
-type: how_to
redirect_from:
- /admin/monitoring-and-managing-your-instance/monitoring-your-instance/exporting-and-scraping-prometheus-metrics
+contentType: how-tos
---
{% data reusables.enterprise.collectd-metrics-future %}
diff --git a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/collectd-metrics/setting-up-external-monitoring-with-collectd.md b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/collectd-metrics/setting-up-external-monitoring-with-collectd.md
index f41ec8e623ac..bd272d221960 100644
--- a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/collectd-metrics/setting-up-external-monitoring-with-collectd.md
+++ b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/collectd-metrics/setting-up-external-monitoring-with-collectd.md
@@ -1,6 +1,6 @@
---
title: Setting up external monitoring with collectd
-intro: 'Configure external monitoring systems to collect and analyze collectd metrics from your {% data variables.product.prodname_ghe_server %} instance.'
+intro: Configure external monitoring systems to collect and analyze collectd metrics from your {% data variables.product.prodname_ghe_server %} instance.
redirect_from:
- /enterprise/admin/installation/setting-up-external-monitoring
- /enterprise/admin/enterprise-management/setting-up-external-monitoring
@@ -19,8 +19,8 @@ redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/monitoring-your-instance/configuring-collectd-for-your-instance
versions:
ghes: '*'
-type: how_to
shortTitle: External monitoring with collectd
+contentType: how-tos
---
{% data reusables.enterprise.collectd-metrics-future %}
diff --git a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/generating-a-health-check-for-your-enterprise.md b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/generating-a-health-check-for-your-enterprise.md
index 58deeafdde03..1d2a3a2cc92d 100644
--- a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/generating-a-health-check-for-your-enterprise.md
+++ b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/generating-a-health-check-for-your-enterprise.md
@@ -1,14 +1,14 @@
---
title: Generating a Health Check for your enterprise
-intro: 'You can gain insight into the general health and Git and API requests of {% data variables.location.product_location %} by generating a Health Check.'
+intro: You can gain insight into the general health and Git and API requests of {% data variables.location.product_location %} by generating a Health Check.
versions:
ghes: '*'
-type: how_to
product: '{% data reusables.gated-features.generated-health-checks %}'
redirect_from:
- /admin/enterprise-management/monitoring-your-appliance/generating-a-health-check-for-your-enterprise
- /admin/monitoring-managing-and-updating-your-instance/monitoring-your-appliance/generating-a-health-check-for-your-enterprise
- /admin/monitoring-managing-and-updating-your-instance/monitoring-your-instance/generating-a-health-check-for-your-enterprise
+contentType: how-tos
---
> [!NOTE]
diff --git a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/monitoring-using-snmp.md b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/monitoring-using-snmp.md
index 71c7de0722ea..b852f319a416 100644
--- a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/monitoring-using-snmp.md
+++ b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/monitoring-using-snmp.md
@@ -11,7 +11,7 @@ redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/monitoring-your-instance/monitoring-using-snmp
versions:
ghes: '*'
-type: how_to
+contentType: how-tos
---
SNMP is a common standard for monitoring devices over a network. We strongly recommend enabling SNMP so you can monitor the health of {% data variables.location.product_location %} and know when to add more memory, storage, or processor power to the host machine.
diff --git a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/about-opentelemetry-metrics.md b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/about-opentelemetry-metrics.md
index d4a929c10483..d07d15957877 100644
--- a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/about-opentelemetry-metrics.md
+++ b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/about-opentelemetry-metrics.md
@@ -1,10 +1,10 @@
---
title: About OpenTelemetry metrics
-intro: 'OpenTelemetry metrics provide a comprehensive monitoring solution for {% data variables.product.prodname_ghe_server %} instances, offering enhanced observability and management capabilities.'
+intro: OpenTelemetry metrics provide a comprehensive monitoring solution for {% data variables.product.prodname_ghe_server %} instances, offering enhanced observability and management capabilities.
versions:
feature: ghes-opentelemetry
-type: overview
shortTitle: OpenTelemetry metrics
+contentType: concepts
---
{% data reusables.enterprise.opentelemetry-migration %}
diff --git a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/advanced-dashboards.md b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/advanced-dashboards.md
index 607738e9582b..297a3b5cc13a 100644
--- a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/advanced-dashboards.md
+++ b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/advanced-dashboards.md
@@ -1,12 +1,12 @@
---
title: Advanced dashboards of OpenTelemetry metrics
-intro: 'After enabling OpenTelemetry metrics collection on your {% data variables.product.prodname_ghe_server %} instance, you have access to additional dashboards with enhanced visualization and monitoring capabilities.'
+intro: After enabling OpenTelemetry metrics collection on your {% data variables.product.prodname_ghe_server %} instance, you have access to additional dashboards with enhanced visualization and monitoring capabilities.
redirect_from:
- /enterprise/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/enable-advanced-dashboards
versions:
feature: ghes-opentelemetry
-type: how_to
shortTitle: Advanced dashboards
+contentType: how-tos
---
{% data reusables.enterprise.opentelemetry-migration %}
diff --git a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/configuring-opentelemetry-for-your-instance.md b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/configuring-opentelemetry-for-your-instance.md
index 65e285f4df73..c4968155eddf 100644
--- a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/configuring-opentelemetry-for-your-instance.md
+++ b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/configuring-opentelemetry-for-your-instance.md
@@ -1,10 +1,10 @@
---
title: Configuring OpenTelemetry for your instance
-intro: 'Learn how to configure OpenTelemetry metrics collection on your {% data variables.product.prodname_ghe_server %} instance for enhanced monitoring and observability.'
+intro: Learn how to configure OpenTelemetry metrics collection on your {% data variables.product.prodname_ghe_server %} instance for enhanced monitoring and observability.
versions:
feature: ghes-opentelemetry
-type: how_to
shortTitle: Configure OpenTelemetry
+contentType: how-tos
---
{% data reusables.enterprise.opentelemetry-migration %}
diff --git a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/setting-up-external-monitoring-with-opentelemetry.md b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/setting-up-external-monitoring-with-opentelemetry.md
index 40be7734c11e..62b8e16a4e2c 100644
--- a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/setting-up-external-monitoring-with-opentelemetry.md
+++ b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/setting-up-external-monitoring-with-opentelemetry.md
@@ -1,10 +1,10 @@
---
title: Setting up external monitoring with OpenTelemetry
-intro: 'Configure external monitoring systems to collect and analyze OpenTelemetry metrics from your {% data variables.product.prodname_ghe_server %} instance.'
+intro: Configure external monitoring systems to collect and analyze OpenTelemetry metrics from your {% data variables.product.prodname_ghe_server %} instance.
versions:
feature: ghes-opentelemetry
-type: how_to
shortTitle: External monitoring OpenTelemetry
+contentType: how-tos
---
{% ifversion ghes = 3.18 %}
diff --git a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/using-grafana-to-analyze-opentelemetry-metrics.md b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/using-grafana-to-analyze-opentelemetry-metrics.md
index 0b9577c63564..7ec36b8f429c 100644
--- a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/using-grafana-to-analyze-opentelemetry-metrics.md
+++ b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/using-grafana-to-analyze-opentelemetry-metrics.md
@@ -3,9 +3,8 @@ title: Using Grafana to analyze OpenTelemetry metrics
intro: Monitor the health and performance of your instance using dashboards and metrics provided by the OpenTelemetry metrics stack.
versions:
feature: ghes-opentelemetry
-type: how_to
shortTitle: Using Grafana to analyze metrics
-contentType: other
+contentType: how-tos
---
## Prerequisites
diff --git a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/recommended-alert-thresholds.md b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/recommended-alert-thresholds.md
index a7fd5a5b01b6..145b52c39b8f 100644
--- a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/recommended-alert-thresholds.md
+++ b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/recommended-alert-thresholds.md
@@ -1,6 +1,6 @@
---
title: Recommended alert thresholds
-intro: 'You can configure an alert to notify you of system resource issues before they affect your {% data variables.product.prodname_ghe_server %} appliance''s performance.'
+intro: You can configure an alert to notify you of system resource issues before they affect your {% data variables.product.prodname_ghe_server %} appliance's performance.
redirect_from:
- /enterprise/admin/guides/installation/about-recommended-alert-thresholds
- /enterprise/admin/installation/about-recommended-alert-thresholds
@@ -12,8 +12,8 @@ redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/monitoring-your-instance/recommended-alert-thresholds
versions:
ghes: '*'
-type: reference
shortTitle: Recommended alert thresholds
+contentType: reference
---
## About recommended alert thresholds
diff --git a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/troubleshooting-resource-allocation-problems.md b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/troubleshooting-resource-allocation-problems.md
index 44279fae9fa7..f2f9039d30d6 100644
--- a/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/troubleshooting-resource-allocation-problems.md
+++ b/content/admin/monitoring-and-managing-your-instance/monitoring-your-instance/troubleshooting-resource-allocation-problems.md
@@ -5,8 +5,8 @@ redirect_from:
- /enterprise/admin/installation/troubleshooting-resource-allocation-problems
versions:
ghes: '*'
-type: how_to
shortTitle: Troubleshooting resource allocation problems
+contentType: how-tos
---
## Troubleshooting common resource allocation problems on your appliance
diff --git a/content/admin/monitoring-and-managing-your-instance/multiple-data-disks/configuring-multiple-data-disks.md b/content/admin/monitoring-and-managing-your-instance/multiple-data-disks/configuring-multiple-data-disks.md
index edd37d520559..48a03cfa0025 100644
--- a/content/admin/monitoring-and-managing-your-instance/multiple-data-disks/configuring-multiple-data-disks.md
+++ b/content/admin/monitoring-and-managing-your-instance/multiple-data-disks/configuring-multiple-data-disks.md
@@ -1,10 +1,10 @@
---
title: Configuring multiple data disks
product: '{% data variables.product.prodname_ghe_server %}'
-intro: 'You can configure additional data disks and use them to host data of different services.'
+intro: You can configure additional data disks and use them to host data of different services.
versions:
ghes: '>= 3.19'
-type: overview
+contentType: concepts
---
> [!NOTE]
diff --git a/content/admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/changing-your-platform.md b/content/admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/changing-your-platform.md
index e31a5c672134..729ba0d9544c 100644
--- a/content/admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/changing-your-platform.md
+++ b/content/admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/changing-your-platform.md
@@ -1,10 +1,10 @@
---
title: Changing your platform
shortTitle: Changing platform
-intro: 'How to change the platform that runs {% data variables.location.product_location %}'
-type: how_to
+intro: How to change the platform that runs {% data variables.location.product_location %}
versions:
ghes: '*'
+contentType: how-tos
---
In some cases, you may need to change the platform on which {% data variables.location.product_location %} runs, such as moving from VMware to Azure.
diff --git a/content/admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/increasing-cpu-or-memory-resources.md b/content/admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/increasing-cpu-or-memory-resources.md
index 6b6ac5f7e1de..33c8e53eb402 100644
--- a/content/admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/increasing-cpu-or-memory-resources.md
+++ b/content/admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/increasing-cpu-or-memory-resources.md
@@ -1,6 +1,6 @@
---
title: Increasing CPU or memory resources
-intro: 'You can increase the CPU or memory resources for the virtual machine (VM) that runs {% data variables.location.product_location %}.'
+intro: You can increase the CPU or memory resources for the virtual machine (VM) that runs {% data variables.location.product_location %}.
redirect_from:
- /enterprise/admin/installation/increasing-cpu-or-memory-resources
- /enterprise/admin/enterprise-management/increasing-cpu-or-memory-resources
@@ -9,8 +9,8 @@ redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/updating-the-virtual-machine-and-physical-resources/increasing-cpu-or-memory-resources
versions:
ghes: '*'
-type: how_to
shortTitle: Increase CPU or memory
+contentType: how-tos
---
## About increasing CPU or memory resources
diff --git a/content/admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/increasing-storage-capacity.md b/content/admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/increasing-storage-capacity.md
index 165b5e1c4d37..a98da08a1c59 100644
--- a/content/admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/increasing-storage-capacity.md
+++ b/content/admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/increasing-storage-capacity.md
@@ -1,6 +1,6 @@
---
title: Increasing storage capacity
-intro: 'You can increase or change the amount of storage available for Git repositories, databases, search indexes, and other persistent application data.'
+intro: You can increase or change the amount of storage available for Git repositories, databases, search indexes, and other persistent application data.
redirect_from:
- /enterprise/admin/installation/increasing-storage-capacity
- /enterprise/admin/enterprise-management/increasing-storage-capacity
@@ -9,8 +9,8 @@ redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/updating-the-virtual-machine-and-physical-resources/increasing-storage-capacity
versions:
ghes: '*'
-type: how_to
shortTitle: Increase storage capacity
+contentType: how-tos
---
{% data reusables.enterprise_installation.warning-on-upgrading-physical-resources %}
diff --git a/content/admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/using-generation-2-virtual-machines.md b/content/admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/using-generation-2-virtual-machines.md
index ef1be7985c62..de13c39afe09 100644
--- a/content/admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/using-generation-2-virtual-machines.md
+++ b/content/admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/using-generation-2-virtual-machines.md
@@ -1,13 +1,13 @@
---
title: Using generation 2 virtual machines
-intro: 'New installs of {% data variables.product.prodname_ghe_server %} 3.14 or later can use generation 2 virtual machines.'
+intro: New installs of {% data variables.product.prodname_ghe_server %} 3.14 or later can use generation 2 virtual machines.
redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/updating-the-virtual-machine-and-physical-resources/using-generation-2-virtual-machines
versions:
ghes: '*'
-type: reference
shortTitle: Generation 2 virtual machines
allowTitleToDifferFromFilename: true
+contentType: reference
---
## About generation 2 virtual machines
diff --git a/content/admin/overview/about-github-enterprise-cloud.md b/content/admin/overview/about-github-enterprise-cloud.md
index f1abd5a77844..2f7533b44444 100644
--- a/content/admin/overview/about-github-enterprise-cloud.md
+++ b/content/admin/overview/about-github-enterprise-cloud.md
@@ -1,9 +1,9 @@
---
title: About GitHub Enterprise Cloud
-intro: 'Learn about {% data variables.product.prodname_ghe_cloud %}, its features, and management options for large businesses and teams.'
+intro: Learn about {% data variables.product.prodname_ghe_cloud %}, its features, and management options for large businesses and teams.
versions:
ghec: '*'
-type: overview
+contentType: concepts
---
{% data variables.product.prodname_ghe_cloud %} is a deployment option for {% data variables.product.prodname_enterprise %}, adding advanced features to {% data variables.product.prodname_dotcom %}, including:
diff --git a/content/admin/overview/about-github-enterprise-server.md b/content/admin/overview/about-github-enterprise-server.md
index a95bd4df48be..041c4c7fb2c0 100644
--- a/content/admin/overview/about-github-enterprise-server.md
+++ b/content/admin/overview/about-github-enterprise-server.md
@@ -1,9 +1,9 @@
---
title: About GitHub Enterprise Server
-intro: 'Find out if {% data variables.product.prodname_ghe_server %} is right for your business.'
+intro: Find out if {% data variables.product.prodname_ghe_server %} is right for your business.
versions:
ghes: '*'
-type: overview
+contentType: concepts
---
{% data reusables.enterprise.ghes-is-a-self-hosted-platform %} Your business can benefit from increased control and avoid issues associated the public cloud, while your developers can benefit from familiar features and workflows from {% data variables.product.prodname_dotcom_the_website %}.
diff --git a/content/admin/overview/about-github-for-enterprises.md b/content/admin/overview/about-github-for-enterprises.md
index d0661e58c1fc..ee5a31427ce5 100644
--- a/content/admin/overview/about-github-for-enterprises.md
+++ b/content/admin/overview/about-github-for-enterprises.md
@@ -1,10 +1,10 @@
---
title: About GitHub for enterprises
-intro: 'Learn about {% data variables.product.prodname_dotcom %}''s enterprise products and deployment options for {% data variables.product.prodname_enterprise %}.'
+intro: Learn about {% data variables.product.prodname_dotcom %}'s enterprise products and deployment options for {% data variables.product.prodname_enterprise %}.
versions:
ghec: '*'
ghes: '*'
-type: overview
+contentType: concepts
---
## Why should my business choose {% data variables.product.github %}?
diff --git a/content/admin/overview/about-upgrades-to-new-releases.md b/content/admin/overview/about-upgrades-to-new-releases.md
index c3b31bb4f76e..e9696ba65c6a 100644
--- a/content/admin/overview/about-upgrades-to-new-releases.md
+++ b/content/admin/overview/about-upgrades-to-new-releases.md
@@ -1,10 +1,10 @@
---
title: About upgrades to new releases
shortTitle: About upgrades
-intro: 'Learn about how features and bug fixes are added to {% data variables.product.prodname_ghe_server %} through new releases.'
+intro: Learn about how features and bug fixes are added to {% data variables.product.prodname_ghe_server %} through new releases.
versions:
ghes: '*'
-type: overview
+contentType: concepts
---
{% data reusables.enterprise.constantly-improving %}
diff --git a/content/admin/overview/accessing-compliance-reports-for-your-enterprise.md b/content/admin/overview/accessing-compliance-reports-for-your-enterprise.md
index 99e4badfc9bf..a2e4ae757c51 100644
--- a/content/admin/overview/accessing-compliance-reports-for-your-enterprise.md
+++ b/content/admin/overview/accessing-compliance-reports-for-your-enterprise.md
@@ -1,11 +1,11 @@
---
title: Accessing compliance reports for your enterprise
-intro: 'You can access {% data variables.product.company_short %}''s compliance reports, such as our SOC reports and Cloud Security Alliance CAIQ self-assessment (CSA CAIQ), for your enterprise.'
+intro: You can access {% data variables.product.company_short %}'s compliance reports, such as our SOC reports and Cloud Security Alliance CAIQ self-assessment (CSA CAIQ), for your enterprise.
versions:
ghec: '*'
-type: how_to
permissions: Enterprise owners can access compliance reports for the enterprise.
shortTitle: Access compliance reports
+contentType: how-tos
---
## About {% data variables.product.company_short %}'s compliance reports
diff --git a/content/admin/overview/establishing-a-governance-framework-for-your-enterprise.md b/content/admin/overview/establishing-a-governance-framework-for-your-enterprise.md
index 604e43f7f2ff..30530234a1f0 100644
--- a/content/admin/overview/establishing-a-governance-framework-for-your-enterprise.md
+++ b/content/admin/overview/establishing-a-governance-framework-for-your-enterprise.md
@@ -1,12 +1,12 @@
---
title: Establishing a governance framework for your enterprise
-intro: 'You can manage governance and compliance for your enterprise using features and tools available in {% data variables.product.prodname_enterprise %}.'
+intro: You can manage governance and compliance for your enterprise using features and tools available in {% data variables.product.prodname_enterprise %}.
shortTitle: Governance framework
allowTitleToDifferFromFilename: true
versions:
ghec: '*'
ghes: '*'
-type: overview
+contentType: concepts
---
As an enterprise owner, you are responsible for maintaining a strong security posture, complying with regulations, mitigating risks, and protecting intellectual property, within your enterprise. {% data variables.product.company_short %} has tools that can help with that.
diff --git a/content/admin/overview/system-overview.md b/content/admin/overview/system-overview.md
index 9d30ce243c42..c8011f5c8b25 100644
--- a/content/admin/overview/system-overview.md
+++ b/content/admin/overview/system-overview.md
@@ -1,12 +1,12 @@
---
title: System overview
-intro: 'Learn more about {% data variables.product.prodname_ghe_server %}''s system internals, functionality, and security.'
+intro: Learn more about {% data variables.product.prodname_ghe_server %}'s system internals, functionality, and security.
redirect_from:
- /enterprise/admin/installation/system-overview
- /enterprise/admin/overview/system-overview
versions:
ghes: '*'
-type: overview
+contentType: concepts
---
## About {% data variables.product.prodname_ghe_server %}
diff --git a/content/admin/upgrading-your-instance/performing-an-upgrade/migrating-from-github-enterprise-1110x-to-2123.md b/content/admin/upgrading-your-instance/performing-an-upgrade/migrating-from-github-enterprise-1110x-to-2123.md
index 7339ac6480c0..4c7a183c6a8c 100644
--- a/content/admin/upgrading-your-instance/performing-an-upgrade/migrating-from-github-enterprise-1110x-to-2123.md
+++ b/content/admin/upgrading-your-instance/performing-an-upgrade/migrating-from-github-enterprise-1110x-to-2123.md
@@ -13,11 +13,11 @@ redirect_from:
- /admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/migrating-from-github-enterprise-1110x-to-2123
- /admin/monitoring-managing-and-updating-your-instance/updating-the-virtual-machine-and-physical-resources/migrating-from-github-enterprise-1110x-to-2123
- /admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/migrating-from-github-enterprise-1110x-to-2123
-intro: 'To migrate from {% data variables.product.prodname_enterprise %} 11.10.x to 2.1.23, you''ll need to set up a new appliance instance and migrate data from the previous instance.'
+intro: To migrate from {% data variables.product.prodname_enterprise %} 11.10.x to 2.1.23, you'll need to set up a new appliance instance and migrate data from the previous instance.
versions:
ghes: '*'
-type: how_to
shortTitle: Migrate from 11.10.x to 2.1.23
+contentType: how-tos
---
> [!NOTE]
diff --git a/content/admin/upgrading-your-instance/performing-an-upgrade/preparing-for-the-elasticsearch-upgrade.md b/content/admin/upgrading-your-instance/performing-an-upgrade/preparing-for-the-elasticsearch-upgrade.md
index 412ee7fca37d..8d9f87fc9bf6 100644
--- a/content/admin/upgrading-your-instance/performing-an-upgrade/preparing-for-the-elasticsearch-upgrade.md
+++ b/content/admin/upgrading-your-instance/performing-an-upgrade/preparing-for-the-elasticsearch-upgrade.md
@@ -1,14 +1,14 @@
---
-title: 'Preparing for the Elasticsearch upgrade in {% data variables.product.prodname_ghe_server %} 3.13'
-intro: 'As part of upgrading {% data variables.product.prodname_ghe_server %} to version 3.13 or later, the Elasticsearch service will be upgraded.'
+title: Preparing for the Elasticsearch upgrade in {% data variables.product.prodname_ghe_server %} 3.13
+intro: As part of upgrading {% data variables.product.prodname_ghe_server %} to version 3.13 or later, the Elasticsearch service will be upgraded.
versions:
ghes: '>3.10 <3.15'
-type: reference
shortTitle: Elasticsearch upgrade in 3.13
allowTitleToDifferFromFilename: true
redirect_from:
- /admin/monitoring-managing-and-updating-your-instance/updating-the-virtual-machine-and-physical-resources/preparing-for-the-elasticsearch-upgrade
- /admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/preparing-for-the-elasticsearch-upgrade
+contentType: reference
---
## Overview
diff --git a/content/admin/upgrading-your-instance/performing-an-upgrade/upgrading-with-a-hotpatch.md b/content/admin/upgrading-your-instance/performing-an-upgrade/upgrading-with-a-hotpatch.md
index 64b6883d42e9..6ad96e4bdd38 100644
--- a/content/admin/upgrading-your-instance/performing-an-upgrade/upgrading-with-a-hotpatch.md
+++ b/content/admin/upgrading-your-instance/performing-an-upgrade/upgrading-with-a-hotpatch.md
@@ -1,16 +1,16 @@
---
- title: Upgrading with a hotpatch
- intro: 'You can use a hotpatch package to upgrade {% data variables.product.prodname_ghe_server %} to a newer patch release within a feature series.'
- redirect_from:
- - /admin/guides/installation/upgrading-github-enterprise-server#upgrading-with-a-hotpatch
- - /admin/monitoring-managing-and-updating-your-instance/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server#upgrading-with-a-hotpatch
- versions:
- ghes: '*'
- type: how_to
- topics:
- - Enterprise
- - Upgrades
- shortTitle: Upgrade with a hotpatch
+title: Upgrading with a hotpatch
+intro: You can use a hotpatch package to upgrade {% data variables.product.prodname_ghe_server %} to a newer patch release within a feature series.
+redirect_from:
+ - /admin/guides/installation/upgrading-github-enterprise-server#upgrading-with-a-hotpatch
+ - /admin/monitoring-managing-and-updating-your-instance/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server#upgrading-with-a-hotpatch
+versions:
+ ghes: '*'
+topics:
+ - Enterprise
+ - Upgrades
+shortTitle: Upgrade with a hotpatch
+contentType: how-tos
---
{% data reusables.enterprise_installation.hotpatching-explanation %}
diff --git a/content/admin/upgrading-your-instance/performing-an-upgrade/upgrading-with-an-upgrade-package.md b/content/admin/upgrading-your-instance/performing-an-upgrade/upgrading-with-an-upgrade-package.md
index 9e256c38391a..3c326fd5b3a2 100644
--- a/content/admin/upgrading-your-instance/performing-an-upgrade/upgrading-with-an-upgrade-package.md
+++ b/content/admin/upgrading-your-instance/performing-an-upgrade/upgrading-with-an-upgrade-package.md
@@ -1,16 +1,16 @@
---
- title: Upgrading with an upgrade package
- intro: 'Learn how to use an upgrade package to upgrade {% data variables.product.prodname_ghe_server %} to a newer feature release.'
- redirect_from:
- - /admin/monitoring-managing-and-updating-your-instance/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server#upgrading-a-standalone-instance-using-an-upgrade-package
- - /admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server#upgrading-with-an-upgrade-package
- versions:
- ghes: '*'
- type: how_to
- topics:
- - Enterprise
- - Upgrades
- shortTitle: Upgrade with an upgrade package
+title: Upgrading with an upgrade package
+intro: Learn how to use an upgrade package to upgrade {% data variables.product.prodname_ghe_server %} to a newer feature release.
+redirect_from:
+ - /admin/monitoring-managing-and-updating-your-instance/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server#upgrading-a-standalone-instance-using-an-upgrade-package
+ - /admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server#upgrading-with-an-upgrade-package
+versions:
+ ghes: '*'
+topics:
+ - Enterprise
+ - Upgrades
+shortTitle: Upgrade with an upgrade package
+contentType: how-tos
---
Using the administrative shell, you can install an upgrade package with the `ghe-upgrade` utility.
diff --git a/content/admin/upgrading-your-instance/preparing-to-upgrade/enabling-automatic-update-checks.md b/content/admin/upgrading-your-instance/preparing-to-upgrade/enabling-automatic-update-checks.md
index 2c28496783f2..b6b04fc24730 100644
--- a/content/admin/upgrading-your-instance/preparing-to-upgrade/enabling-automatic-update-checks.md
+++ b/content/admin/upgrading-your-instance/preparing-to-upgrade/enabling-automatic-update-checks.md
@@ -1,6 +1,6 @@
---
title: Enabling automatic update checks
-intro: 'You can enable automatic update checks so that {% data variables.location.product_location %} checks for and downloads the latest {% data variables.product.prodname_ghe_server %} release.'
+intro: You can enable automatic update checks so that {% data variables.location.product_location %} checks for and downloads the latest {% data variables.product.prodname_ghe_server %} release.
redirect_from:
- /enterprise/admin/installation/enabling-automatic-update-checks
- /enterprise/admin/enterprise-management/enabling-automatic-update-checks
@@ -10,8 +10,8 @@ redirect_from:
- /admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/enabling-automatic-update-checks
versions:
ghes: '*'
-type: how_to
shortTitle: Enable automatic update checks
+contentType: how-tos
---
## About automatic update checks
diff --git a/content/admin/upgrading-your-instance/preparing-to-upgrade/overview-of-the-upgrade-process.md b/content/admin/upgrading-your-instance/preparing-to-upgrade/overview-of-the-upgrade-process.md
index 29d21889f203..f655001086f8 100644
--- a/content/admin/upgrading-your-instance/preparing-to-upgrade/overview-of-the-upgrade-process.md
+++ b/content/admin/upgrading-your-instance/preparing-to-upgrade/overview-of-the-upgrade-process.md
@@ -1,28 +1,28 @@
---
- title: Overview of the upgrade process
- intro: 'Learn the recommendations and requirements for upgrading {% data variables.product.prodname_ghe_server %}, so you can plan and test your upgrade strategy.'
- redirect_from:
- - /enterprise/admin/installation/upgrading-github-enterprise-server
- - /enterprise/admin/articles/upgrading-to-the-latest-release
- - /enterprise/admin/articles/migrations-and-upgrades
- - /enterprise/admin/guides/installation/upgrading-the-github-enterprise-virtual-machine
- - /enterprise/admin/guides/installation/upgrade-packages-for-older-releases
- - /enterprise/admin/articles/upgrading-older-installations
- - /enterprise/admin/hidden/upgrading-older-installations
- - /enterprise/admin/hidden/upgrading-github-enterprise-using-a-hotpatch-early-access-program
- - /enterprise/admin/hidden/upgrading-github-enterprise-using-a-hotpatch
- - /enterprise/admin/guides/installation/upgrading-github-enterprise
- - /enterprise/admin/enterprise-management/upgrading-github-enterprise-server
- - /admin/enterprise-management/upgrading-github-enterprise-server
- - /admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server
- - /admin/monitoring-managing-and-updating-your-instance/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server
- versions:
- ghes: '*'
- type: overview
- topics:
- - Enterprise
- - Upgrades
- shortTitle: Upgrading overview
+title: Overview of the upgrade process
+intro: Learn the recommendations and requirements for upgrading {% data variables.product.prodname_ghe_server %}, so you can plan and test your upgrade strategy.
+redirect_from:
+ - /enterprise/admin/installation/upgrading-github-enterprise-server
+ - /enterprise/admin/articles/upgrading-to-the-latest-release
+ - /enterprise/admin/articles/migrations-and-upgrades
+ - /enterprise/admin/guides/installation/upgrading-the-github-enterprise-virtual-machine
+ - /enterprise/admin/guides/installation/upgrade-packages-for-older-releases
+ - /enterprise/admin/articles/upgrading-older-installations
+ - /enterprise/admin/hidden/upgrading-older-installations
+ - /enterprise/admin/hidden/upgrading-github-enterprise-using-a-hotpatch-early-access-program
+ - /enterprise/admin/hidden/upgrading-github-enterprise-using-a-hotpatch
+ - /enterprise/admin/guides/installation/upgrading-github-enterprise
+ - /enterprise/admin/enterprise-management/upgrading-github-enterprise-server
+ - /admin/enterprise-management/upgrading-github-enterprise-server
+ - /admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server
+ - /admin/monitoring-managing-and-updating-your-instance/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server
+versions:
+ ghes: '*'
+topics:
+ - Enterprise
+ - Upgrades
+shortTitle: Upgrading overview
+contentType: concepts
---
{% data reusables.enterprise.constantly-improving %} You are responsible for upgrades to your instance. See [AUTOTITLE](/admin/overview/about-upgrades-to-new-releases).
diff --git a/content/admin/upgrading-your-instance/preparing-to-upgrade/taking-a-snapshot.md b/content/admin/upgrading-your-instance/preparing-to-upgrade/taking-a-snapshot.md
index ba103ca05553..b188cd9742c9 100644
--- a/content/admin/upgrading-your-instance/preparing-to-upgrade/taking-a-snapshot.md
+++ b/content/admin/upgrading-your-instance/preparing-to-upgrade/taking-a-snapshot.md
@@ -1,16 +1,16 @@
---
- title: Taking a snapshot
- intro: 'To save your {% data variables.product.prodname_ghe_server %} data before upgrading, take a virtual machine snapshot.'
- redirect_from:
- - /admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server#taking-a-snapshot
- - /enterprise/admin/installation/upgrading-github-enterprise-server#taking-a-snapshot
- versions:
- ghes: '*'
- type: how_to
- topics:
- - Enterprise
- - Upgrades
- shortTitle: Take a snapshot
+title: Taking a snapshot
+intro: To save your {% data variables.product.prodname_ghe_server %} data before upgrading, take a virtual machine snapshot.
+redirect_from:
+ - /admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server#taking-a-snapshot
+ - /enterprise/admin/installation/upgrading-github-enterprise-server#taking-a-snapshot
+versions:
+ ghes: '*'
+topics:
+ - Enterprise
+ - Upgrades
+shortTitle: Take a snapshot
+contentType: how-tos
---
## About snapshots
diff --git a/content/admin/upgrading-your-instance/preparing-to-upgrade/upgrade-requirements.md b/content/admin/upgrading-your-instance/preparing-to-upgrade/upgrade-requirements.md
index 60a4c4010196..883ebda7b237 100644
--- a/content/admin/upgrading-your-instance/preparing-to-upgrade/upgrade-requirements.md
+++ b/content/admin/upgrading-your-instance/preparing-to-upgrade/upgrade-requirements.md
@@ -1,6 +1,6 @@
---
title: Upgrade requirements
-intro: 'Before upgrading {% data variables.product.prodname_ghe_server %}, review these recommendations and requirements to plan your upgrade strategy.'
+intro: Before upgrading {% data variables.product.prodname_ghe_server %}, review these recommendations and requirements to plan your upgrade strategy.
redirect_from:
- /enterprise/admin/installation/upgrade-requirements
- /enterprise/admin/guides/installation/finding-the-current-github-enterprise-release
@@ -12,7 +12,7 @@ redirect_from:
- /admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/upgrade-requirements
versions:
ghes: '*'
-type: reference
+contentType: reference
---
> [!NOTE]
diff --git a/content/admin/upgrading-your-instance/troubleshooting-upgrades/known-issues-with-upgrades-to-your-instance.md b/content/admin/upgrading-your-instance/troubleshooting-upgrades/known-issues-with-upgrades-to-your-instance.md
index a84da42e1d46..f8fe70de5aeb 100644
--- a/content/admin/upgrading-your-instance/troubleshooting-upgrades/known-issues-with-upgrades-to-your-instance.md
+++ b/content/admin/upgrading-your-instance/troubleshooting-upgrades/known-issues-with-upgrades-to-your-instance.md
@@ -1,14 +1,14 @@
---
title: Known issues with upgrades to your instance
-intro: 'See an overview of workarounds for issues that impact the upgrade process for {% data variables.product.prodname_ghe_server %}, or impact your instance after you complete an upgrade.'
+intro: See an overview of workarounds for issues that impact the upgrade process for {% data variables.product.prodname_ghe_server %}, or impact your instance after you complete an upgrade.
versions:
ghes: '*'
-type: overview
shortTitle: Known issues with upgrades
redirect_from:
- /admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/known-issues-with-upgrades-to-your-instance
- /admin/monitoring-managing-and-updating-your-instance/updating-the-virtual-machine-and-physical-resources/known-issues-with-upgrades-to-your-instance
- /admin/monitoring-and-managing-your-instance/updating-the-virtual-machine-and-physical-resources/known-issues-with-upgrades-to-your-instance
+contentType: concepts
---
## About known issues with {% data variables.product.prodname_ghe_server %} upgrades
diff --git a/content/admin/upgrading-your-instance/troubleshooting-upgrades/restoring-from-a-failed-upgrade.md b/content/admin/upgrading-your-instance/troubleshooting-upgrades/restoring-from-a-failed-upgrade.md
index e1475faea1cb..12a7c9ab61dd 100644
--- a/content/admin/upgrading-your-instance/troubleshooting-upgrades/restoring-from-a-failed-upgrade.md
+++ b/content/admin/upgrading-your-instance/troubleshooting-upgrades/restoring-from-a-failed-upgrade.md
@@ -1,16 +1,16 @@
---
- title: Restoring from a failed upgrade
- intro: 'Learn how to roll back from a failed upgrade.'
- redirect_from:
- - /admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server#restoring-from-a-failed-upgrade
- versions:
- ghes: '*'
- type: how_to
- topics:
- - Enterprise
- - Upgrades
- - Troubleshooting
- shortTitle: Restore from a failed upgrade
+title: Restoring from a failed upgrade
+intro: Learn how to roll back from a failed upgrade.
+redirect_from:
+ - /admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server#restoring-from-a-failed-upgrade
+versions:
+ ghes: '*'
+topics:
+ - Enterprise
+ - Upgrades
+ - Troubleshooting
+shortTitle: Restore from a failed upgrade
+contentType: how-tos
---
If an upgrade fails or is interrupted, you should revert your instance back to its previous state. The process for completing this depends on the type of upgrade.
diff --git a/content/apps/overview.md b/content/apps/overview.md
index b60b83a16706..56c10b434622 100644
--- a/content/apps/overview.md
+++ b/content/apps/overview.md
@@ -1,13 +1,13 @@
---
title: GitHub Apps overview
shortTitle: Overview
-intro: 'You can use {% data variables.product.prodname_github_apps %} to extend the functionality of {% data variables.product.company_short %}.'
+intro: You can use {% data variables.product.prodname_github_apps %} to extend the functionality of {% data variables.product.company_short %}.
allowTitleToDifferFromFilename: true
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
+contentType: concepts
---
## About {% data variables.product.prodname_github_apps %}
diff --git a/content/authentication/authenticating-with-a-passkey/managing-your-passkeys.md b/content/authentication/authenticating-with-a-passkey/managing-your-passkeys.md
index 7ac14c644164..ea26fb32308e 100644
--- a/content/authentication/authenticating-with-a-passkey/managing-your-passkeys.md
+++ b/content/authentication/authenticating-with-a-passkey/managing-your-passkeys.md
@@ -1,13 +1,13 @@
---
title: Managing your passkeys
-intro: 'You may be prompted to register a passkey during sign-in, or you can choose to register a new passkey in your account settings. For 2FA users, you can upgrade existing eligible security keys into passkeys.'
+intro: You may be prompted to register a passkey during sign-in, or you can choose to register a new passkey in your account settings. For 2FA users, you can upgrade existing eligible security keys into passkeys.
permissions: '{% ifversion fpt or ghec%}Personal account owners who manage their own credentials{% endif %}'
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: how_to
shortTitle: Manage your passkeys
+contentType: how-tos
---
{% data reusables.passkeys.ghes-disable %}
diff --git a/content/authentication/authenticating-with-a-passkey/signing-in-with-a-passkey.md b/content/authentication/authenticating-with-a-passkey/signing-in-with-a-passkey.md
index 48a1aca68758..1baf02ee344e 100644
--- a/content/authentication/authenticating-with-a-passkey/signing-in-with-a-passkey.md
+++ b/content/authentication/authenticating-with-a-passkey/signing-in-with-a-passkey.md
@@ -1,13 +1,13 @@
---
title: Signing in with a passkey
-intro: 'You can use a passkey to sign in safely and easily to {% data variables.product.prodname_dotcom %} in your browser, without requiring a password and two-factor authentication. You can also sign in using a passkey on a nearby device.'
+intro: You can use a passkey to sign in safely and easily to {% data variables.product.prodname_dotcom %} in your browser, without requiring a password and two-factor authentication. You can also sign in using a passkey on a nearby device.
permissions: '{% ifversion fpt or ghec%}Personal account owners who manage their own credentials{% endif %}'
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: how_to
shortTitle: Sign in with a passkey
+contentType: how-tos
---
{% data reusables.passkeys.ghes-disable %}
diff --git a/content/authentication/authenticating-with-single-sign-on/viewing-and-managing-your-active-sso-sessions.md b/content/authentication/authenticating-with-single-sign-on/viewing-and-managing-your-active-sso-sessions.md
index 6f445e70cfb5..0cf3d3455d3e 100644
--- a/content/authentication/authenticating-with-single-sign-on/viewing-and-managing-your-active-sso-sessions.md
+++ b/content/authentication/authenticating-with-single-sign-on/viewing-and-managing-your-active-sso-sessions.md
@@ -8,8 +8,8 @@ redirect_from:
- /authentication/authenticating-with-saml-single-sign-on/viewing-and-managing-your-active-saml-sessions
versions:
ghec: '*'
-type: how_to
shortTitle: Active SSO sessions
+contentType: how-tos
---
You can view a list of devices that have logged into your account, and revoke any SSO sessions that you don't recognize.
diff --git a/content/authentication/keeping-your-account-and-data-secure/switching-between-accounts.md b/content/authentication/keeping-your-account-and-data-secure/switching-between-accounts.md
index d308ca91e593..c278e7a93bcc 100644
--- a/content/authentication/keeping-your-account-and-data-secure/switching-between-accounts.md
+++ b/content/authentication/keeping-your-account-and-data-secure/switching-between-accounts.md
@@ -1,12 +1,12 @@
---
title: Switching between accounts
-intro: 'Learn how to switch between multiple {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %} accounts and {% data variables.enterprise.prodname_managed_users %}{% else %}accounts{% endif %}.'
+intro: Learn how to switch between multiple {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %} accounts and {% data variables.enterprise.prodname_managed_users %}{% else %}accounts{% endif %}.
allowTitleToDifferFromFilename: true
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: overview
+contentType: concepts
---
If you need to use multiple accounts on {% data variables.product.prodname_dotcom %}, you can sign in to your accounts and switch between them without always being required to reauthenticate. You can use the account switcher if you have a personal account and service accounts (sometimes called machine users){% ifversion fpt or ghec %} or if you need to switch between your personal account and {% data variables.enterprise.prodname_managed_users %} in an enterprise that uses {% data variables.product.prodname_emus %}{% endif %}.
diff --git a/content/authentication/keeping-your-account-and-data-secure/viewing-and-managing-your-sessions.md b/content/authentication/keeping-your-account-and-data-secure/viewing-and-managing-your-sessions.md
index a4b03ea9fc29..5137fbfc2fcf 100644
--- a/content/authentication/keeping-your-account-and-data-secure/viewing-and-managing-your-sessions.md
+++ b/content/authentication/keeping-your-account-and-data-secure/viewing-and-managing-your-sessions.md
@@ -5,9 +5,8 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-
-type: how_to
shortTitle: Viewing and managing sessions
+contentType: how-tos
---
You can view a list of devices that have logged into your account, and revoke any sessions that you don't recognize.
diff --git a/content/code-security/reference/secret-security/risk-report-csv-contents.md b/content/code-security/reference/secret-security/risk-report-csv-contents.md
index 3c4cd9ee7728..779af5f9333d 100644
--- a/content/code-security/reference/secret-security/risk-report-csv-contents.md
+++ b/content/code-security/reference/secret-security/risk-report-csv-contents.md
@@ -4,7 +4,6 @@ shortTitle: Risk report CSV contents
intro: Understand the data included in the CSV export of the {% data variables.product.prodname_secret_risk_assessment %} report.
product: '{% data reusables.gated-features.secret-risk-assessment-report %}'
permissions: '{% data reusables.permissions.secret-risk-assessment-report-generation %}'
-type: reference
versions:
feature: secret-risk-assessment
topics:
diff --git a/content/codespaces/about-codespaces/codespaces-features.md b/content/codespaces/about-codespaces/codespaces-features.md
index 27ca16a9574e..c737dd7f04b2 100644
--- a/content/codespaces/about-codespaces/codespaces-features.md
+++ b/content/codespaces/about-codespaces/codespaces-features.md
@@ -2,11 +2,11 @@
title: GitHub Codespaces features
shortTitle: Codespaces features
allowTitleToDifferFromFilename: true
-intro: 'Learn about what GitHub Codespaces offer.'
+intro: Learn about what GitHub Codespaces offer.
versions:
fpt: '*'
ghec: '*'
-type: overview
+contentType: concepts
---
## {% data variables.product.prodname_github_codespaces %} features
diff --git a/content/codespaces/about-codespaces/deep-dive.md b/content/codespaces/about-codespaces/deep-dive.md
index 59b9ca7296c6..1e64d6569485 100644
--- a/content/codespaces/about-codespaces/deep-dive.md
+++ b/content/codespaces/about-codespaces/deep-dive.md
@@ -1,14 +1,14 @@
---
-title: 'Deep dive into {% data variables.product.prodname_github_codespaces %}'
-shortTitle: 'Deep dive into {% data variables.product.prodname_codespaces %}'
-intro: 'Explore more detail about how {% data variables.product.prodname_github_codespaces %} work.'
+title: Deep dive into {% data variables.product.prodname_github_codespaces %}
+shortTitle: Deep dive into {% data variables.product.prodname_codespaces %}
+intro: Explore more detail about how {% data variables.product.prodname_github_codespaces %} work.
allowTitleToDifferFromFilename: true
versions:
fpt: '*'
ghec: '*'
-type: quick_start
redirect_from:
- /codespaces/getting-started/deep-dive
+contentType: get-started
---
{% data variables.product.prodname_github_codespaces %} is an instant, cloud-based development environment that uses a container to provide you with common languages, tools, and utilities for development. {% data variables.product.prodname_github_codespaces %} is also configurable, allowing you to create a customized development environment for your project. By configuring a custom development environment for your project, you can have a repeatable codespace configuration for all users of your project.
diff --git a/content/codespaces/about-codespaces/understanding-the-codespace-lifecycle.md b/content/codespaces/about-codespaces/understanding-the-codespace-lifecycle.md
index 17d782fd9ff3..ec19ed93d366 100644
--- a/content/codespaces/about-codespaces/understanding-the-codespace-lifecycle.md
+++ b/content/codespaces/about-codespaces/understanding-the-codespace-lifecycle.md
@@ -1,16 +1,16 @@
---
title: Understanding the codespace lifecycle
shortTitle: The codespace lifecycle
-intro: 'Learn how to develop in a {% data variables.product.prodname_github_codespaces %} environment, and maintain your data throughout the entire codespace lifecycle.'
+intro: Learn how to develop in a {% data variables.product.prodname_github_codespaces %} environment, and maintain your data throughout the entire codespace lifecycle.
versions:
fpt: '*'
ghec: '*'
-type: overview
redirect_from:
- /codespaces/developing-in-codespaces/codespaces-lifecycle
- /codespaces/developing-in-codespaces/the-codespace-lifecycle
- /codespaces/about-codespaces/the-codespace-lifecycle
- /codespaces/getting-started/understanding-the-codespace-lifecycle
+contentType: concepts
---
> [!NOTE]
diff --git a/content/codespaces/about-codespaces/what-are-codespaces.md b/content/codespaces/about-codespaces/what-are-codespaces.md
index 6180f1308319..900a9f3f9e94 100644
--- a/content/codespaces/about-codespaces/what-are-codespaces.md
+++ b/content/codespaces/about-codespaces/what-are-codespaces.md
@@ -1,14 +1,14 @@
---
-title: 'What are {% data variables.product.prodname_github_codespaces %}?'
-shortTitle: 'What are {% data variables.product.prodname_codespaces %}?'
-intro: 'Learn about what {% data variables.product.prodname_github_codespaces %} are.'
+title: What are {% data variables.product.prodname_github_codespaces %}?
+shortTitle: What are {% data variables.product.prodname_codespaces %}?
+intro: Learn about what {% data variables.product.prodname_github_codespaces %} are.
allowTitleToDifferFromFilename: true
versions:
fpt: '*'
ghec: '*'
-type: overview
redirect_from:
- /codespaces/overview
+contentType: concepts
---
## Introduction
diff --git a/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md b/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md
index 20ac2b2c242d..00a5ce137ebc 100644
--- a/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md
+++ b/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md
@@ -1,13 +1,13 @@
---
title: Changing the machine type for your codespace
shortTitle: Change the machine type
-intro: 'You can change the type of machine that''s running your codespace, so that you''re using resources appropriate for the work you''re doing.'
+intro: You can change the type of machine that's running your codespace, so that you're using resources appropriate for the work you're doing.
versions:
fpt: '*'
ghec: '*'
redirect_from:
- /codespaces/developing-in-codespaces/changing-the-machine-type-for-your-codespace
-type: how_to
+contentType: how-tos
---
## About machine types
diff --git a/content/codespaces/customizing-your-codespace/changing-the-shell-in-a-codespace.md b/content/codespaces/customizing-your-codespace/changing-the-shell-in-a-codespace.md
index ca939dc451c7..95af563298a2 100644
--- a/content/codespaces/customizing-your-codespace/changing-the-shell-in-a-codespace.md
+++ b/content/codespaces/customizing-your-codespace/changing-the-shell-in-a-codespace.md
@@ -5,7 +5,7 @@ intro: You can change your shell in a codespace to keep the setup you're used to
versions:
fpt: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
When you're working in a codespace, you can open a new terminal window with a shell of your choice, change your default shell for new terminal windows, or install a new shell. You can also use dotfiles to configure your shell.
diff --git a/content/codespaces/customizing-your-codespace/renaming-a-codespace.md b/content/codespaces/customizing-your-codespace/renaming-a-codespace.md
index 225babfd1e5b..5812dcf62bb8 100644
--- a/content/codespaces/customizing-your-codespace/renaming-a-codespace.md
+++ b/content/codespaces/customizing-your-codespace/renaming-a-codespace.md
@@ -1,11 +1,11 @@
---
title: Renaming a codespace
-intro: 'You can change the codespace display name to one of your choice on {% data variables.product.github %} or using the {% data variables.product.prodname_cli %}.'
+intro: You can change the codespace display name to one of your choice on {% data variables.product.github %} or using the {% data variables.product.prodname_cli %}.
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Rename a codespace
+contentType: how-tos
---
## About renaming a codespace
diff --git a/content/codespaces/developing-in-a-codespace/connecting-to-a-private-network.md b/content/codespaces/developing-in-a-codespace/connecting-to-a-private-network.md
index aa15ab3f61ea..e294c14f7c25 100644
--- a/content/codespaces/developing-in-a-codespace/connecting-to-a-private-network.md
+++ b/content/codespaces/developing-in-a-codespace/connecting-to-a-private-network.md
@@ -1,12 +1,12 @@
---
title: Connecting to a private network
-intro: 'You can connect {% data variables.product.prodname_github_codespaces %} to resources on a private network, including package registries, license servers, and on-premises databases.'
+intro: You can connect {% data variables.product.prodname_github_codespaces %} to resources on a private network, including package registries, license servers, and on-premises databases.
versions:
fpt: '*'
ghec: '*'
-type: how_to
redirect_from:
- /codespaces/developing-in-codespaces/connecting-to-a-private-network
+contentType: how-tos
---
## About codespace networking
diff --git a/content/codespaces/developing-in-a-codespace/creating-a-codespace-for-a-repository.md b/content/codespaces/developing-in-a-codespace/creating-a-codespace-for-a-repository.md
index 8c68c5d3d1d1..df04c9d53a4f 100644
--- a/content/codespaces/developing-in-a-codespace/creating-a-codespace-for-a-repository.md
+++ b/content/codespaces/developing-in-a-codespace/creating-a-codespace-for-a-repository.md
@@ -9,8 +9,8 @@ redirect_from:
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Create a codespace for a repo
+contentType: how-tos
---
## About creating a codespace for a repository
diff --git a/content/codespaces/developing-in-a-codespace/creating-a-codespace-from-a-template.md b/content/codespaces/developing-in-a-codespace/creating-a-codespace-from-a-template.md
index 7f7b88d844f1..e5856836ecdc 100644
--- a/content/codespaces/developing-in-a-codespace/creating-a-codespace-from-a-template.md
+++ b/content/codespaces/developing-in-a-codespace/creating-a-codespace-from-a-template.md
@@ -1,13 +1,13 @@
---
title: Creating a codespace from a template
-intro: 'If you''re starting a new project, you can create a codespace from a blank template or choose a template specially designed for the type of work you want to do.'
+intro: If you're starting a new project, you can create a codespace from a blank template or choose a template specially designed for the type of work you want to do.
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Create a codespace from a template
redirect_from:
- /codespaces/developing-in-codespaces/creating-a-codespace-from-a-template
+contentType: how-tos
---
# About templates for {% data variables.product.prodname_github_codespaces %}
diff --git a/content/codespaces/developing-in-a-codespace/default-environment-variables-for-your-codespace.md b/content/codespaces/developing-in-a-codespace/default-environment-variables-for-your-codespace.md
index 814224e84a7b..327bf4c1ae8c 100644
--- a/content/codespaces/developing-in-a-codespace/default-environment-variables-for-your-codespace.md
+++ b/content/codespaces/developing-in-a-codespace/default-environment-variables-for-your-codespace.md
@@ -5,9 +5,9 @@ intro: '{% data variables.product.prodname_dotcom %} sets default environment va
versions:
fpt: '*'
ghec: '*'
-type: overview
redirect_from:
- /codespaces/developing-in-codespaces/default-environment-variables-for-your-codespace
+contentType: concepts
---
## About default environment variables
diff --git a/content/codespaces/developing-in-a-codespace/deleting-a-codespace.md b/content/codespaces/developing-in-a-codespace/deleting-a-codespace.md
index 221b91fdcce9..a5de19f56594 100644
--- a/content/codespaces/developing-in-a-codespace/deleting-a-codespace.md
+++ b/content/codespaces/developing-in-a-codespace/deleting-a-codespace.md
@@ -8,8 +8,8 @@ redirect_from:
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Delete a codespace
+contentType: how-tos
---
## Overview
diff --git a/content/codespaces/developing-in-a-codespace/developing-in-a-codespace.md b/content/codespaces/developing-in-a-codespace/developing-in-a-codespace.md
index ef11c189922b..24a85148689f 100644
--- a/content/codespaces/developing-in-a-codespace/developing-in-a-codespace.md
+++ b/content/codespaces/developing-in-a-codespace/developing-in-a-codespace.md
@@ -1,6 +1,6 @@
---
title: Developing in a codespace
-intro: 'You can work in a codespace using your browser, {% data variables.product.prodname_vscode %}, or in a command shell.'
+intro: You can work in a codespace using your browser, {% data variables.product.prodname_vscode %}, or in a command shell.
redirect_from:
- /github/developing-online-with-github-codespaces/developing-in-a-codespace
- /github/developing-online-with-codespaces/developing-in-a-codespace
@@ -8,8 +8,8 @@ redirect_from:
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Develop in a codespace
+contentType: how-tos
---
## About development with {% data variables.product.prodname_github_codespaces %}
diff --git a/content/codespaces/developing-in-a-codespace/forwarding-ports-in-your-codespace.md b/content/codespaces/developing-in-a-codespace/forwarding-ports-in-your-codespace.md
index 046e83342645..c011845c402a 100644
--- a/content/codespaces/developing-in-a-codespace/forwarding-ports-in-your-codespace.md
+++ b/content/codespaces/developing-in-a-codespace/forwarding-ports-in-your-codespace.md
@@ -8,7 +8,7 @@ versions:
redirect_from:
- /github/developing-online-with-codespaces/forwarding-ports-in-your-codespace
- /codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace
-type: how_to
+contentType: how-tos
---
## About forwarded ports
diff --git a/content/codespaces/developing-in-a-codespace/getting-started-with-github-codespaces-for-machine-learning.md b/content/codespaces/developing-in-a-codespace/getting-started-with-github-codespaces-for-machine-learning.md
index 939e90f29ed1..6fd4ef153dc9 100644
--- a/content/codespaces/developing-in-a-codespace/getting-started-with-github-codespaces-for-machine-learning.md
+++ b/content/codespaces/developing-in-a-codespace/getting-started-with-github-codespaces-for-machine-learning.md
@@ -1,13 +1,13 @@
---
title: Getting started with GitHub Codespaces for machine learning
shortTitle: Machine learning
-intro: 'Learn about working on machine learning projects with {% data variables.product.prodname_github_codespaces %} and its out-of-the-box tools.'
+intro: Learn about working on machine learning projects with {% data variables.product.prodname_github_codespaces %} and its out-of-the-box tools.
versions:
fpt: '*'
ghec: '*'
-type: tutorial
redirect_from:
- /codespaces/developing-in-codespaces/getting-started-with-github-codespaces-for-machine-learning
+contentType: tutorials
---
## Introduction
diff --git a/content/codespaces/developing-in-a-codespace/opening-an-existing-codespace.md b/content/codespaces/developing-in-a-codespace/opening-an-existing-codespace.md
index 4e1f1ff735b5..acf6006c5bc7 100644
--- a/content/codespaces/developing-in-a-codespace/opening-an-existing-codespace.md
+++ b/content/codespaces/developing-in-a-codespace/opening-an-existing-codespace.md
@@ -4,10 +4,10 @@ intro: You can reopen a codespace that you have closed or stopped and return to
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Open an existing codespace
redirect_from:
- /codespaces/developing-in-codespaces/opening-an-existing-codespace
+contentType: how-tos
---
You can reopen any of your active or stopped codespaces on {% data variables.product.github %}, in {% data variables.product.prodname_vscode %}, or by using {% data variables.product.prodname_cli %}. You can't reopen a codespace that has been deleted. See [AUTOTITLE](/codespaces/about-codespaces/understanding-the-codespace-lifecycle).
diff --git a/content/codespaces/developing-in-a-codespace/persisting-environment-variables-and-temporary-files.md b/content/codespaces/developing-in-a-codespace/persisting-environment-variables-and-temporary-files.md
index bf6ffd48c3cb..fbb924b188a1 100644
--- a/content/codespaces/developing-in-a-codespace/persisting-environment-variables-and-temporary-files.md
+++ b/content/codespaces/developing-in-a-codespace/persisting-environment-variables-and-temporary-files.md
@@ -4,10 +4,10 @@ intro: You can configure custom environment variables so that they are set to th
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Persist variables and files
redirect_from:
- /codespaces/developing-in-codespaces/persisting-environment-variables-and-temporary-files
+contentType: how-tos
---
## Setting persistent environment variables
diff --git a/content/codespaces/developing-in-a-codespace/rebuilding-the-container-in-a-codespace.md b/content/codespaces/developing-in-a-codespace/rebuilding-the-container-in-a-codespace.md
index 809d04095047..b599f89bec09 100644
--- a/content/codespaces/developing-in-a-codespace/rebuilding-the-container-in-a-codespace.md
+++ b/content/codespaces/developing-in-a-codespace/rebuilding-the-container-in-a-codespace.md
@@ -1,14 +1,14 @@
---
title: Rebuilding the container in a codespace
-intro: 'You can rebuild the dev container of a codespace you are working in to apply configuration changes. From time to time, you may want to perform a full rebuild.'
+intro: You can rebuild the dev container of a codespace you are working in to apply configuration changes. From time to time, you may want to perform a full rebuild.
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Rebuilding a container
redirect_from:
- /codespaces/codespaces-reference/performing-a-full-rebuild-of-a-container
- /codespaces/developing-in-codespaces/rebuilding-the-container-in-a-codespace
+contentType: how-tos
---
## About rebuilding the dev container
diff --git a/content/codespaces/developing-in-a-codespace/stopping-and-starting-a-codespace.md b/content/codespaces/developing-in-a-codespace/stopping-and-starting-a-codespace.md
index 3da4059c5ad4..96a8fbc59564 100644
--- a/content/codespaces/developing-in-a-codespace/stopping-and-starting-a-codespace.md
+++ b/content/codespaces/developing-in-a-codespace/stopping-and-starting-a-codespace.md
@@ -4,10 +4,10 @@ intro: You can stop and start your codespace to save resources and to pause work
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Stop a codespace
redirect_from:
- /codespaces/developing-in-codespaces/stopping-and-starting-a-codespace
+contentType: how-tos
---
## About stopping and starting a codespace
diff --git a/content/codespaces/developing-in-a-codespace/using-github-codespaces-for-pull-requests.md b/content/codespaces/developing-in-a-codespace/using-github-codespaces-for-pull-requests.md
index c25d0d7423ac..e5fcbaf42edd 100644
--- a/content/codespaces/developing-in-a-codespace/using-github-codespaces-for-pull-requests.md
+++ b/content/codespaces/developing-in-a-codespace/using-github-codespaces-for-pull-requests.md
@@ -1,14 +1,14 @@
---
title: Using GitHub Codespaces for pull requests
shortTitle: Pull requests
-intro: 'You can use {% data variables.product.prodname_github_codespaces %} in your web browser, or in {% data variables.product.prodname_vscode %} to create pull requests, review pull requests, and address review comments.'
+intro: You can use {% data variables.product.prodname_github_codespaces %} in your web browser, or in {% data variables.product.prodname_vscode %} to create pull requests, review pull requests, and address review comments.
versions:
fpt: '*'
ghec: '*'
-type: how_to
redirect_from:
- /codespaces/developing-in-codespaces/using-codespaces-for-pull-requests
- /codespaces/developing-in-codespaces/using-github-codespaces-for-pull-requests
+contentType: how-tos
---
Using a codespace to work on a pull request gives you all the benefits of {% data variables.product.prodname_github_codespaces %}. For more information, see [AUTOTITLE](/codespaces/about-codespaces/codespaces-features).
diff --git a/content/codespaces/developing-in-a-codespace/using-github-codespaces-in-visual-studio-code.md b/content/codespaces/developing-in-a-codespace/using-github-codespaces-in-visual-studio-code.md
index 81ee3ad26314..180233a3bf87 100644
--- a/content/codespaces/developing-in-a-codespace/using-github-codespaces-in-visual-studio-code.md
+++ b/content/codespaces/developing-in-a-codespace/using-github-codespaces-in-visual-studio-code.md
@@ -1,7 +1,7 @@
---
title: Using GitHub Codespaces in Visual Studio Code
shortTitle: Visual Studio Code
-intro: 'You can develop in your codespace directly in {% data variables.product.prodname_vscode %} by connecting the {% data variables.product.prodname_github_codespaces %} extension with your {% data variables.product.github %} account.'
+intro: You can develop in your codespace directly in {% data variables.product.prodname_vscode %} by connecting the {% data variables.product.prodname_github_codespaces %} extension with your {% data variables.product.github %} account.
redirect_from:
- /github/developing-online-with-codespaces/using-codespaces-in-visual-studio-code
- /github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code
@@ -11,7 +11,7 @@ redirect_from:
versions:
fpt: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## About {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode %}
diff --git a/content/codespaces/developing-in-a-codespace/using-github-codespaces-with-github-cli.md b/content/codespaces/developing-in-a-codespace/using-github-codespaces-with-github-cli.md
index 06aa93cad12f..7225d72e6f0c 100644
--- a/content/codespaces/developing-in-a-codespace/using-github-codespaces-with-github-cli.md
+++ b/content/codespaces/developing-in-a-codespace/using-github-codespaces-with-github-cli.md
@@ -1,14 +1,14 @@
---
title: Using GitHub Codespaces with GitHub CLI
shortTitle: GitHub CLI
-intro: 'You can work with {% data variables.product.prodname_github_codespaces %} directly from your command line by using `gh`, the {% data variables.product.github %} command line interface.'
+intro: You can work with {% data variables.product.prodname_github_codespaces %} directly from your command line by using `gh`, the {% data variables.product.github %} command line interface.
versions:
fpt: '*'
ghec: '*'
-type: how_to
redirect_from:
- /codespaces/developing-in-codespaces/using-codespaces-with-github-cli
- /codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli
+contentType: how-tos
---
## About {% data variables.product.prodname_cli %}
diff --git a/content/codespaces/developing-in-a-codespace/using-source-control-in-your-codespace.md b/content/codespaces/developing-in-a-codespace/using-source-control-in-your-codespace.md
index 331a80aafde9..a8b973b1a814 100644
--- a/content/codespaces/developing-in-a-codespace/using-source-control-in-your-codespace.md
+++ b/content/codespaces/developing-in-a-codespace/using-source-control-in-your-codespace.md
@@ -4,10 +4,10 @@ intro: After making changes to a file in your codespace you can quickly commit t
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Source control
redirect_from:
- /codespaces/developing-in-codespaces/using-source-control-in-your-codespace
+contentType: how-tos
---
## About source control in {% data variables.product.prodname_github_codespaces %}
diff --git a/content/codespaces/developing-in-a-codespace/working-collaboratively-in-a-codespace.md b/content/codespaces/developing-in-a-codespace/working-collaboratively-in-a-codespace.md
index a0d348abac5b..ea9755d6ef89 100644
--- a/content/codespaces/developing-in-a-codespace/working-collaboratively-in-a-codespace.md
+++ b/content/codespaces/developing-in-a-codespace/working-collaboratively-in-a-codespace.md
@@ -1,13 +1,13 @@
---
title: Working collaboratively in a codespace
shortTitle: Work collaboratively
-intro: 'You can work collaboratively with other people in a codespace by using {% data variables.product.prodname_vs %} Live Share.'
+intro: You can work collaboratively with other people in a codespace by using {% data variables.product.prodname_vs %} Live Share.
versions:
fpt: '*'
ghec: '*'
-type: how_to
redirect_from:
- /codespaces/developing-in-codespaces/working-collaboratively-in-a-codespace
+contentType: how-tos
---
{% data variables.product.prodname_vs %} Live Share lets you collaboratively edit and debug with others in real time, within a codespace. You can securely share your current codespace, or access a codespace created by someone else.
diff --git a/content/codespaces/managing-codespaces-for-your-organization/choosing-who-owns-and-pays-for-codespaces-in-your-organization.md b/content/codespaces/managing-codespaces-for-your-organization/choosing-who-owns-and-pays-for-codespaces-in-your-organization.md
index cd1154722ec2..7c315c7e35e3 100644
--- a/content/codespaces/managing-codespaces-for-your-organization/choosing-who-owns-and-pays-for-codespaces-in-your-organization.md
+++ b/content/codespaces/managing-codespaces-for-your-organization/choosing-who-owns-and-pays-for-codespaces-in-your-organization.md
@@ -1,13 +1,13 @@
---
title: Choosing who owns and pays for codespaces in your organization
-shortTitle: 'Billing and ownership'
-intro: 'You can choose whether codespaces are paid for and owned by your organization or by your members.'
-permissions: "Organization owners can change an organization's billing details and control who owns and pays for codespaces."
+shortTitle: Billing and ownership
+intro: You can choose whether codespaces are paid for and owned by your organization or by your members.
+permissions: Organization owners can change an organization's billing details and control who owns and pays for codespaces.
versions:
fpt: '*'
ghec: '*'
-type: how_to
-product: 'Organizations on {% data variables.product.prodname_team %} and {% data variables.product.prodname_enterprise %} plans can pay for their members'' use of {% data variables.product.prodname_github_codespaces %}. These organizations can then access policies that apply to codespaces paid for by the organization. See [AUTOTITLE](/get-started/learning-about-github/githubs-products).'
+product: Organizations on {% data variables.product.prodname_team %} and {% data variables.product.prodname_enterprise %} plans can pay for their members' use of {% data variables.product.prodname_github_codespaces %}. These organizations can then access policies that apply to codespaces paid for by the organization. See [AUTOTITLE](/get-started/learning-about-github/githubs-products).
+contentType: how-tos
---
## Overview
diff --git a/content/codespaces/managing-codespaces-for-your-organization/enabling-or-disabling-github-codespaces-for-your-organization.md b/content/codespaces/managing-codespaces-for-your-organization/enabling-or-disabling-github-codespaces-for-your-organization.md
index abc5bf425d8e..e383c9fc4a6a 100644
--- a/content/codespaces/managing-codespaces-for-your-organization/enabling-or-disabling-github-codespaces-for-your-organization.md
+++ b/content/codespaces/managing-codespaces-for-your-organization/enabling-or-disabling-github-codespaces-for-your-organization.md
@@ -1,8 +1,8 @@
---
title: Enabling or disabling GitHub Codespaces for your organization
-shortTitle: 'Enable or disable Codespaces'
-intro: 'You can control which users can use {% data variables.product.prodname_github_codespaces %} in your organization''s private {% ifversion ghec %}and internal {% endif %}repositories.'
-permissions: 'Organization owners'
+shortTitle: Enable or disable Codespaces
+intro: You can control which users can use {% data variables.product.prodname_github_codespaces %} in your organization's private {% ifversion ghec %}and internal {% endif %}repositories.
+permissions: Organization owners
redirect_from:
- /codespaces/managing-codespaces-for-your-organization/managing-user-permissions-for-your-organization
- /codespaces/managing-codespaces-for-your-organization/enabling-codespaces-for-your-organization
@@ -10,8 +10,8 @@ redirect_from:
versions:
fpt: '*'
ghec: '*'
-type: how_to
product: '{% data variables.product.prodname_team %} and {% data variables.product.prodname_enterprise %}'
+contentType: how-tos
---
## About enabling and disabling {% data variables.product.prodname_github_codespaces %}
diff --git a/content/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization.md b/content/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization.md
index 18f3aeb8f820..9315ddfa8697 100644
--- a/content/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization.md
+++ b/content/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization.md
@@ -2,12 +2,12 @@
title: Listing the codespaces in your organization
shortTitle: List organization codespaces
intro: You can list all of the currently active or stopped codespaces for your organization.
-permissions: 'To list all of the current codespaces for your organization, you must be an organization owner.'
+permissions: To list all of the current codespaces for your organization, you must be an organization owner.
versions:
fpt: '*'
ghec: '*'
-type: how_to
product: '{% data reusables.gated-features.codespaces-org %}'
+contentType: how-tos
---
## Overview
diff --git a/content/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization.md b/content/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization.md
index 21c3078ce03e..86d61be08f3e 100644
--- a/content/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization.md
+++ b/content/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization.md
@@ -1,16 +1,16 @@
---
title: Managing the cost of GitHub Codespaces in your organization
shortTitle: Manage Codespaces costs
-intro: 'You can check your {% data variables.product.prodname_github_codespaces %} usage and set usage limits.'
-permissions: 'To manage billing for {% data variables.product.prodname_github_codespaces %} for an organization, you must be an organization owner or a billing manager.'
+intro: You can check your {% data variables.product.prodname_github_codespaces %} usage and set usage limits.
+permissions: To manage billing for {% data variables.product.prodname_github_codespaces %} for an organization, you must be an organization owner or a billing manager.
versions:
fpt: '*'
ghec: '*'
-type: reference
redirect_from:
- /codespaces/managing-codespaces-for-your-organization/managing-billing-for-codespaces-in-your-organization
- /codespaces/managing-codespaces-for-your-organization/managing-billing-for-github-codespaces-in-your-organization
product: '{% data reusables.gated-features.codespaces-org %}'
+contentType: reference
---
## Overview
diff --git a/content/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types.md b/content/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types.md
index f1090789f2bd..b47c3077a562 100644
--- a/content/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types.md
+++ b/content/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types.md
@@ -2,12 +2,12 @@
title: Restricting access to machine types
shortTitle: Restrict machine types
intro: You can set constraints on the types of machines users can choose when they create codespaces in your organization.
-permissions: 'To manage access to machine types for the repositories in an organization, you must be an owner of the organization.'
+permissions: To manage access to machine types for the repositories in an organization, you must be an owner of the organization.
versions:
fpt: '*'
ghec: '*'
-type: how_to
product: '{% data reusables.gated-features.codespaces-org %}'
+contentType: how-tos
---
## Overview
diff --git a/content/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces.md b/content/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces.md
index 1d3138d0b841..643cf1883a40 100644
--- a/content/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces.md
+++ b/content/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces.md
@@ -2,12 +2,12 @@
title: Restricting the base image for codespaces
shortTitle: Restrict base image
intro: You can specify which base images can be used to create the dev container for new codespaces created within your organization.
-permissions: 'To manage image constraints for an organization''s codespaces, you must be an owner of the organization.'
+permissions: To manage image constraints for an organization's codespaces, you must be an owner of the organization.
versions:
fpt: '*'
ghec: '*'
-type: how_to
product: '{% data reusables.gated-features.codespaces-org %}'
+contentType: how-tos
---
## Overview
diff --git a/content/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period.md b/content/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period.md
index 3e413dcca67c..2e2dd2a7feba 100644
--- a/content/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period.md
+++ b/content/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period.md
@@ -2,12 +2,12 @@
title: Restricting the idle timeout period
shortTitle: Restrict timeout periods
intro: You can set a maximum timeout period for any codespaces owned by your organization.
-permissions: 'To manage timeout constraints for an organization''s codespaces, you must be an owner of the organization.'
+permissions: To manage timeout constraints for an organization's codespaces, you must be an owner of the organization.
versions:
fpt: '*'
ghec: '*'
-type: how_to
product: '{% data reusables.gated-features.codespaces-org %}'
+contentType: how-tos
---
## Overview
diff --git a/content/codespaces/managing-codespaces-for-your-organization/restricting-the-number-of-organization-billed-codespaces-a-user-can-create.md b/content/codespaces/managing-codespaces-for-your-organization/restricting-the-number-of-organization-billed-codespaces-a-user-can-create.md
index 76951f4e651f..a10cdfc8c9f0 100644
--- a/content/codespaces/managing-codespaces-for-your-organization/restricting-the-number-of-organization-billed-codespaces-a-user-can-create.md
+++ b/content/codespaces/managing-codespaces-for-your-organization/restricting-the-number-of-organization-billed-codespaces-a-user-can-create.md
@@ -1,13 +1,13 @@
---
title: Restricting the number of organization-billed codespaces a user can create
shortTitle: Restrict codespace creation
-intro: 'You can specify the maximum number of codespaces that any member of your organization, or collaborator, can create for the repositories in your organization.'
-permissions: 'To manage this constraint for an organization, you must be an owner of the organization.'
+intro: You can specify the maximum number of codespaces that any member of your organization, or collaborator, can create for the repositories in your organization.
+permissions: To manage this constraint for an organization, you must be an owner of the organization.
versions:
fpt: '*'
ghec: '*'
-type: how_to
product: '{% data reusables.gated-features.codespaces-org %}'
+contentType: how-tos
---
## Overview
diff --git a/content/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces.md b/content/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces.md
index 7978124af13a..4b8ea67552a5 100644
--- a/content/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces.md
+++ b/content/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces.md
@@ -2,12 +2,12 @@
title: Restricting the retention period for codespaces
shortTitle: Restrict the retention period
intro: You can set a maximum retention period for any codespaces owned by your organization.
-permissions: 'To manage retention constraints for an organization''s codespaces, you must be an owner of the organization.'
+permissions: To manage retention constraints for an organization's codespaces, you must be an owner of the organization.
versions:
fpt: '*'
ghec: '*'
-type: how_to
product: '{% data reusables.gated-features.codespaces-org %}'
+contentType: how-tos
---
## Overview
diff --git a/content/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports.md b/content/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports.md
index 88c33918e7da..e4b5bfd1b37b 100644
--- a/content/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports.md
+++ b/content/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports.md
@@ -2,12 +2,12 @@
title: Restricting the visibility of forwarded ports
shortTitle: Restrict port visibility
intro: You can set constraints on the visibility options users can choose when they forward ports from codespaces in your organization.
-permissions: 'To manage access to port visibility constraints for the repositories in an organization, you must be an owner of the organization.'
+permissions: To manage access to port visibility constraints for the repositories in an organization, you must be an owner of the organization.
versions:
fpt: '*'
ghec: '*'
-type: how_to
product: '{% data reusables.gated-features.codespaces-org %}'
+contentType: how-tos
---
## Overview
diff --git a/content/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces.md b/content/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces.md
index f6346cd8cc2e..67030e500528 100644
--- a/content/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces.md
+++ b/content/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces.md
@@ -1,14 +1,14 @@
---
title: Reviewing your organization's audit logs for GitHub Codespaces
shortTitle: Audit logs
-intro: 'You can use the audit log to review all actions related to {% data variables.product.prodname_github_codespaces %}.'
+intro: You can use the audit log to review all actions related to {% data variables.product.prodname_github_codespaces %}.
versions:
fpt: '*'
ghec: '*'
-type: how_to
redirect_from:
- /codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-codespaces
product: '{% data reusables.gated-features.codespaces-org %}'
+contentType: how-tos
---
When any member of your organization performs an action related to {% data variables.product.prodname_github_codespaces %}, you can review the actions in the audit log. For information about accessing the log, see [AUTOTITLE](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization#accessing-the-audit-log).
diff --git a/content/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces.md b/content/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces.md
index f5a23509eeaf..eccf83c81174 100644
--- a/content/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces.md
+++ b/content/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces.md
@@ -1,15 +1,15 @@
---
title: Managing GPG verification for GitHub Codespaces
-intro: 'You can allow {% data variables.product.company_short %} to automatically use GPG to sign commits you make in your codespaces, so other people can be confident that the changes come from a trusted source.'
+intro: You can allow {% data variables.product.company_short %} to automatically use GPG to sign commits you make in your codespaces, so other people can be confident that the changes come from a trusted source.
versions:
fpt: '*'
ghec: '*'
-type: how_to
redirect_from:
- /github/developing-online-with-codespaces/managing-gpg-verification-for-codespaces
- /codespaces/working-with-your-codespace/managing-gpg-verification-for-codespaces
- /codespaces/managing-your-codespaces/managing-gpg-verification-for-codespaces
shortTitle: GPG verification
+contentType: how-tos
---
## About GPG verification in {% data variables.product.prodname_github_codespaces %}
diff --git a/content/codespaces/managing-your-codespaces/managing-your-account-specific-secrets-for-github-codespaces.md b/content/codespaces/managing-your-codespaces/managing-your-account-specific-secrets-for-github-codespaces.md
index a29feec5102d..656df7fb7065 100644
--- a/content/codespaces/managing-your-codespaces/managing-your-account-specific-secrets-for-github-codespaces.md
+++ b/content/codespaces/managing-your-codespaces/managing-your-account-specific-secrets-for-github-codespaces.md
@@ -1,7 +1,7 @@
---
title: Managing your account-specific secrets for GitHub Codespaces
shortTitle: Codespaces secrets
-intro: 'You can store sensitive information, like tokens, that you want to access in your codespaces via environment variables.'
+intro: You can store sensitive information, like tokens, that you want to access in your codespaces via environment variables.
versions:
fpt: '*'
ghec: '*'
@@ -10,7 +10,7 @@ redirect_from:
- /github/developing-online-with-codespaces/managing-encrypted-secrets-for-codespaces
- /codespaces/working-with-your-codespace/managing-encrypted-secrets-for-codespaces
- /codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces
-type: how_to
+contentType: how-tos
---
## About secrets for {% data variables.product.prodname_github_codespaces %}
diff --git a/content/codespaces/prebuilding-your-codespaces/allowing-a-prebuild-to-access-other-repositories.md b/content/codespaces/prebuilding-your-codespaces/allowing-a-prebuild-to-access-other-repositories.md
index 60a68b50f256..8895ec55dc1a 100644
--- a/content/codespaces/prebuilding-your-codespaces/allowing-a-prebuild-to-access-other-repositories.md
+++ b/content/codespaces/prebuilding-your-codespaces/allowing-a-prebuild-to-access-other-repositories.md
@@ -1,13 +1,13 @@
---
title: Allowing a prebuild to access other repositories
shortTitle: Allow external repo access
-intro: 'You can permit your prebuild to access other {% data variables.product.prodname_dotcom %} repositories so that it can be built successfully.'
+intro: You can permit your prebuild to access other {% data variables.product.prodname_dotcom %} repositories so that it can be built successfully.
versions:
fpt: '*'
ghec: '*'
-type: how_to
permissions: People with admin access to a repository can configure prebuilds for the repository.
product: '{% data reusables.gated-features.codespaces-repo %}'
+contentType: how-tos
---
By default, the {% data variables.product.prodname_actions %} workflow for a prebuild configuration can only access its own repository contents. Your project may use additional resources, located elsewhere, to build the development environment.
diff --git a/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md b/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md
index c30a2305fc5e..226ea852962a 100644
--- a/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md
+++ b/content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md
@@ -5,9 +5,9 @@ intro: You can configure your project to prebuild a codespace automatically each
versions:
fpt: '*'
ghec: '*'
-type: how_to
permissions: People with admin access to a repository can configure prebuilds for the repository.
product: '{% data reusables.gated-features.codespaces-repo %}'
+contentType: how-tos
---
You can set up a prebuild configuration for the combination of a specific branch of your repository with a specific dev container configuration file.
diff --git a/content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md b/content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md
index 71f087ba548b..60db732b3311 100644
--- a/content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md
+++ b/content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md
@@ -1,12 +1,12 @@
---
title: Managing prebuilds
shortTitle: Manage prebuilds
-intro: 'You can review, modify, and delete the prebuild configurations for your repository.'
+intro: You can review, modify, and delete the prebuild configurations for your repository.
versions:
fpt: '*'
ghec: '*'
-type: how_to
product: '{% data reusables.gated-features.codespaces-repo %}'
+contentType: how-tos
---
## About managing prebuilds
diff --git a/content/codespaces/prebuilding-your-codespaces/testing-dev-container-changes.md b/content/codespaces/prebuilding-your-codespaces/testing-dev-container-changes.md
index a6203afd84fd..293ff2194a58 100644
--- a/content/codespaces/prebuilding-your-codespaces/testing-dev-container-changes.md
+++ b/content/codespaces/prebuilding-your-codespaces/testing-dev-container-changes.md
@@ -2,12 +2,12 @@
title: Testing dev container configuration changes on a prebuild-enabled branch
shortTitle: Test dev container changes
allowTitleToDifferFromFilename: true
-intro: 'When you change the dev container configuration for a branch that''s enabled for prebuilds, you should test your changes in a codespace.'
+intro: When you change the dev container configuration for a branch that's enabled for prebuilds, you should test your changes in a codespace.
versions:
fpt: '*'
ghec: '*'
-type: how_to
permissions: People with write permissions to a repository can create or edit the dev container configuration for a branch.
+contentType: how-tos
---
Any changes you make to the dev container configuration for a prebuild-enabled branch will result in an update to the codespace configuration and the associated prebuild. It’s therefore important to test such changes in a codespace from a test branch before committing your changes to a branch of your repository that's actively used. This will ensure you’re not introducing breaking changes for your team.
diff --git a/content/codespaces/reference/security-in-github-codespaces.md b/content/codespaces/reference/security-in-github-codespaces.md
index b0ad0ac4fd17..8a6721adc40e 100644
--- a/content/codespaces/reference/security-in-github-codespaces.md
+++ b/content/codespaces/reference/security-in-github-codespaces.md
@@ -1,14 +1,14 @@
---
title: Security in GitHub Codespaces
-intro: 'Overview of the {% data variables.product.prodname_github_codespaces %} security architecture, with guidelines to help you maintain security and minimize the risk of attack.'
+intro: Overview of the {% data variables.product.prodname_github_codespaces %} security architecture, with guidelines to help you maintain security and minimize the risk of attack.
versions:
fpt: '*'
ghec: '*'
-type: reference
shortTitle: Security in Codespaces
redirect_from:
- /codespaces/codespaces-reference/security-in-codespaces
- /codespaces/codespaces-reference/security-in-github-codespaces
+contentType: reference
---
## Overview of codespace security
diff --git a/content/codespaces/reference/using-github-copilot-in-github-codespaces.md b/content/codespaces/reference/using-github-copilot-in-github-codespaces.md
index 7940c740dbc6..1986f3ac58bf 100644
--- a/content/codespaces/reference/using-github-copilot-in-github-codespaces.md
+++ b/content/codespaces/reference/using-github-copilot-in-github-codespaces.md
@@ -1,15 +1,15 @@
---
title: Using GitHub Copilot in GitHub Codespaces
-intro: 'You can use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_github_codespaces %} by adding a VS Code extension.'
+intro: You can use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_github_codespaces %} by adding a VS Code extension.
versions:
fpt: '*'
ghec: '*'
-type: reference
shortTitle: Copilot in Codespaces
redirect_from:
- /codespaces/codespaces-reference/using-copilot-in-codespaces
- /codespaces/codespaces-reference/using-github-copilot-in-codespaces
- /codespaces/codespaces-reference/using-github-copilot-in-github-codespaces
+contentType: reference
---
[{% data variables.product.prodname_copilot %}](https://copilot.github.com/) is an AI pair programmer that you can use in any codespace that you open in the {% data variables.product.prodname_vscode_shortname %} web client or desktop application. For more information about {% data variables.product.prodname_copilot %}, see [AUTOTITLE](/copilot/about-github-copilot/what-is-github-copilot).
diff --git a/content/codespaces/reference/using-the-vs-code-command-palette-in-codespaces.md b/content/codespaces/reference/using-the-vs-code-command-palette-in-codespaces.md
index 9a1e3d323b49..3f218bd146cc 100644
--- a/content/codespaces/reference/using-the-vs-code-command-palette-in-codespaces.md
+++ b/content/codespaces/reference/using-the-vs-code-command-palette-in-codespaces.md
@@ -1,15 +1,15 @@
---
title: Using the Visual Studio Code Command Palette in GitHub Codespaces
-intro: 'You can use the Command Palette feature of {% data variables.product.prodname_vscode %} to access many commands in {% data variables.product.prodname_github_codespaces %}.'
+intro: You can use the Command Palette feature of {% data variables.product.prodname_vscode %} to access many commands in {% data variables.product.prodname_github_codespaces %}.
versions:
fpt: '*'
ghec: '*'
-type: reference
shortTitle: VS Code Command Palette
allowTitleToDifferFromFilename: true
redirect_from:
- /codespaces/codespaces-reference/using-the-command-palette-in-codespaces
- /codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces
+contentType: reference
---
## About the {% data variables.product.prodname_vscode_command_palette %}
diff --git a/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers.md b/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers.md
index 6adc87c7c84e..945c38df18a4 100644
--- a/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers.md
+++ b/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers.md
@@ -1,6 +1,6 @@
---
title: Introduction to dev containers
-intro: 'When you work in a codespace, the environment you are working in is created using a development container, or dev container, hosted on a virtual machine.'
+intro: When you work in a codespace, the environment you are working in is created using a development container, or dev container, hosted on a virtual machine.
permissions: People with write permissions to a repository can create or edit the codespace configuration.
redirect_from:
- /github/developing-online-with-github-codespaces/configuring-github-codespaces-for-your-project
@@ -12,7 +12,7 @@ redirect_from:
versions:
fpt: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## About dev containers
diff --git a/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-dotnet-project-for-codespaces.md b/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-dotnet-project-for-codespaces.md
index 369f4fe29bb9..ecf2fe7f5c18 100644
--- a/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-dotnet-project-for-codespaces.md
+++ b/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-dotnet-project-for-codespaces.md
@@ -2,14 +2,14 @@
title: Setting up a C# (.NET) project for GitHub Codespaces
shortTitle: Setting up a C# (.NET) project
allowTitleToDifferFromFilename: true
-intro: 'Get started with a C# (.NET) project in {% data variables.product.prodname_github_codespaces %} by creating a custom dev container configuration.'
+intro: Get started with a C# (.NET) project in {% data variables.product.prodname_github_codespaces %} by creating a custom dev container configuration.
redirect_from:
- /codespaces/getting-started-with-codespaces/getting-started-with-your-dotnet-project
- /codespaces/setting-up-your-project-for-codespaces/setting-up-your-dotnet-project-for-codespaces
versions:
fpt: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
---
## Introduction
diff --git a/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-java-project-for-codespaces.md b/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-java-project-for-codespaces.md
index 12e0794d2a14..b195dffb695f 100644
--- a/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-java-project-for-codespaces.md
+++ b/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-java-project-for-codespaces.md
@@ -2,14 +2,14 @@
title: Setting up a Java project for GitHub Codespaces
allowTitleToDifferFromFilename: true
shortTitle: Setting up a Java project
-intro: 'Get started with a Java project in {% data variables.product.prodname_github_codespaces %} by creating a custom dev container configuration.'
+intro: Get started with a Java project in {% data variables.product.prodname_github_codespaces %} by creating a custom dev container configuration.
redirect_from:
- /codespaces/getting-started-with-codespaces/getting-started-with-your-java-project-in-codespaces
- /codespaces/setting-up-your-project-for-codespaces/setting-up-your-java-project-for-codespaces
versions:
fpt: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
---
## Introduction
diff --git a/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-nodejs-project-for-codespaces.md b/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-nodejs-project-for-codespaces.md
index 36724f3a86db..92b4c7fe3079 100644
--- a/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-nodejs-project-for-codespaces.md
+++ b/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-nodejs-project-for-codespaces.md
@@ -2,14 +2,14 @@
title: Setting up a Node.js project for GitHub Codespaces
allowTitleToDifferFromFilename: true
shortTitle: Setting up a Node.js project
-intro: 'Get started with a Node.js, JavaScript, or TypeScript project in {% data variables.product.prodname_github_codespaces %} by creating a custom dev container configuration.'
+intro: Get started with a Node.js, JavaScript, or TypeScript project in {% data variables.product.prodname_github_codespaces %} by creating a custom dev container configuration.
versions:
fpt: '*'
ghec: '*'
redirect_from:
- /codespaces/getting-started-with-codespaces/getting-started-with-your-nodejs-project-in-codespaces
- /codespaces/setting-up-your-project-for-codespaces/setting-up-your-nodejs-project-for-codespaces
-type: tutorial
+contentType: tutorials
---
## Introduction
diff --git a/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-php-project-for-codespaces.md b/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-php-project-for-codespaces.md
index 4f681ab271ac..ffaac73372db 100644
--- a/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-php-project-for-codespaces.md
+++ b/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-php-project-for-codespaces.md
@@ -2,14 +2,14 @@
title: Setting up a PHP project for GitHub Codespaces
allowTitleToDifferFromFilename: true
shortTitle: Setting up a PHP project
-intro: 'Get started with a PHP project in {% data variables.product.prodname_github_codespaces %} by creating a custom dev container configuration.'
+intro: Get started with a PHP project in {% data variables.product.prodname_github_codespaces %} by creating a custom dev container configuration.
versions:
fpt: '*'
ghec: '*'
redirect_from:
- /codespaces/getting-started-with-codespaces/getting-started-with-your-php-project-in-codespaces
- /codespaces/setting-up-your-project-for-codespaces/setting-up-your-php-project-for-codespaces
-type: tutorial
+contentType: tutorials
---
## Introduction
diff --git a/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-python-project-for-codespaces.md b/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-python-project-for-codespaces.md
index 63c634c5e738..12154df3a1e3 100644
--- a/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-python-project-for-codespaces.md
+++ b/content/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-python-project-for-codespaces.md
@@ -2,14 +2,14 @@
title: Setting up a Python project for GitHub Codespaces
allowTitleToDifferFromFilename: true
shortTitle: Setting up a Python project
-intro: 'Get started with a Python project in {% data variables.product.prodname_github_codespaces %} by creating a custom dev container configuration.'
+intro: Get started with a Python project in {% data variables.product.prodname_github_codespaces %} by creating a custom dev container configuration.
versions:
fpt: '*'
ghec: '*'
redirect_from:
- /codespaces/getting-started-with-codespaces/getting-started-with-your-python-project-in-codespaces
- /codespaces/setting-up-your-project-for-codespaces/setting-up-your-python-project-for-codespaces
-type: tutorial
+contentType: tutorials
---
## Introduction
diff --git a/content/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/adding-features-to-a-devcontainer-file.md b/content/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/adding-features-to-a-devcontainer-file.md
index b5b869aeccf0..a837c5b0e3dc 100644
--- a/content/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/adding-features-to-a-devcontainer-file.md
+++ b/content/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/adding-features-to-a-devcontainer-file.md
@@ -1,14 +1,14 @@
---
title: Adding features to a devcontainer.json file
shortTitle: Adding features
-intro: 'With features, you can quickly add tools, runtimes, or libraries to your dev container configuration.'
+intro: With features, you can quickly add tools, runtimes, or libraries to your dev container configuration.
allowTitleToDifferFromFilename: true
versions:
fpt: '*'
ghec: '*'
-type: how_to
redirect_from:
- /codespaces/setting-up-your-project-for-codespaces/adding-features-to-a-devcontainer-file
+contentType: how-tos
---
{% data reusables.codespaces.about-features %} Use the tabs in this article to display instructions for each of these ways of adding features.
diff --git a/content/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/automatically-opening-files-in-the-codespaces-for-a-repository.md b/content/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/automatically-opening-files-in-the-codespaces-for-a-repository.md
index 5db5ef6439da..d3c4017de646 100644
--- a/content/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/automatically-opening-files-in-the-codespaces-for-a-repository.md
+++ b/content/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/automatically-opening-files-in-the-codespaces-for-a-repository.md
@@ -1,14 +1,14 @@
---
title: Automatically opening files in the codespaces for a repository
shortTitle: Automatically opening files
-intro: 'You can set particular files to be opened automatically whenever someone creates a codespace for your repository and opens the codespace in the {% data variables.product.prodname_vscode %} web client.'
+intro: You can set particular files to be opened automatically whenever someone creates a codespace for your repository and opens the codespace in the {% data variables.product.prodname_vscode %} web client.
permissions: People with write permissions to a repository can create or edit the codespace configuration.
versions:
fpt: '*'
ghec: '*'
-type: how_to
redirect_from:
- /codespaces/setting-up-your-project-for-codespaces/automatically-opening-files-in-the-codespaces-for-a-repository
+contentType: how-tos
---
## Overview
diff --git a/content/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/setting-a-minimum-specification-for-codespace-machines.md b/content/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/setting-a-minimum-specification-for-codespace-machines.md
index 27a0c27c51be..67c767f618bc 100644
--- a/content/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/setting-a-minimum-specification-for-codespace-machines.md
+++ b/content/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/setting-a-minimum-specification-for-codespace-machines.md
@@ -1,14 +1,14 @@
---
title: Setting a minimum specification for codespace machines
shortTitle: Set a minimum machine spec
-intro: 'You can avoid under-resourced machine types being used for {% data variables.product.prodname_github_codespaces %} for your repository.'
+intro: You can avoid under-resourced machine types being used for {% data variables.product.prodname_github_codespaces %} for your repository.
permissions: People with write permissions to a repository can create or edit the codespace configuration.
versions:
fpt: '*'
ghec: '*'
-type: how_to
redirect_from:
- /codespaces/setting-up-your-project-for-codespaces/setting-a-minimum-specification-for-codespace-machines
+contentType: how-tos
---
## Overview
diff --git a/content/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/specifying-recommended-secrets-for-a-repository.md b/content/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/specifying-recommended-secrets-for-a-repository.md
index c1961738b0a9..fe33b1cb67ef 100644
--- a/content/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/specifying-recommended-secrets-for-a-repository.md
+++ b/content/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/specifying-recommended-secrets-for-a-repository.md
@@ -6,7 +6,7 @@ permissions: People with write permissions to a repository can create or edit th
versions:
fpt: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## About recommended secrets
diff --git a/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-repository/facilitating-quick-creation-and-resumption-of-codespaces.md b/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-repository/facilitating-quick-creation-and-resumption-of-codespaces.md
index ee9e01ec22e8..006da3e95f5b 100644
--- a/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-repository/facilitating-quick-creation-and-resumption-of-codespaces.md
+++ b/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-repository/facilitating-quick-creation-and-resumption-of-codespaces.md
@@ -1,15 +1,15 @@
---
title: Facilitating quick creation and resumption of codespaces
shortTitle: Facilitating codespace creation
-intro: 'You can add a link to take people straight to a page for creating a codespace, with your choice of options preconfigured. Alternatively you can link to the "Resume codespace" page.'
+intro: You can add a link to take people straight to a page for creating a codespace, with your choice of options preconfigured. Alternatively you can link to the "Resume codespace" page.
allowTitleToDifferFromFilename: true
versions:
fpt: '*'
ghec: '*'
-type: how_to
redirect_from:
- /codespaces/setting-up-your-project-for-codespaces/adding-a-codespaces-badge
- /codespaces/setting-up-your-project-for-codespaces/setting-up-your-repository/adding-a-codespaces-badge
+contentType: how-tos
---
## Overview
diff --git a/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-repository/setting-up-a-template-repository-for-github-codespaces.md b/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-repository/setting-up-a-template-repository-for-github-codespaces.md
index 77b65e2f2946..b1bc475286f2 100644
--- a/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-repository/setting-up-a-template-repository-for-github-codespaces.md
+++ b/content/codespaces/setting-up-your-project-for-codespaces/setting-up-your-repository/setting-up-a-template-repository-for-github-codespaces.md
@@ -1,13 +1,13 @@
---
title: Setting up a template repository for GitHub Codespaces
shortTitle: Set up a template repo
-intro: 'You can help people get started with a project by setting up a template repository for use with {% data variables.product.prodname_github_codespaces %}.'
+intro: You can help people get started with a project by setting up a template repository for use with {% data variables.product.prodname_github_codespaces %}.
versions:
fpt: '*'
ghec: '*'
-type: how_to
redirect_from:
- /codespaces/setting-up-your-project-for-codespaces/setting-up-a-template-repository-for-github-codespaces
+contentType: how-tos
---
## Introduction
diff --git a/content/codespaces/setting-your-user-preferences/choosing-the-stable-or-beta-host-image.md b/content/codespaces/setting-your-user-preferences/choosing-the-stable-or-beta-host-image.md
index 2dbaa67bc2eb..eab498141a5a 100644
--- a/content/codespaces/setting-your-user-preferences/choosing-the-stable-or-beta-host-image.md
+++ b/content/codespaces/setting-your-user-preferences/choosing-the-stable-or-beta-host-image.md
@@ -1,11 +1,11 @@
---
title: Choosing the stable or beta host image
shortTitle: Choose the host image
-intro: 'You can choose to build codespaces using either the stable or beta version of the host image for the underlying virtual machine.'
+intro: You can choose to build codespaces using either the stable or beta version of the host image for the underlying virtual machine.
versions:
fpt: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## About the virtual machine host image
diff --git a/content/codespaces/setting-your-user-preferences/configuring-automatic-deletion-of-your-codespaces.md b/content/codespaces/setting-your-user-preferences/configuring-automatic-deletion-of-your-codespaces.md
index dcc1a971c3d5..2f44d50f0941 100644
--- a/content/codespaces/setting-your-user-preferences/configuring-automatic-deletion-of-your-codespaces.md
+++ b/content/codespaces/setting-your-user-preferences/configuring-automatic-deletion-of-your-codespaces.md
@@ -1,13 +1,13 @@
---
title: Configuring automatic deletion of your codespaces
shortTitle: Configure automatic deletion
-intro: 'Inactive codespaces are automatically deleted. You can choose how long your stopped codespaces are retained, up to a maximum of 30 days.'
+intro: Inactive codespaces are automatically deleted. You can choose how long your stopped codespaces are retained, up to a maximum of 30 days.
redirect_from:
- /codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces
versions:
fpt: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
By default, {% data variables.product.prodname_github_codespaces %} are automatically deleted after they have been stopped and have remained inactive for 30 days.
diff --git a/content/codespaces/setting-your-user-preferences/personalizing-github-codespaces-for-your-account.md b/content/codespaces/setting-your-user-preferences/personalizing-github-codespaces-for-your-account.md
index 3d374a122211..9af46383b542 100644
--- a/content/codespaces/setting-your-user-preferences/personalizing-github-codespaces-for-your-account.md
+++ b/content/codespaces/setting-your-user-preferences/personalizing-github-codespaces-for-your-account.md
@@ -1,7 +1,7 @@
---
title: Personalizing GitHub Codespaces for your account
shortTitle: Personalize your codespaces
-intro: 'You can personalize {% data variables.product.prodname_github_codespaces %} by using a `dotfiles` repository on {% data variables.product.github %} or by using Settings Sync.'
+intro: You can personalize {% data variables.product.prodname_github_codespaces %} by using a `dotfiles` repository on {% data variables.product.github %} or by using Settings Sync.
redirect_from:
- /github/developing-online-with-github-codespaces/personalizing-github-codespaces-for-your-account
- /github/developing-online-with-codespaces/personalizing-codespaces-for-your-account
@@ -11,7 +11,7 @@ redirect_from:
versions:
fpt: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
diff --git a/content/codespaces/setting-your-user-preferences/setting-your-default-editor-for-github-codespaces.md b/content/codespaces/setting-your-user-preferences/setting-your-default-editor-for-github-codespaces.md
index 620a0907810c..df5eb3101f9e 100644
--- a/content/codespaces/setting-your-user-preferences/setting-your-default-editor-for-github-codespaces.md
+++ b/content/codespaces/setting-your-user-preferences/setting-your-default-editor-for-github-codespaces.md
@@ -9,7 +9,7 @@ redirect_from:
- /codespaces/managing-your-codespaces/setting-your-default-editor-for-codespaces
- /codespaces/customizing-your-codespace/setting-your-default-editor-for-codespaces
- /codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces
-type: how_to
+contentType: how-tos
---
On the settings page, you can set your editor preference so that when you create a codespace, or open an existing codespace, it is opened in your choice of:
diff --git a/content/codespaces/setting-your-user-preferences/setting-your-default-region-for-github-codespaces.md b/content/codespaces/setting-your-user-preferences/setting-your-default-region-for-github-codespaces.md
index 2014f43c6f38..ec72a20c7799 100644
--- a/content/codespaces/setting-your-user-preferences/setting-your-default-region-for-github-codespaces.md
+++ b/content/codespaces/setting-your-user-preferences/setting-your-default-region-for-github-codespaces.md
@@ -1,7 +1,7 @@
---
title: Setting your default region for GitHub Codespaces
shortTitle: Set the default region
-intro: 'You can set your default region in the {% data variables.product.prodname_github_codespaces %} profile settings page to personalize where your data is held.'
+intro: You can set your default region in the {% data variables.product.prodname_github_codespaces %} profile settings page to personalize where your data is held.
versions:
fpt: '*'
ghec: '*'
@@ -9,7 +9,7 @@ redirect_from:
- /codespaces/managing-your-codespaces/setting-your-default-region-for-codespaces
- /codespaces/customizing-your-codespace/setting-your-default-region-for-codespaces
- /codespaces/customizing-your-codespace/setting-your-default-region-for-github-codespaces
-type: how_to
+contentType: how-tos
---
You can manually select the region that your codespaces will be created in, allowing you to meet stringent security and compliance requirements. By default, your region is set automatically, based on your location.
diff --git a/content/codespaces/setting-your-user-preferences/setting-your-timeout-period-for-github-codespaces.md b/content/codespaces/setting-your-user-preferences/setting-your-timeout-period-for-github-codespaces.md
index 476eb08178ec..1548d96ebc7b 100644
--- a/content/codespaces/setting-your-user-preferences/setting-your-timeout-period-for-github-codespaces.md
+++ b/content/codespaces/setting-your-user-preferences/setting-your-timeout-period-for-github-codespaces.md
@@ -1,14 +1,14 @@
---
title: Setting your timeout period for GitHub Codespaces
shortTitle: Set the timeout
-intro: 'You can set your default timeout for {% data variables.product.prodname_github_codespaces %} in your personal settings page.'
+intro: You can set your default timeout for {% data variables.product.prodname_github_codespaces %} in your personal settings page.
redirect_from:
- /codespaces/customizing-your-codespace/setting-your-timeout-period-for-codespaces
- /codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces
versions:
fpt: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## About the idle timeout
diff --git a/content/codespaces/the-githubdev-web-based-editor.md b/content/codespaces/the-githubdev-web-based-editor.md
index b81a550f49c5..49e373ba868c 100644
--- a/content/codespaces/the-githubdev-web-based-editor.md
+++ b/content/codespaces/the-githubdev-web-based-editor.md
@@ -1,12 +1,12 @@
---
title: The github.dev web-based editor
shortTitle: github.dev editor
-intro: 'You can use the {% data variables.codespaces.serverless %} web-based editor to edit files and commit your changes.'
+intro: You can use the {% data variables.codespaces.serverless %} web-based editor to edit files and commit your changes.
versions:
feature: githubdev-editor
-type: how_to
redirect_from:
- /codespaces/developing-in-codespaces/web-based-editor
+contentType: how-tos
---
>[!NOTE] The {% data variables.codespaces.serverless %} editor is currently in {% data variables.release-phases.public_preview %}. You can provide feedback [in our Discussions](https://github.com/community/community/discussions/categories/codespaces).{% ifversion ghec %} Additionally, the {% data variables.codespaces.serverless %} editor is not available on subdomains of {% data variables.enterprise.data_residency_site %}, such as `octocorp.ghe.com`.{% endif %}
diff --git a/content/codespaces/troubleshooting/exporting-changes-to-a-branch.md b/content/codespaces/troubleshooting/exporting-changes-to-a-branch.md
index a73728a54483..9f68f0c72914 100644
--- a/content/codespaces/troubleshooting/exporting-changes-to-a-branch.md
+++ b/content/codespaces/troubleshooting/exporting-changes-to-a-branch.md
@@ -4,8 +4,8 @@ intro: This article provides steps for exporting your codespace changes to a bra
versions:
fpt: '*'
ghec: '*'
-type: reference
shortTitle: Exporting changes
+contentType: reference
---
## About exporting changes
diff --git a/content/codespaces/troubleshooting/github-codespaces-logs.md b/content/codespaces/troubleshooting/github-codespaces-logs.md
index 74c0508b46e7..d78c1d53a62b 100644
--- a/content/codespaces/troubleshooting/github-codespaces-logs.md
+++ b/content/codespaces/troubleshooting/github-codespaces-logs.md
@@ -1,13 +1,13 @@
---
title: GitHub Codespaces logs
-intro: 'Overview of the logs used by {% data variables.product.prodname_github_codespaces %}.'
+intro: Overview of the logs used by {% data variables.product.prodname_github_codespaces %}.
versions:
fpt: '*'
ghec: '*'
-type: reference
shortTitle: Codespaces logs
redirect_from:
- /codespaces/troubleshooting/codespaces-logs
+contentType: reference
---
Information on {% data variables.product.prodname_github_codespaces %} is output to various logs:
diff --git a/content/codespaces/troubleshooting/troubleshooting-authentication-to-a-repository.md b/content/codespaces/troubleshooting/troubleshooting-authentication-to-a-repository.md
index 9600c543b0f9..2bb55d1725fd 100644
--- a/content/codespaces/troubleshooting/troubleshooting-authentication-to-a-repository.md
+++ b/content/codespaces/troubleshooting/troubleshooting-authentication-to-a-repository.md
@@ -1,11 +1,11 @@
---
title: Troubleshooting authentication to a repository
-intro: 'Learn how to troubleshoot common authentication issues when you clone, push to, or pull from a repository in a codespace.'
+intro: Learn how to troubleshoot common authentication issues when you clone, push to, or pull from a repository in a codespace.
versions:
fpt: '*'
ghec: '*'
-type: reference
shortTitle: Authenticating to repositories
+contentType: reference
---
When you create a codespace for a repository, you can generally use `git pull` and `git push` to pull and push changes to that repository without any additional authentication. However, occasionally you may see authentication errors when trying to run these operations.
diff --git a/content/codespaces/troubleshooting/troubleshooting-creation-and-deletion-of-codespaces.md b/content/codespaces/troubleshooting/troubleshooting-creation-and-deletion-of-codespaces.md
index e7ca42ab35e8..fb507b4b389c 100644
--- a/content/codespaces/troubleshooting/troubleshooting-creation-and-deletion-of-codespaces.md
+++ b/content/codespaces/troubleshooting/troubleshooting-creation-and-deletion-of-codespaces.md
@@ -1,11 +1,11 @@
---
title: Troubleshooting creation and deletion of codespaces
-intro: 'This article provides troubleshooting steps for common issues you may experience when creating or deleting a codespace, including storage and configuration issues.'
+intro: This article provides troubleshooting steps for common issues you may experience when creating or deleting a codespace, including storage and configuration issues.
versions:
fpt: '*'
ghec: '*'
-type: reference
shortTitle: Creation and deletion
+contentType: reference
---
## Creating codespaces
diff --git a/content/codespaces/troubleshooting/troubleshooting-github-codespaces-clients.md b/content/codespaces/troubleshooting/troubleshooting-github-codespaces-clients.md
index 08cf968e36f3..c90dbb92f2b2 100644
--- a/content/codespaces/troubleshooting/troubleshooting-github-codespaces-clients.md
+++ b/content/codespaces/troubleshooting/troubleshooting-github-codespaces-clients.md
@@ -1,13 +1,13 @@
---
title: Troubleshooting GitHub Codespaces clients
shortTitle: Codespaces clients
-intro: 'This article provides troubleshooting information for issues you may encounter with the client you use for {% data variables.product.prodname_github_codespaces %}.'
+intro: This article provides troubleshooting information for issues you may encounter with the client you use for {% data variables.product.prodname_github_codespaces %}.
versions:
fpt: '*'
ghec: '*'
-type: reference
redirect_from:
- /codespaces/troubleshooting/troubleshooting-codespaces-clients
+contentType: reference
---
{% webui %}
diff --git a/content/codespaces/troubleshooting/troubleshooting-gpg-verification-for-github-codespaces.md b/content/codespaces/troubleshooting/troubleshooting-gpg-verification-for-github-codespaces.md
index 075537f3e59d..72379e930b9c 100644
--- a/content/codespaces/troubleshooting/troubleshooting-gpg-verification-for-github-codespaces.md
+++ b/content/codespaces/troubleshooting/troubleshooting-gpg-verification-for-github-codespaces.md
@@ -5,7 +5,7 @@ intro: This article provides troubleshooting advice for errors related to signin
versions:
fpt: '*'
ghec: '*'
-type: reference
+contentType: reference
---
If you enable GPG verification, {% data variables.product.prodname_github_codespaces %} automatically signs your commits in codespaces that you create from selected repositories. For more information, see [AUTOTITLE](/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces).
diff --git a/content/codespaces/troubleshooting/troubleshooting-included-usage.md b/content/codespaces/troubleshooting/troubleshooting-included-usage.md
index d6cd7f4e8996..47d1e998f36c 100644
--- a/content/codespaces/troubleshooting/troubleshooting-included-usage.md
+++ b/content/codespaces/troubleshooting/troubleshooting-included-usage.md
@@ -2,11 +2,11 @@
title: Getting the most out of your included usage
shortTitle: Included usage
allowTitleToDifferFromFilename: true
-intro: 'Find out about the free use of {% data variables.product.prodname_github_codespaces %} that''s included with personal accounts.'
+intro: Find out about the free use of {% data variables.product.prodname_github_codespaces %} that's included with personal accounts.
versions:
fpt: '*'
ghec: '*'
-type: reference
+contentType: reference
---
Personal {% data variables.product.prodname_dotcom %} accounts include a quota of free use of {% data variables.product.prodname_github_codespaces %} every month.
diff --git a/content/codespaces/troubleshooting/troubleshooting-personalization-for-codespaces.md b/content/codespaces/troubleshooting/troubleshooting-personalization-for-codespaces.md
index dda80509ab6a..14e7dbce4c93 100644
--- a/content/codespaces/troubleshooting/troubleshooting-personalization-for-codespaces.md
+++ b/content/codespaces/troubleshooting/troubleshooting-personalization-for-codespaces.md
@@ -5,10 +5,10 @@ intro: Troubleshooting steps for common issues with dotfiles and Settings Sync.
versions:
fpt: '*'
ghec: '*'
-type: reference
shortTitle: Personalization
redirect_from:
- /codespaces/troubleshooting/troubleshooting-dotfiles-for-codespaces
+contentType: reference
---
You can personalize {% data variables.product.prodname_github_codespaces %} by using a `dotfiles` repository on {% data variables.product.github %} or by using Settings Sync. For more information, see [AUTOTITLE](/codespaces/setting-your-user-preferences/personalizing-github-codespaces-for-your-account).
diff --git a/content/codespaces/troubleshooting/troubleshooting-port-forwarding-for-github-codespaces.md b/content/codespaces/troubleshooting/troubleshooting-port-forwarding-for-github-codespaces.md
index b0dcaa760bc5..04d0304ad779 100644
--- a/content/codespaces/troubleshooting/troubleshooting-port-forwarding-for-github-codespaces.md
+++ b/content/codespaces/troubleshooting/troubleshooting-port-forwarding-for-github-codespaces.md
@@ -4,10 +4,10 @@ intro: Troubleshooting steps for common port forwarding issues.
versions:
fpt: '*'
ghec: '*'
-type: reference
shortTitle: Port forwarding
redirect_from:
- /codespaces/troubleshooting/troubleshooting-port-forwarding-for-codespaces
+contentType: reference
---
When an application running inside a codespace outputs a port to the console, {% data variables.product.prodname_github_codespaces %} detects the localhost URL pattern and automatically forwards the port. For more information, see [AUTOTITLE](/codespaces/developing-in-a-codespace/forwarding-ports-in-your-codespace).
diff --git a/content/codespaces/troubleshooting/troubleshooting-prebuilds.md b/content/codespaces/troubleshooting/troubleshooting-prebuilds.md
index 5463d9556db4..05395a725c10 100644
--- a/content/codespaces/troubleshooting/troubleshooting-prebuilds.md
+++ b/content/codespaces/troubleshooting/troubleshooting-prebuilds.md
@@ -5,7 +5,7 @@ intro: You can use prebuilds to speed up the creation of codespaces. This articl
versions:
fpt: '*'
ghec: '*'
-type: reference
+contentType: reference
---
For more information about {% data variables.product.prodname_github_codespaces %} prebuilds, see [AUTOTITLE](/codespaces/prebuilding-your-codespaces).
diff --git a/content/codespaces/troubleshooting/troubleshooting-your-connection-to-github-codespaces.md b/content/codespaces/troubleshooting/troubleshooting-your-connection-to-github-codespaces.md
index 51492e920c84..07f0417c6ede 100644
--- a/content/codespaces/troubleshooting/troubleshooting-your-connection-to-github-codespaces.md
+++ b/content/codespaces/troubleshooting/troubleshooting-your-connection-to-github-codespaces.md
@@ -1,13 +1,13 @@
---
title: Troubleshooting your connection to GitHub Codespaces
-intro: 'Troubleshooting help for connecting to {% data variables.product.prodname_github_codespaces %}.'
+intro: Troubleshooting help for connecting to {% data variables.product.prodname_github_codespaces %}.
versions:
fpt: '*'
ghec: '*'
-type: reference
shortTitle: Connection
redirect_from:
- /codespaces/troubleshooting/troubleshooting-your-connection-to-codespaces
+contentType: reference
---
## 503 codespace service unavailable
diff --git a/content/codespaces/troubleshooting/working-with-support-for-github-codespaces.md b/content/codespaces/troubleshooting/working-with-support-for-github-codespaces.md
index 8ebae26e5e2e..06e74d697958 100644
--- a/content/codespaces/troubleshooting/working-with-support-for-github-codespaces.md
+++ b/content/codespaces/troubleshooting/working-with-support-for-github-codespaces.md
@@ -1,13 +1,13 @@
---
title: Working with support for GitHub Codespaces
-intro: 'Tips on getting the best help from support for {% data variables.product.prodname_github_codespaces %}.'
+intro: Tips on getting the best help from support for {% data variables.product.prodname_github_codespaces %}.
versions:
fpt: '*'
ghec: '*'
-type: reference
shortTitle: Working with support
redirect_from:
- /codespaces/troubleshooting/working-with-support-for-codespaces
+contentType: reference
---
Before support can help you with problems with codespaces, you need to know the permanent name of the codespace and its codespaces ID (identifier). In addition, support may ask you to share some logs with them. For more information, see [AUTOTITLE](/codespaces/troubleshooting/github-codespaces-logs) and [AUTOTITLE](/support/learning-about-github-support/about-github-support).
diff --git a/content/contributing/writing-for-github-docs/templates.md b/content/contributing/writing-for-github-docs/templates.md
index 59991fc123f2..21f3dd4f63f0 100644
--- a/content/contributing/writing-for-github-docs/templates.md
+++ b/content/contributing/writing-for-github-docs/templates.md
@@ -19,7 +19,7 @@ title: 'About '
shortTitle: ''
intro: 'Article intro. See tips for a great intro below.'
product: "optional product callout"
-type: overview
+contentType: concepts
versions:
- version
---
@@ -69,7 +69,7 @@ title: Nouns describing your subject
shortTitle: # Max 31 characters
intro: 'Article intro. See tips for a great intro below.'
product: "{{ optional product callout }}"
-type: reference
+contentType: reference
versions:
-
---
@@ -119,7 +119,7 @@ title: Start with a present participle
shortTitle: # Max 31 characters
intro: 'Article intro. See tips for a great intro below.'
product: "{{ optional product callout }}"
-type: how_to
+contentType: how-tos
versions:
-
---
@@ -168,7 +168,7 @@ Use the content model for full instructions and examples on how to write quickst
title: Quickstart title
shortTitle: # Max 31 characters
intro: 'Article intro. Highlight that the guide is quick and to the point.'
-type: quick_start
+contentType: get-started
versions:
-
---
@@ -235,7 +235,7 @@ title: Tutorial title
shortTitle: # Max 31 characters
intro: 'Article intro. See tips for a great intro below'
product: "{{ optional product callout }}"
-type: tutorial
+contentType: tutorials
versions:
-
---
@@ -308,7 +308,7 @@ title: Guide title
shortTitle: # Max 31 characters
intro: 'Article intro. See tips for a great intro below'
product: "{{ optional product callout }}"
-type: tutorial
+contentType: tutorials
versions:
-
---
diff --git a/content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics.md b/content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics.md
index 4c829b5b2949..513fc95bc9d1 100644
--- a/content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics.md
+++ b/content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics.md
@@ -7,11 +7,11 @@ permissions: '{% data reusables.copilot.usage-metrics-permissions %}'
versions:
fpt: '*'
ghec: '*'
-type: reference
category:
- Copilot usage metrics
- Understand available data
- Track Copilot usage
+contentType: reference
---
The {% data variables.product.prodname_copilot_short %} usage metrics dashboard and APIs display and export data using a consistent set of fields. This reference lists all available metrics and describes how to interpret their values in both dashboard visuals and NDJSON or API exports.
diff --git a/content/copilot/tutorials/roll-out-at-scale/measure-success.md b/content/copilot/tutorials/roll-out-at-scale/measure-success.md
index 363b0bb11ace..791acee2e061 100644
--- a/content/copilot/tutorials/roll-out-at-scale/measure-success.md
+++ b/content/copilot/tutorials/roll-out-at-scale/measure-success.md
@@ -5,13 +5,13 @@ intro: Measure the success of a {% data variables.product.prodname_copilot_short
permissions: '{% data reusables.copilot.usage-metrics-permissions %}'
versions:
feature: copilot
-type: tutorial
allowTitleToDifferFromFilename: true
category:
- Copilot usage metrics
- Measure success
- Track Copilot usage
- Manage Copilot for a team
+contentType: tutorials
---
When you run a {% data variables.product.prodname_copilot_short %} trial, the key to success is understanding how teams adopt and use {% data variables.product.prodname_copilot_short %}.
diff --git a/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/about-github-classroom.md b/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/about-github-classroom.md
index bd5b29d96f39..c07a1de1b5b1 100644
--- a/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/about-github-classroom.md
+++ b/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/about-github-classroom.md
@@ -1,9 +1,9 @@
---
title: About GitHub Classroom
-intro: 'Teachers and school administrators can use {% data variables.product.prodname_classroom %} to create virtual classrooms, make and edit assignments, automatically grade assignment submissions, and more.'
-type: overview
+intro: Teachers and school administrators can use {% data variables.product.prodname_classroom %} to create virtual classrooms, make and edit assignments, automatically grade assignment submissions, and more.
versions:
fpt: '*'
+contentType: concepts
---
## About {% data variables.product.prodname_classroom %}
diff --git a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/about-assignments.md b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/about-assignments.md
index 39ca39c45809..00359c47c47b 100644
--- a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/about-assignments.md
+++ b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/about-assignments.md
@@ -1,10 +1,10 @@
---
title: About assignments
-intro: 'You can use individual or group assignments in {% data variables.product.prodname_classroom %} to teach students and grade their work.'
+intro: You can use individual or group assignments in {% data variables.product.prodname_classroom %} to teach students and grade their work.
shortTitle: About assignments
-type: overview
versions:
fpt: '*'
+contentType: concepts
---
## About assignments in {% data variables.product.prodname_classroom %}
diff --git a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/using-github-classroom-with-github-cli.md b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/using-github-classroom-with-github-cli.md
index 2a761846d3c6..58ca8e57efce 100644
--- a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/using-github-classroom-with-github-cli.md
+++ b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/using-github-classroom-with-github-cli.md
@@ -1,11 +1,11 @@
---
-title: 'Using {% data variables.product.prodname_classroom %} with {% data variables.product.prodname_cli %}'
+title: Using {% data variables.product.prodname_classroom %} with {% data variables.product.prodname_cli %}
shortTitle: '{% data variables.product.prodname_classroom %} CLI'
allowTitleToDifferFromFilename: true
-intro: 'You can use `gh`, the {% data variables.product.github %} command line interface, to work with {% data variables.product.prodname_classroom %} directly from your command line.'
+intro: You can use `gh`, the {% data variables.product.github %} command line interface, to work with {% data variables.product.prodname_classroom %} directly from your command line.
versions:
fpt: '*'
-type: how_to
+contentType: how-tos
---
## About {% data variables.product.prodname_classroom %} CLI
diff --git a/content/enterprise-onboarding/getting-started-with-your-enterprise/about-enterprise-billing.md b/content/enterprise-onboarding/getting-started-with-your-enterprise/about-enterprise-billing.md
index 3274efb0eb06..7c9fddeabfdf 100644
--- a/content/enterprise-onboarding/getting-started-with-your-enterprise/about-enterprise-billing.md
+++ b/content/enterprise-onboarding/getting-started-with-your-enterprise/about-enterprise-billing.md
@@ -1,10 +1,10 @@
---
title: About enterprise billing
-intro: 'Understand billing for {% data variables.product.prodname_ghe_cloud %}.'
+intro: Understand billing for {% data variables.product.prodname_ghe_cloud %}.
versions:
ghec: '*'
-type: overview
shortTitle: Billing
+contentType: concepts
---
## About billing for your enterprise
diff --git a/content/enterprise-onboarding/getting-started-with-your-enterprise/about-migrating-to-github-enterprise-cloud.md b/content/enterprise-onboarding/getting-started-with-your-enterprise/about-migrating-to-github-enterprise-cloud.md
index 0007a5fdc52a..39acd5144862 100644
--- a/content/enterprise-onboarding/getting-started-with-your-enterprise/about-migrating-to-github-enterprise-cloud.md
+++ b/content/enterprise-onboarding/getting-started-with-your-enterprise/about-migrating-to-github-enterprise-cloud.md
@@ -3,9 +3,8 @@ title: About migrating to GitHub Enterprise Cloud
intro: Explore migrating your current solution into {% data variables.product.prodname_ghe_cloud %}.
versions:
ghec: '*'
-type: overview
shortTitle: Migrations
-contentType: other
+contentType: concepts
---
{% data reusables.migrations.about-migrations %}
diff --git a/content/enterprise-onboarding/getting-started-with-your-enterprise/setting-up-a-trial-of-github-enterprise.md b/content/enterprise-onboarding/getting-started-with-your-enterprise/setting-up-a-trial-of-github-enterprise.md
index 9ac2af88a5f3..7456db570f1b 100644
--- a/content/enterprise-onboarding/getting-started-with-your-enterprise/setting-up-a-trial-of-github-enterprise.md
+++ b/content/enterprise-onboarding/getting-started-with-your-enterprise/setting-up-a-trial-of-github-enterprise.md
@@ -1,12 +1,12 @@
---
title: Setting up a trial of GitHub Enterprise
-intro: 'Understand what is included in the {% data variables.product.prodname_ghe_cloud %} trial, and how to get started.'
+intro: Understand what is included in the {% data variables.product.prodname_ghe_cloud %} trial, and how to get started.
versions:
ghec: '*'
-type: how_to
shortTitle: Start a trial
redirect_from:
- /enterprise-onboarding/getting-started-with-your-enterprise/ending-a-trial-of-github-enterprise
+contentType: how-tos
---
To set up a trial, you must be signed in to a personal account.
diff --git a/content/enterprise-onboarding/github-actions-for-your-enterprise/about-github-actions-for-enterprises.md b/content/enterprise-onboarding/github-actions-for-your-enterprise/about-github-actions-for-enterprises.md
index 7af7afceac46..22ca5491ede5 100644
--- a/content/enterprise-onboarding/github-actions-for-your-enterprise/about-github-actions-for-enterprises.md
+++ b/content/enterprise-onboarding/github-actions-for-your-enterprise/about-github-actions-for-enterprises.md
@@ -4,8 +4,8 @@ shortTitle: About GitHub Actions
intro: '{% data variables.product.prodname_actions %} can improve developer productivity by automating your enterprise''s software development cycle.'
versions:
ghec: '*'
-type: overview
allowTitleToDifferFromFilename: true
+contentType: concepts
---
## About {% data variables.product.prodname_actions %} for enterprises
diff --git a/content/enterprise-onboarding/github-actions-for-your-enterprise/actions-components.md b/content/enterprise-onboarding/github-actions-for-your-enterprise/actions-components.md
index 3a15021e5918..64f67dfdc17b 100644
--- a/content/enterprise-onboarding/github-actions-for-your-enterprise/actions-components.md
+++ b/content/enterprise-onboarding/github-actions-for-your-enterprise/actions-components.md
@@ -4,11 +4,10 @@ shortTitle: Actions components
intro: Understand the basics of {% data variables.product.prodname_actions %}, including core concepts and essential terminology.
versions:
ghec: '*'
-type: overview
allowTitleToDifferFromFilename: true
redirect_from:
- /enterprise-onboarding/github-actions-for-your-enterprise/understanding-github-actions
-contentType: other
+contentType: concepts
---
{% data reusables.actions.enterprise-github-hosted-runners %}
diff --git a/content/enterprise-onboarding/github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-cloud.md b/content/enterprise-onboarding/github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-cloud.md
index 10a607715726..fc62debf4d89 100644
--- a/content/enterprise-onboarding/github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-cloud.md
+++ b/content/enterprise-onboarding/github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-cloud.md
@@ -1,11 +1,11 @@
---
title: Getting started with GitHub Actions for GitHub Enterprise Cloud
shortTitle: Get started
-intro: 'Configure {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_cloud %}.'
+intro: Configure {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_cloud %}.
versions:
ghec: '*'
-type: how_to
allowTitleToDifferFromFilename: true
+contentType: how-tos
---
{% data variables.product.prodname_actions %} is enabled for your enterprise by default. To get started using {% data variables.product.prodname_actions %} within your enterprise, you can manage the policies that control how enterprise members use {% data variables.product.prodname_actions %} and optionally add self-hosted runners to run workflows.
diff --git a/content/enterprise-onboarding/github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions.md b/content/enterprise-onboarding/github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions.md
index 9546fb22e00f..506281a0e381 100644
--- a/content/enterprise-onboarding/github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions.md
+++ b/content/enterprise-onboarding/github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions.md
@@ -1,11 +1,11 @@
---
title: Migrating your enterprise to GitHub Actions
shortTitle: Migrate to Actions
-intro: 'Plan a migration to {% data variables.product.prodname_actions %} for your enterprise from another provider.'
+intro: Plan a migration to {% data variables.product.prodname_actions %} for your enterprise from another provider.
versions:
ghec: '*'
-type: how_to
allowTitleToDifferFromFilename: true
+contentType: how-tos
---
## About enterprise migrations to {% data variables.product.prodname_actions %}
diff --git a/content/enterprise-onboarding/github-actions-for-your-enterprise/planning-a-rollout-of-github-actions.md b/content/enterprise-onboarding/github-actions-for-your-enterprise/planning-a-rollout-of-github-actions.md
index 9a8190e8ac39..db1d18f59dea 100644
--- a/content/enterprise-onboarding/github-actions-for-your-enterprise/planning-a-rollout-of-github-actions.md
+++ b/content/enterprise-onboarding/github-actions-for-your-enterprise/planning-a-rollout-of-github-actions.md
@@ -1,15 +1,14 @@
---
title: Planning a rollout of GitHub Actions
-shortTitle: 'Plan a rollout'
+shortTitle: Plan a rollout
intro: You can plan how to roll out {% data variables.product.prodname_actions %} in your enterprise.
versions:
ghec: '*'
-type: how_to
allowTitleToDifferFromFilename: true
redirect_from:
- /enterprise-onboarding/github-actions-for-your-enterprise/security-hardening-for-github-actions
- /enterprise-onboarding/github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise
-contentType: other
+contentType: how-tos
---
## Governance and compliance
diff --git a/content/enterprise-onboarding/github-apps/automations-in-your-enterprise.md b/content/enterprise-onboarding/github-apps/automations-in-your-enterprise.md
index cb6a03da8b04..d26380b194bd 100644
--- a/content/enterprise-onboarding/github-apps/automations-in-your-enterprise.md
+++ b/content/enterprise-onboarding/github-apps/automations-in-your-enterprise.md
@@ -1,10 +1,10 @@
---
title: Automations in your enterprise
shortTitle: Automations
-intro: 'Learn how {% data variables.product.prodname_github_apps %}, external services, and {% data variables.product.prodname_actions %} work together to automate processes in your enterprise.'
+intro: Learn how {% data variables.product.prodname_github_apps %}, external services, and {% data variables.product.prodname_actions %} work together to automate processes in your enterprise.
versions:
ghec: '*'
-type: overview
+contentType: concepts
---
{% data reusables.enterprise-onboarding.automations %}
diff --git a/content/enterprise-onboarding/github-apps/create-enterprise-apps.md b/content/enterprise-onboarding/github-apps/create-enterprise-apps.md
index cb09a383caf2..281b956652bc 100644
--- a/content/enterprise-onboarding/github-apps/create-enterprise-apps.md
+++ b/content/enterprise-onboarding/github-apps/create-enterprise-apps.md
@@ -1,10 +1,10 @@
---
title: Creating enterprise apps
shortTitle: Create enterprise apps
-intro: 'Create GitHub Apps that can access enterprise-level resources and automate workflows.'
+intro: Create GitHub Apps that can access enterprise-level resources and automate workflows.
versions:
ghec: '*'
-type: how_to
+contentType: how-tos
---
{% data reusables.enterprise-onboarding.create-enterprise-apps %}
diff --git a/content/enterprise-onboarding/github-apps/index.md b/content/enterprise-onboarding/github-apps/index.md
index 5b090bc52566..aa03a604b4f9 100644
--- a/content/enterprise-onboarding/github-apps/index.md
+++ b/content/enterprise-onboarding/github-apps/index.md
@@ -1,12 +1,13 @@
---
title: Automating processes with GitHub Apps
shortTitle: Automate with apps
-intro: 'Automate processes across your enterprise.'
+intro: Automate processes across your enterprise.
versions:
ghec: '*'
-type: overview
children:
- /automations-in-your-enterprise
- /create-enterprise-apps
- /install-enterprise-apps
----
\ No newline at end of file
+contentType: concepts
+---
+
diff --git a/content/enterprise-onboarding/github-apps/install-enterprise-apps.md b/content/enterprise-onboarding/github-apps/install-enterprise-apps.md
index e46ed389fbed..85ae98cdb0f4 100644
--- a/content/enterprise-onboarding/github-apps/install-enterprise-apps.md
+++ b/content/enterprise-onboarding/github-apps/install-enterprise-apps.md
@@ -1,10 +1,10 @@
---
title: Installing enterprise apps
shortTitle: Install enterprise apps
-intro: 'Install GitHub Apps to build automations for the enterprise account.'
+intro: Install GitHub Apps to build automations for the enterprise account.
versions:
ghec: '*'
-type: how_to
+contentType: how-tos
---
{% data reusables.enterprise-onboarding.install-enterprise-apps %}
diff --git a/content/enterprise-onboarding/govern-people-and-repositories/about-enterprise-policies.md b/content/enterprise-onboarding/govern-people-and-repositories/about-enterprise-policies.md
index 0b2e53dda838..e9aea232f502 100644
--- a/content/enterprise-onboarding/govern-people-and-repositories/about-enterprise-policies.md
+++ b/content/enterprise-onboarding/govern-people-and-repositories/about-enterprise-policies.md
@@ -1,10 +1,10 @@
---
title: About enterprise policies
shortTitle: About enterprise policies
-intro: 'Understand what policies are and why they are useful.'
+intro: Understand what policies are and why they are useful.
versions:
ghec: '*'
-type: overview
+contentType: concepts
---
{% data reusables.enterprise-onboarding.about-policies %}
diff --git a/content/enterprise-onboarding/govern-people-and-repositories/about-enterprise-security.md b/content/enterprise-onboarding/govern-people-and-repositories/about-enterprise-security.md
index 6bfe948a21fe..6aa47e00f4c4 100644
--- a/content/enterprise-onboarding/govern-people-and-repositories/about-enterprise-security.md
+++ b/content/enterprise-onboarding/govern-people-and-repositories/about-enterprise-security.md
@@ -8,8 +8,7 @@ allowTitleToDifferFromFilename: true
redirect_from:
- /enterprise-onboarding/feature-enhancements/about-code-security-for-your-enterprise
- /enterprise-onboarding/feature-enhancements/about-enterprise-security
-type: overview
-contentType: other
+contentType: concepts
---
{% data variables.product.prodname_dotcom %} has many features that help you improve and maintain the quality of your code. Some of these are included in all plans, such as dependency graph and {% data variables.product.prodname_dependabot_alerts %}. Other security features require an {% data variables.product.prodname_AS %} license to run on repositories apart from public repositories on {% data variables.product.prodname_dotcom_the_website %}.
diff --git a/content/enterprise-onboarding/govern-people-and-repositories/create-custom-properties.md b/content/enterprise-onboarding/govern-people-and-repositories/create-custom-properties.md
index b0cb89ca364c..d84abd8cb08a 100644
--- a/content/enterprise-onboarding/govern-people-and-repositories/create-custom-properties.md
+++ b/content/enterprise-onboarding/govern-people-and-repositories/create-custom-properties.md
@@ -1,10 +1,10 @@
---
title: Creating custom properties for repositories in your enterprise
shortTitle: Create custom properties
-intro: 'Create and apply custom properties to categorize and manage repositories across your enterprise.'
+intro: Create and apply custom properties to categorize and manage repositories across your enterprise.
versions:
ghec: '*'
-type: how_to
+contentType: how-tos
---
{% data reusables.enterprise-onboarding.creating-custom-properties %}
diff --git a/content/enterprise-onboarding/govern-people-and-repositories/create-repository-policies.md b/content/enterprise-onboarding/govern-people-and-repositories/create-repository-policies.md
index c49f8709fa38..4ffcd62c62ec 100644
--- a/content/enterprise-onboarding/govern-people-and-repositories/create-repository-policies.md
+++ b/content/enterprise-onboarding/govern-people-and-repositories/create-repository-policies.md
@@ -1,10 +1,10 @@
---
title: Defining policies for repositories in your enterprise
shortTitle: Create repository policies
-intro: 'Enforce repository policies across your enterprise using custom properties and targeting rules.'
+intro: Enforce repository policies across your enterprise using custom properties and targeting rules.
versions:
ghec: '*'
-type: how_to
+contentType: how-tos
---
{% data reusables.enterprise.repo-policy-rules-preview %}
diff --git a/content/enterprise-onboarding/govern-people-and-repositories/index.md b/content/enterprise-onboarding/govern-people-and-repositories/index.md
index 564121d1801f..b9fee41dc5ee 100644
--- a/content/enterprise-onboarding/govern-people-and-repositories/index.md
+++ b/content/enterprise-onboarding/govern-people-and-repositories/index.md
@@ -1,10 +1,9 @@
---
title: Governing people and repositories
shortTitle: Govern people and repositories
-intro: 'Implement policies, custom properties, and rulesets to govern users and repositories across your enterprise.'
+intro: Implement policies, custom properties, and rulesets to govern users and repositories across your enterprise.
versions:
ghec: '*'
-type: overview
children:
- /about-enterprise-policies
- /create-custom-properties
@@ -12,5 +11,6 @@ children:
- /protect-branches
- /using-the-audit-log-for-your-enterprise
- /about-enterprise-security
+contentType: concepts
---
diff --git a/content/enterprise-onboarding/govern-people-and-repositories/protect-branches.md b/content/enterprise-onboarding/govern-people-and-repositories/protect-branches.md
index 8c075b1633d6..9b8227a316fc 100644
--- a/content/enterprise-onboarding/govern-people-and-repositories/protect-branches.md
+++ b/content/enterprise-onboarding/govern-people-and-repositories/protect-branches.md
@@ -1,12 +1,12 @@
---
title: Protecting branches in your enterprise with rulesets
shortTitle: Protect branches
-intro: 'Create rulesets at the enterprise level to enforce code governance policies across all repositories.'
+intro: Create rulesets at the enterprise level to enforce code governance policies across all repositories.
versions:
ghec: '*'
-type: how_to
redirect_from:
- /enterprise-onboarding/feature-enhancements/about-rulesets
+contentType: how-tos
---
{% data reusables.enterprise-onboarding.rulesets-intro %}
diff --git a/content/enterprise-onboarding/govern-people-and-repositories/using-the-audit-log-for-your-enterprise.md b/content/enterprise-onboarding/govern-people-and-repositories/using-the-audit-log-for-your-enterprise.md
index 3950444223e3..a0b9b06f1e70 100644
--- a/content/enterprise-onboarding/govern-people-and-repositories/using-the-audit-log-for-your-enterprise.md
+++ b/content/enterprise-onboarding/govern-people-and-repositories/using-the-audit-log-for-your-enterprise.md
@@ -3,11 +3,10 @@ title: Using the audit log for your enterprise
intro: Use the audit log to monitor activity in your enterprise.
versions:
ghec: '*'
-type: overview
shortTitle: Use the audit log
redirect_from:
- /enterprise-onboarding/feature-enhancements/about-the-audit-log-for-your-enterprise
-contentType: other
+contentType: concepts
---
{% data reusables.enterprise-onboarding.about-audit-logs %}
diff --git a/content/enterprise-onboarding/setting-up-organizations-and-teams/about-roles-in-an-enterprise.md b/content/enterprise-onboarding/setting-up-organizations-and-teams/about-roles-in-an-enterprise.md
index c9e95ee190a6..6136870d7ea0 100644
--- a/content/enterprise-onboarding/setting-up-organizations-and-teams/about-roles-in-an-enterprise.md
+++ b/content/enterprise-onboarding/setting-up-organizations-and-teams/about-roles-in-an-enterprise.md
@@ -1,12 +1,12 @@
---
title: About roles in an enterprise
shortTitle: About roles
-intro: 'Understand the different role types in an enterprise and how they control access and permissions.'
+intro: Understand the different role types in an enterprise and how they control access and permissions.
versions:
ghec: '*'
-type: overview
redirect_from:
- /enterprise-onboarding/feature-enhancements/about-access-permissions-on-github
+contentType: concepts
---
{% data reusables.enterprise-onboarding.about-roles %}
diff --git a/content/enterprise-onboarding/setting-up-organizations-and-teams/about-teams-in-an-enterprise.md b/content/enterprise-onboarding/setting-up-organizations-and-teams/about-teams-in-an-enterprise.md
index 120d835e37c4..c67c1ed4a6b0 100644
--- a/content/enterprise-onboarding/setting-up-organizations-and-teams/about-teams-in-an-enterprise.md
+++ b/content/enterprise-onboarding/setting-up-organizations-and-teams/about-teams-in-an-enterprise.md
@@ -1,12 +1,12 @@
---
title: About teams in an enterprise
shortTitle: About teams
-intro: 'Discover how teams help organize users, manage repository access, and streamline collaboration across your enterprise.'
+intro: Discover how teams help organize users, manage repository access, and streamline collaboration across your enterprise.
versions:
ghec: '*'
-type: overview
redirect_from:
- /enterprise-onboarding/setting-up-organizations-and-teams/managing-organization-members
+contentType: concepts
---
{% data reusables.enterprise-onboarding.about-teams %}
diff --git a/content/enterprise-onboarding/setting-up-organizations-and-teams/assigning-roles-to-teams-and-users.md b/content/enterprise-onboarding/setting-up-organizations-and-teams/assigning-roles-to-teams-and-users.md
index e50c92f3812f..64a72c89a3b9 100644
--- a/content/enterprise-onboarding/setting-up-organizations-and-teams/assigning-roles-to-teams-and-users.md
+++ b/content/enterprise-onboarding/setting-up-organizations-and-teams/assigning-roles-to-teams-and-users.md
@@ -1,10 +1,10 @@
---
title: Assigning roles to teams and users
shortTitle: Assign roles
-intro: 'Assign enterprise roles to manage access and permissions.'
+intro: Assign enterprise roles to manage access and permissions.
versions:
ghec: '*'
-type: how_to
+contentType: how-tos
---
{% data reusables.enterprise-onboarding.assign-roles %}
diff --git a/content/enterprise-onboarding/setting-up-organizations-and-teams/best-practices.md b/content/enterprise-onboarding/setting-up-organizations-and-teams/best-practices.md
index 5a965b60d54f..6df364bee335 100644
--- a/content/enterprise-onboarding/setting-up-organizations-and-teams/best-practices.md
+++ b/content/enterprise-onboarding/setting-up-organizations-and-teams/best-practices.md
@@ -3,11 +3,10 @@ title: Best practices for organizing work in your enterprise
intro: Structure your enterprise and organizations for the best developer experience.
versions:
ghec: '*'
-type: how_to
shortTitle: Best practices
redirect_from:
- /enterprise-onboarding/setting-up-organizations-and-teams/best-practices-for-organizations-in-your-enterprise
-contentType: other
+contentType: how-tos
---
{% data reusables.enterprise-onboarding.best-practices %}
diff --git a/content/enterprise-onboarding/setting-up-organizations-and-teams/creating-custom-roles.md b/content/enterprise-onboarding/setting-up-organizations-and-teams/creating-custom-roles.md
index 07740d2d0fd9..3792e59bdb9f 100644
--- a/content/enterprise-onboarding/setting-up-organizations-and-teams/creating-custom-roles.md
+++ b/content/enterprise-onboarding/setting-up-organizations-and-teams/creating-custom-roles.md
@@ -1,10 +1,10 @@
---
title: Creating custom roles
shortTitle: Create custom roles
-intro: 'Create custom organization roles with fine-grained permissions tailored to your enterprise needs.'
+intro: Create custom organization roles with fine-grained permissions tailored to your enterprise needs.
versions:
ghec: '*'
-type: how_to
+contentType: how-tos
---
{% data reusables.enterprise-onboarding.create-custom-roles %}
diff --git a/content/enterprise-onboarding/setting-up-organizations-and-teams/creating-teams.md b/content/enterprise-onboarding/setting-up-organizations-and-teams/creating-teams.md
index 23c2dcbfd2ad..4c2ac7abc342 100644
--- a/content/enterprise-onboarding/setting-up-organizations-and-teams/creating-teams.md
+++ b/content/enterprise-onboarding/setting-up-organizations-and-teams/creating-teams.md
@@ -1,12 +1,12 @@
---
title: Creating enterprise teams
-intro: 'Use teams to manage permissions and access.'
+intro: Use teams to manage permissions and access.
versions:
ghec: '*'
shortTitle: Create teams
-type: how_to
permissions: Enterprise owners or organization owners
allowTitleToDifferFromFilename: true
+contentType: how-tos
---
{% data reusables.enterprise-onboarding.create-enterprise-teams %}
diff --git a/content/enterprise-onboarding/setting-up-organizations-and-teams/identify-role-requirements.md b/content/enterprise-onboarding/setting-up-organizations-and-teams/identify-role-requirements.md
index 30a418aef4c1..ac7361841ab0 100644
--- a/content/enterprise-onboarding/setting-up-organizations-and-teams/identify-role-requirements.md
+++ b/content/enterprise-onboarding/setting-up-organizations-and-teams/identify-role-requirements.md
@@ -1,10 +1,10 @@
---
title: Identifying the roles required by your enterprise
-intro: 'Use teams to manage permissions, notifications, and code ownership in your organizations.'
+intro: Use teams to manage permissions, notifications, and code ownership in your organizations.
versions:
ghec: '*'
shortTitle: Identify role requirements
-type: how_to
+contentType: how-tos
---
{% data reusables.enterprise-onboarding.identify-role-requirements %}
diff --git a/content/enterprise-onboarding/setting-up-organizations-and-teams/setting-up-an-organization.md b/content/enterprise-onboarding/setting-up-organizations-and-teams/setting-up-an-organization.md
index 52910cdeaf24..6786bceee968 100644
--- a/content/enterprise-onboarding/setting-up-organizations-and-teams/setting-up-an-organization.md
+++ b/content/enterprise-onboarding/setting-up-organizations-and-teams/setting-up-an-organization.md
@@ -1,12 +1,12 @@
---
title: Setting up an organization
-intro: 'Set up an organization in your enterprise.'
+intro: Set up an organization in your enterprise.
versions:
ghec: '*'
-type: how_to
shortTitle: Set up an organization
redirect_from:
- /enterprise-onboarding/setting-up-organizations-and-teams/managing-your-organizations
+contentType: how-tos
---
During a trial, there are two ways to add organizations to your enterprise.
diff --git a/content/enterprise-onboarding/support-for-your-enterprise/managing-support-entitlements.md b/content/enterprise-onboarding/support-for-your-enterprise/managing-support-entitlements.md
index e34cf4a58219..9d470f9c2b91 100644
--- a/content/enterprise-onboarding/support-for-your-enterprise/managing-support-entitlements.md
+++ b/content/enterprise-onboarding/support-for-your-enterprise/managing-support-entitlements.md
@@ -1,11 +1,11 @@
---
-title: 'Managing support entitlements'
-intro: 'Manage support entitlements for your enterprise.'
+title: Managing support entitlements
+intro: Manage support entitlements for your enterprise.
versions:
ghec: '*'
allowTitleToDifferFromFilename: true
-type: how_to
shortTitle: Manage support entitlements
+contentType: how-tos
---
## About support entitlements
diff --git a/content/enterprise-onboarding/support-for-your-enterprise/understanding-support.md b/content/enterprise-onboarding/support-for-your-enterprise/understanding-support.md
index fd97f60211bf..d846202d0533 100644
--- a/content/enterprise-onboarding/support-for-your-enterprise/understanding-support.md
+++ b/content/enterprise-onboarding/support-for-your-enterprise/understanding-support.md
@@ -1,11 +1,11 @@
---
-title: 'Understanding enterprise support'
+title: Understanding enterprise support
shortTitle: Understand enterprise support
-intro: 'Explore the various {% data variables.contact.github_support %} offerings available to you.'
+intro: Explore the various {% data variables.contact.github_support %} offerings available to you.
versions:
ghec: '*'
allowTitleToDifferFromFilename: true
-type: overview
+contentType: concepts
---
## About {% data variables.contact.github_support %}
diff --git a/content/enterprise-onboarding/support-for-your-enterprise/using-the-support-portal.md b/content/enterprise-onboarding/support-for-your-enterprise/using-the-support-portal.md
index 1fe365766385..39733c3c500b 100644
--- a/content/enterprise-onboarding/support-for-your-enterprise/using-the-support-portal.md
+++ b/content/enterprise-onboarding/support-for-your-enterprise/using-the-support-portal.md
@@ -1,11 +1,11 @@
---
-title: 'Using the support portal'
+title: Using the support portal
shortTitle: Support portal
-intro: 'Access the support portal for your enterprise.'
+intro: Access the support portal for your enterprise.
allowTitleToDifferFromFilename: true
versions:
ghec: '*'
-type: how_to
+contentType: how-tos
---
## About the {% data variables.contact.enterprise_portal %} for enterprises
diff --git a/content/get-started/start-your-journey/about-github-and-git.md b/content/get-started/start-your-journey/about-github-and-git.md
index 09362695c002..5aa709d4835d 100644
--- a/content/get-started/start-your-journey/about-github-and-git.md
+++ b/content/get-started/start-your-journey/about-github-and-git.md
@@ -1,16 +1,16 @@
---
title: About GitHub and Git
shortTitle: About GitHub and Git
-intro: 'You can use {% data variables.product.github %} and Git to collaborate on work.'
+intro: You can use {% data variables.product.github %} and Git to collaborate on work.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
redirect_from:
- /get-started/quickstart/about-github-and-git
category:
- Set up your account on GitHub
+contentType: concepts
---
## About {% data variables.product.github %}
diff --git a/content/get-started/start-your-journey/downloading-files-from-github.md b/content/get-started/start-your-journey/downloading-files-from-github.md
index a9bf3af9d0fe..63491d318431 100644
--- a/content/get-started/start-your-journey/downloading-files-from-github.md
+++ b/content/get-started/start-your-journey/downloading-files-from-github.md
@@ -1,16 +1,16 @@
---
title: Downloading files from GitHub
shortTitle: Download files
-intro: 'Learn how to download files from {% data variables.product.github %}, and understand the difference between downloading, cloning, and forking.'
+intro: Learn how to download files from {% data variables.product.github %}, and understand the difference between downloading, cloning, and forking.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
redirect_from:
- /get-started/quickstart/downloading-files-from-github
category:
- Explore and contribute
+contentType: tutorials
---
## Introduction
diff --git a/content/get-started/start-your-journey/hello-world.md b/content/get-started/start-your-journey/hello-world.md
index 34b4d750e599..2dd5f24613e0 100644
--- a/content/get-started/start-your-journey/hello-world.md
+++ b/content/get-started/start-your-journey/hello-world.md
@@ -1,15 +1,15 @@
---
title: Hello World
-intro: 'Follow this Hello World exercise to learn {% data variables.product.github %}''s pull request workflow.'
+intro: Follow this Hello World exercise to learn {% data variables.product.github %}'s pull request workflow.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: quick_start
redirect_from:
- /get-started/quickstart/hello-world
category:
- Explore and contribute
+contentType: get-started
---
## Introduction
diff --git a/content/get-started/start-your-journey/setting-up-your-profile.md b/content/get-started/start-your-journey/setting-up-your-profile.md
index b9130006a78c..ded61518e4c2 100644
--- a/content/get-started/start-your-journey/setting-up-your-profile.md
+++ b/content/get-started/start-your-journey/setting-up-your-profile.md
@@ -6,11 +6,11 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
redirect_from:
- /get-started/quickstart/setting-up-your-profile
category:
- Set up your account on GitHub
+contentType: how-tos
---
## About your profile
diff --git a/content/get-started/start-your-journey/uploading-a-project-to-github.md b/content/get-started/start-your-journey/uploading-a-project-to-github.md
index 8ab89c72097a..ddd9b06d48c9 100644
--- a/content/get-started/start-your-journey/uploading-a-project-to-github.md
+++ b/content/get-started/start-your-journey/uploading-a-project-to-github.md
@@ -1,16 +1,16 @@
---
title: Uploading a project to GitHub
shortTitle: Upload a project
-intro: 'Learn how to upload the files for your project to {% data variables.product.github %}.'
+intro: Learn how to upload the files for your project to {% data variables.product.github %}.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
redirect_from:
- /get-started/quickstart/uploading-a-project-to-github
category:
- Explore and contribute
+contentType: tutorials
---
## Introduction
diff --git a/content/get-started/using-git/about-git.md b/content/get-started/using-git/about-git.md
index 669905a2a9a8..dfa0ccf77492 100644
--- a/content/get-started/using-git/about-git.md
+++ b/content/get-started/using-git/about-git.md
@@ -1,13 +1,13 @@
---
title: About Git
-intro: 'Learn about the version control system, Git, and how it works with {% data variables.product.github %}.'
+intro: Learn about the version control system, Git, and how it works with {% data variables.product.github %}.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
category:
- Set up Git
+contentType: concepts
---
## About version control and Git
diff --git a/content/github-cli/github-cli/about-github-cli.md b/content/github-cli/github-cli/about-github-cli.md
index 3a3ce84cdccd..ba2907295ad5 100644
--- a/content/github-cli/github-cli/about-github-cli.md
+++ b/content/github-cli/github-cli/about-github-cli.md
@@ -5,12 +5,12 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
redirect_from:
- /github/getting-started-with-github/github-cli
- /github/getting-started-with-github/using-github/github-cli
- /actions/guides/managing-github-actions-with-github-cli
- /get-started/using-github/github-cli
+contentType: concepts
---
## About {% data variables.product.prodname_cli %}
diff --git a/content/github-cli/github-cli/github-cli-reference.md b/content/github-cli/github-cli/github-cli-reference.md
index 11b4f32340eb..f477ab98b6bd 100644
--- a/content/github-cli/github-cli/github-cli-reference.md
+++ b/content/github-cli/github-cli/github-cli-reference.md
@@ -1,11 +1,11 @@
---
title: GitHub CLI reference
-intro: 'You can view all of the {% data variables.product.prodname_cli %} commands in your terminal. The same information is available in the {% data variables.product.prodname_cli %} manual.'
+intro: You can view all of the {% data variables.product.prodname_cli %} commands in your terminal. The same information is available in the {% data variables.product.prodname_cli %} manual.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: reference
+contentType: reference
---
To view all top-level {% data variables.product.prodname_cli %} commands, enter `gh` without arguments.
diff --git a/content/github-cli/github-cli/quickstart.md b/content/github-cli/github-cli/quickstart.md
index 1efe72c7668a..a4bb4af3436a 100644
--- a/content/github-cli/github-cli/quickstart.md
+++ b/content/github-cli/github-cli/quickstart.md
@@ -1,13 +1,13 @@
---
title: GitHub CLI quickstart
-intro: 'Start using {% data variables.product.prodname_cli %} to work with {% data variables.product.company_short %} in the command line.'
+intro: Start using {% data variables.product.prodname_cli %} to work with {% data variables.product.company_short %} in the command line.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
allowTitleToDifferFromFilename: true
shortTitle: Quickstart
+contentType: concepts
---
## About {% data variables.product.prodname_cli %}
diff --git a/content/github-models/quickstart.md b/content/github-models/quickstart.md
index 5380709d9df9..14ddd568f0b5 100644
--- a/content/github-models/quickstart.md
+++ b/content/github-models/quickstart.md
@@ -1,14 +1,14 @@
---
title: Quickstart for GitHub Models
-intro: 'Run your first model with {% data variables.product.prodname_github_models %} in minutes.'
+intro: Run your first model with {% data variables.product.prodname_github_models %} in minutes.
allowTitleToDifferFromFilename: true
redirect_from:
- /models/quickstart
versions:
fpt: '*'
ghec: '*'
-type: quick_start
shortTitle: Quickstart
+contentType: get-started
---
## Introduction
diff --git a/content/github-models/responsible-use-of-github-models.md b/content/github-models/responsible-use-of-github-models.md
index b50c2a565c20..b080beb1d9c2 100644
--- a/content/github-models/responsible-use-of-github-models.md
+++ b/content/github-models/responsible-use-of-github-models.md
@@ -1,10 +1,10 @@
---
title: Responsible use of GitHub Models
shortTitle: Responsible use
-intro: 'Learn how to use {% data variables.product.prodname_github_models %} responsibly by understanding its purposes, capabilities, and limitations.'
+intro: Learn how to use {% data variables.product.prodname_github_models %} responsibly by understanding its purposes, capabilities, and limitations.
versions:
feature: github-models
-type: rai
+contentType: rai
---
With {% data variables.product.prodname_github_models %}, you build your understanding of AI model capabilities by experimenting with model settings and sending prompts through a chat interface. Additionally, you can directly interact with models through an SDK. Refer to a model's "Getting Started" tab for more information about how to use the SDK. Refer to a model’s "README" tab for more information on the model. Remember when interacting with a model you are experimenting with AI, so content mistakes are possible.
diff --git a/content/issues/organizing-your-work-with-project-boards/managing-project-boards/configuring-automation-for-project-boards.md b/content/issues/organizing-your-work-with-project-boards/managing-project-boards/configuring-automation-for-project-boards.md
index 6585e836e5ec..9b869886700f 100644
--- a/content/issues/organizing-your-work-with-project-boards/managing-project-boards/configuring-automation-for-project-boards.md
+++ b/content/issues/organizing-your-work-with-project-boards/managing-project-boards/configuring-automation-for-project-boards.md
@@ -1,6 +1,6 @@
---
-title: 'Configuring automation for {% data variables.product.prodname_projects_v1 %}'
-intro: 'You can set up automatic workflows to move issues and pull requests to a {% data variables.projects.projects_v1_board %} column when a specified event occurs.'
+title: Configuring automation for {% data variables.product.prodname_projects_v1 %}
+intro: You can set up automatic workflows to move issues and pull requests to a {% data variables.projects.projects_v1_board %} column when a specified event occurs.
redirect_from:
- /github/managing-your-work-on-github/managing-project-boards/configuring-automation-for-project-boards
- /articles/configuring-automation-for-project-boards
@@ -8,8 +8,8 @@ redirect_from:
versions:
feature: projects-v1
shortTitle: Configure automation
-type: how_to
allowTitleToDifferFromFilename: true
+contentType: how-tos
---
{% data reusables.projects.project_boards_old %}
diff --git a/content/issues/organizing-your-work-with-project-boards/managing-project-boards/creating-a-project-board.md b/content/issues/organizing-your-work-with-project-boards/managing-project-boards/creating-a-project-board.md
index 51d72bb52cf5..7cba6d7da1e4 100644
--- a/content/issues/organizing-your-work-with-project-boards/managing-project-boards/creating-a-project-board.md
+++ b/content/issues/organizing-your-work-with-project-boards/managing-project-boards/creating-a-project-board.md
@@ -1,5 +1,5 @@
---
-title: 'Creating a {% data variables.product.prodname_project_v1 %}'
+title: Creating a {% data variables.product.prodname_project_v1 %}
intro: '{% data variables.projects.projects_v1_boards_caps %} can be used to create customized workflows to suit your needs, like tracking and prioritizing specific feature work, comprehensive roadmaps, or even release checklists.'
redirect_from:
- /github/managing-your-work-on-github/managing-project-boards/creating-a-project-board
@@ -8,8 +8,8 @@ redirect_from:
- /github/managing-your-work-on-github/creating-a-project-board
versions:
feature: projects-v1-can-create
-type: how_to
allowTitleToDifferFromFilename: true
+contentType: how-tos
---
{% data reusables.projects.project_boards_old %}
diff --git a/content/issues/planning-and-tracking-with-projects/automating-your-project/adding-items-automatically.md b/content/issues/planning-and-tracking-with-projects/automating-your-project/adding-items-automatically.md
index c8065db84c8f..d83fd7ec8246 100644
--- a/content/issues/planning-and-tracking-with-projects/automating-your-project/adding-items-automatically.md
+++ b/content/issues/planning-and-tracking-with-projects/automating-your-project/adding-items-automatically.md
@@ -1,11 +1,11 @@
---
title: Adding items automatically
-intro: 'You can configure your project''s built-in workflows to automatically add items from {% ifversion projects-v2-duplicate-auto-add %}repositories{% else%}a repository{% endif %} that match a filter.'
+intro: You can configure your project's built-in workflows to automatically add items from {% ifversion projects-v2-duplicate-auto-add %}repositories{% else%}a repository{% endif %} that match a filter.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
---
{% ifversion ghes %}
diff --git a/content/issues/planning-and-tracking-with-projects/automating-your-project/archiving-items-automatically.md b/content/issues/planning-and-tracking-with-projects/automating-your-project/archiving-items-automatically.md
index 2ffbcd6b782e..1345ef007a7a 100644
--- a/content/issues/planning-and-tracking-with-projects/automating-your-project/archiving-items-automatically.md
+++ b/content/issues/planning-and-tracking-with-projects/automating-your-project/archiving-items-automatically.md
@@ -6,7 +6,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
---
{% ifversion ghes %}
diff --git a/content/issues/planning-and-tracking-with-projects/automating-your-project/automating-projects-using-actions.md b/content/issues/planning-and-tracking-with-projects/automating-your-project/automating-projects-using-actions.md
index d05f973a8e76..37138d530799 100644
--- a/content/issues/planning-and-tracking-with-projects/automating-your-project/automating-projects-using-actions.md
+++ b/content/issues/planning-and-tracking-with-projects/automating-your-project/automating-projects-using-actions.md
@@ -1,16 +1,16 @@
---
-title: 'Automating {% data variables.product.prodname_projects_v2 %} using Actions'
+title: Automating {% data variables.product.prodname_projects_v2 %} using Actions
shortTitle: Automating with Actions
-intro: 'You can use {% data variables.product.prodname_actions %} to automate your projects.'
+intro: You can use {% data variables.product.prodname_actions %} to automate your projects.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
redirect_from:
- /issues/trying-out-the-new-projects-experience/automating-projects
-type: tutorial
allowTitleToDifferFromFilename: true
layout: inline
+contentType: tutorials
---
diff --git a/content/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects.md b/content/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects.md
index 7f01e4cc0eeb..1ed57268f3a3 100644
--- a/content/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects.md
+++ b/content/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects.md
@@ -1,5 +1,5 @@
---
-title: 'Using the API to manage {% data variables.product.prodname_projects_v2 %}'
+title: Using the API to manage {% data variables.product.prodname_projects_v2 %}
shortTitle: Automating with the API
intro: You can use the GraphQL API to automate your projects.
versions:
@@ -8,8 +8,8 @@ versions:
ghes: '*'
redirect_from:
- /issues/trying-out-the-new-projects-experience/using-the-api-to-manage-projects
-type: tutorial
allowTitleToDifferFromFilename: true
+contentType: tutorials
---
This article demonstrates how to use the GraphQL API to manage a project. For more information about how to use the API in a {% data variables.product.prodname_actions %} workflow, see [AUTOTITLE](/issues/planning-and-tracking-with-projects/automating-your-project/automating-projects-using-actions). For a full list of the available data types, see [AUTOTITLE](/graphql/reference).
diff --git a/content/issues/planning-and-tracking-with-projects/automating-your-project/using-the-built-in-automations.md b/content/issues/planning-and-tracking-with-projects/automating-your-project/using-the-built-in-automations.md
index 6ee421f166f9..8893850164b4 100644
--- a/content/issues/planning-and-tracking-with-projects/automating-your-project/using-the-built-in-automations.md
+++ b/content/issues/planning-and-tracking-with-projects/automating-your-project/using-the-built-in-automations.md
@@ -6,7 +6,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
---
diff --git a/content/issues/planning-and-tracking-with-projects/creating-projects/copying-an-existing-project.md b/content/issues/planning-and-tracking-with-projects/creating-projects/copying-an-existing-project.md
index 8951f76db3c6..6a23cfe9d8c3 100644
--- a/content/issues/planning-and-tracking-with-projects/creating-projects/copying-an-existing-project.md
+++ b/content/issues/planning-and-tracking-with-projects/creating-projects/copying-an-existing-project.md
@@ -1,13 +1,13 @@
---
-title: 'Copying an existing {% data variables.projects.project_v2 %}'
+title: Copying an existing {% data variables.projects.project_v2 %}
shortTitle: Copying a project
intro: You can use an existing project as a template by copying it.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
allowTitleToDifferFromFilename: true
+contentType: tutorials
---
## About copying projects
diff --git a/content/issues/planning-and-tracking-with-projects/creating-projects/creating-a-project.md b/content/issues/planning-and-tracking-with-projects/creating-projects/creating-a-project.md
index 06df45e5aeef..4ae3f2915841 100644
--- a/content/issues/planning-and-tracking-with-projects/creating-projects/creating-a-project.md
+++ b/content/issues/planning-and-tracking-with-projects/creating-projects/creating-a-project.md
@@ -1,5 +1,5 @@
---
-title: 'Creating a {% data variables.projects.project_v2 %}'
+title: Creating a {% data variables.projects.project_v2 %}
intro: Learn how to create an organization or user project.
versions:
fpt: '*'
@@ -7,8 +7,8 @@ versions:
ghes: '*'
redirect_from:
- /issues/trying-out-the-new-projects-experience/creating-a-project
-type: tutorial
allowTitleToDifferFromFilename: true
+contentType: tutorials
---
{% data variables.product.prodname_projects_v2 %} are an adaptable collection of items that stay up-to-date with {% data variables.product.company_short %} data. Your projects can track issues, pull requests, and ideas that you note down. You can add custom fields and create views for specific purposes.
diff --git a/content/issues/planning-and-tracking-with-projects/creating-projects/migrating-from-projects-classic.md b/content/issues/planning-and-tracking-with-projects/creating-projects/migrating-from-projects-classic.md
index 83bf655c9637..ec4ca96b5800 100644
--- a/content/issues/planning-and-tracking-with-projects/creating-projects/migrating-from-projects-classic.md
+++ b/content/issues/planning-and-tracking-with-projects/creating-projects/migrating-from-projects-classic.md
@@ -1,12 +1,12 @@
---
-title: 'Migrating from {% data variables.product.prodname_projects_v1 %}'
-intro: 'You can migrate your {% data variables.projects.projects_v1_board %} to the new {% data variables.product.prodname_projects_v2 %} experience.'
+title: Migrating from {% data variables.product.prodname_projects_v1 %}
+intro: You can migrate your {% data variables.projects.projects_v1_board %} to the new {% data variables.product.prodname_projects_v2 %} experience.
versions:
feature: projects-v2-migration
redirect_from:
- /issues/trying-out-the-new-projects-experience/migrating-your-project
-type: tutorial
allowTitleToDifferFromFilename: true
+contentType: tutorials
---
> [!NOTE]
diff --git a/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/changing-the-layout-of-a-view.md b/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/changing-the-layout-of-a-view.md
index 5050677f48be..e08f6407eb2d 100644
--- a/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/changing-the-layout-of-a-view.md
+++ b/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/changing-the-layout-of-a-view.md
@@ -1,7 +1,7 @@
---
title: Changing the layout of a view
shortTitle: Changing the layout
-intro: 'You can view your project as a high-density table, as a kanban board, or as a timeline-style roadmap.'
+intro: You can view your project as a high-density table, as a kanban board, or as a timeline-style roadmap.
versions:
fpt: '*'
ghec: '*'
@@ -9,7 +9,7 @@ versions:
redirect_from:
- /issues/trying-out-the-new-projects-experience/customizing-your-project-views
- /issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-a-view
-type: tutorial
+contentType: tutorials
---
## About the table layout
diff --git a/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-board-layout.md b/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-board-layout.md
index 4a05f8ddbf4b..f9b300185042 100644
--- a/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-board-layout.md
+++ b/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-board-layout.md
@@ -6,7 +6,7 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
+contentType: tutorials
---
## About the board layout
diff --git a/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-roadmap-layout.md b/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-roadmap-layout.md
index 4f6ef4c56643..c0e457c076b7 100644
--- a/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-roadmap-layout.md
+++ b/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-roadmap-layout.md
@@ -6,7 +6,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
---
## About the roadmap layout
diff --git a/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-table-layout.md b/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-table-layout.md
index 658d5b4a7159..6883159e63ca 100644
--- a/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-table-layout.md
+++ b/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-table-layout.md
@@ -1,12 +1,12 @@
---
title: Customizing the table layout
shortTitle: Customizing tables
-intro: 'You can use the table layout to build a spreadsheet using your project''s items, {% data variables.product.company_short %} metadata, and your custom fields.'
+intro: You can use the table layout to build a spreadsheet using your project's items, {% data variables.product.company_short %} metadata, and your custom fields.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
+contentType: tutorials
---
## About the table layout
diff --git a/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects.md b/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects.md
index 926bdb63f46c..f65edf29c12d 100644
--- a/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects.md
+++ b/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects.md
@@ -1,5 +1,5 @@
---
-title: 'Filtering {% data variables.projects.projects_v2 %}'
+title: Filtering {% data variables.projects.projects_v2 %}
intro: Use filters to choose which items appear in your project's views.
versions:
fpt: '*'
@@ -7,8 +7,8 @@ versions:
ghes: '*'
redirect_from:
- /issues/trying-out-the-new-projects-experience/filtering-projects
-type: tutorial
allowTitleToDifferFromFilename: true
+contentType: tutorials
---
You can customize which items appear in your views using filters for item metadata, such as assignees and the labels applied to issues, and by the fields in your project. You can combine filters and save them as views. For more information, see [AUTOTITLE](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/managing-your-views).
diff --git a/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/managing-your-views.md b/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/managing-your-views.md
index 2d11b4d9f415..7c02b73101be 100644
--- a/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/managing-your-views.md
+++ b/content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/managing-your-views.md
@@ -1,11 +1,11 @@
---
title: Managing your views
-intro: 'Learn how to create, save, and manage your project views.'
+intro: Learn how to create, save, and manage your project views.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
+contentType: tutorials
---
diff --git a/content/issues/planning-and-tracking-with-projects/finding-your-projects.md b/content/issues/planning-and-tracking-with-projects/finding-your-projects.md
index 6f042c777987..374ce85fea9d 100644
--- a/content/issues/planning-and-tracking-with-projects/finding-your-projects.md
+++ b/content/issues/planning-and-tracking-with-projects/finding-your-projects.md
@@ -1,6 +1,6 @@
---
-title: 'Finding your {% data variables.projects.projects_v2 %}'
-intro: 'Learn how to locate projects in your account, organizations, repositories, and teams.'
+title: Finding your {% data variables.projects.projects_v2 %}
+intro: Learn how to locate projects in your account, organizations, repositories, and teams.
redirect_from:
- /issues/planning-and-tracking-with-projects/learning-about-projects/finding-your-projects
allowTitleToDifferFromFilename: true
@@ -8,7 +8,7 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: overview
+contentType: concepts
---
## Browsing all of your projects
diff --git a/content/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects.md b/content/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects.md
index 34bf91c5401c..3cc81eb660ca 100644
--- a/content/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects.md
+++ b/content/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects.md
@@ -1,5 +1,5 @@
---
-title: 'About {% data variables.product.prodname_projects_v2 %}'
+title: About {% data variables.product.prodname_projects_v2 %}
intro: '{% data variables.product.prodname_projects_v2 %} is an adaptable, flexible tool for planning and tracking work on {% data variables.product.company_short %}.'
allowTitleToDifferFromFilename: true
versions:
@@ -8,7 +8,7 @@ versions:
ghes: '*'
redirect_from:
- /issues/trying-out-the-new-projects-experience/about-projects
-type: overview
+contentType: concepts
---
## About {% data variables.product.prodname_projects_v2 %}
diff --git a/content/issues/planning-and-tracking-with-projects/learning-about-projects/best-practices-for-projects.md b/content/issues/planning-and-tracking-with-projects/learning-about-projects/best-practices-for-projects.md
index 2af828f39adc..63b4bbba6f52 100644
--- a/content/issues/planning-and-tracking-with-projects/learning-about-projects/best-practices-for-projects.md
+++ b/content/issues/planning-and-tracking-with-projects/learning-about-projects/best-practices-for-projects.md
@@ -1,5 +1,5 @@
---
-title: 'Best practices for {% data variables.product.prodname_projects_v2 %}'
+title: Best practices for {% data variables.product.prodname_projects_v2 %}
intro: Learn tips for managing your projects.
allowTitleToDifferFromFilename: true
versions:
@@ -8,7 +8,7 @@ versions:
ghes: '*'
redirect_from:
- /issues/trying-out-the-new-projects-experience/best-practices-for-managing-projects
-type: overview
+contentType: concepts
---
You can use {% data variables.product.prodname_projects_v2 %} to manage your work on {% data variables.product.company_short %}, where your issues and pull requests live. Read on for tips to manage your projects efficiently and effectively. For more information about {% data variables.product.prodname_projects_v2 %}, see [AUTOTITLE](/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects).
diff --git a/content/issues/planning-and-tracking-with-projects/learning-about-projects/quickstart-for-projects.md b/content/issues/planning-and-tracking-with-projects/learning-about-projects/quickstart-for-projects.md
index 8bc47bcc8c48..28b97888af1c 100644
--- a/content/issues/planning-and-tracking-with-projects/learning-about-projects/quickstart-for-projects.md
+++ b/content/issues/planning-and-tracking-with-projects/learning-about-projects/quickstart-for-projects.md
@@ -1,6 +1,6 @@
---
-title: 'Quickstart for {% data variables.product.prodname_projects_v2 %}'
-intro: 'Experience the speed, flexibility, and customization of {% data variables.product.prodname_projects_v2 %} by creating a project in this interactive guide.'
+title: Quickstart for {% data variables.product.prodname_projects_v2 %}
+intro: Experience the speed, flexibility, and customization of {% data variables.product.prodname_projects_v2 %} by creating a project in this interactive guide.
allowTitleToDifferFromFilename: true
versions:
fpt: '*'
@@ -8,7 +8,7 @@ versions:
ghes: '*'
redirect_from:
- /issues/trying-out-the-new-projects-experience/quickstart
-type: quick_start
+contentType: get-started
---
## Introduction
diff --git a/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project.md b/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project.md
index 8437afbe43f6..564545364bf4 100644
--- a/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project.md
+++ b/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project.md
@@ -1,13 +1,13 @@
---
-title: 'Adding items to your {% data variables.projects.project_v2 %}'
+title: Adding items to your {% data variables.projects.project_v2 %}
shortTitle: Adding items
-intro: 'Learn how to add pull requests, issues, and draft issues to your projects individually or in bulk.'
+intro: Learn how to add pull requests, issues, and draft issues to your projects individually or in bulk.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
allowTitleToDifferFromFilename: true
+contentType: tutorials
---
> [!NOTE]
diff --git a/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/archiving-items-from-your-project.md b/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/archiving-items-from-your-project.md
index f6b5a72ea79c..99bb7e04da03 100644
--- a/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/archiving-items-from-your-project.md
+++ b/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/archiving-items-from-your-project.md
@@ -1,13 +1,13 @@
---
-title: 'Archiving items from your {% data variables.projects.project_v2 %}'
+title: Archiving items from your {% data variables.projects.project_v2 %}
shortTitle: Archiving items
-intro: 'You can archive items, keeping them available to restore, or permanently delete them.'
+intro: You can archive items, keeping them available to restore, or permanently delete them.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
allowTitleToDifferFromFilename: true
+contentType: tutorials
---
> [!NOTE]
diff --git a/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/converting-draft-issues-to-issues.md b/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/converting-draft-issues-to-issues.md
index af37850da90f..80d79dd9a67d 100644
--- a/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/converting-draft-issues-to-issues.md
+++ b/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/converting-draft-issues-to-issues.md
@@ -6,7 +6,7 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
+contentType: tutorials
---
## Converting draft issues in table layout
diff --git a/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/editing-items-in-your-project.md b/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/editing-items-in-your-project.md
index e00210f0e796..c1d731bac2a3 100644
--- a/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/editing-items-in-your-project.md
+++ b/content/issues/planning-and-tracking-with-projects/managing-items-in-your-project/editing-items-in-your-project.md
@@ -1,13 +1,13 @@
---
-title: 'Editing items in your {% data variables.projects.project_v2 %}'
+title: Editing items in your {% data variables.projects.project_v2 %}
shortTitle: Editing items
-intro: 'There are several methods you can use within your {% data variables.projects.project_v2 %} to quickly make changes to multiple items.'
+intro: There are several methods you can use within your {% data variables.projects.project_v2 %} to quickly make changes to multiple items.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
allowTitleToDifferFromFilename: true
+contentType: tutorials
---
## Copying and pasting cells in a table
diff --git a/content/issues/planning-and-tracking-with-projects/managing-your-project/adding-your-project-to-a-repository.md b/content/issues/planning-and-tracking-with-projects/managing-your-project/adding-your-project-to-a-repository.md
index ec95e99f6728..365b979df390 100644
--- a/content/issues/planning-and-tracking-with-projects/managing-your-project/adding-your-project-to-a-repository.md
+++ b/content/issues/planning-and-tracking-with-projects/managing-your-project/adding-your-project-to-a-repository.md
@@ -1,13 +1,13 @@
---
-title: 'Adding your {% data variables.projects.project_v2 %} to a repository'
-shortTitle: 'Adding a {% data variables.projects.project_v2 %} to a repo'
-intro: 'You can add your {% data variables.projects.project_v2 %} to a repository to make it accessible from that repository.'
+title: Adding your {% data variables.projects.project_v2 %} to a repository
+shortTitle: Adding a {% data variables.projects.project_v2 %} to a repo
+intro: You can add your {% data variables.projects.project_v2 %} to a repository to make it accessible from that repository.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
allowTitleToDifferFromFilename: true
+contentType: tutorials
---
## Linking a repository to your project
diff --git a/content/issues/planning-and-tracking-with-projects/managing-your-project/adding-your-project-to-a-team.md b/content/issues/planning-and-tracking-with-projects/managing-your-project/adding-your-project-to-a-team.md
index 64ec03aa2efe..1b6e96594bc0 100644
--- a/content/issues/planning-and-tracking-with-projects/managing-your-project/adding-your-project-to-a-team.md
+++ b/content/issues/planning-and-tracking-with-projects/managing-your-project/adding-your-project-to-a-team.md
@@ -1,14 +1,14 @@
---
-title: 'Adding your {% data variables.projects.project_v2 %} to a team'
-shortTitle: 'Adding a {% data variables.projects.project_v2 %} to a team'
+title: Adding your {% data variables.projects.project_v2 %} to a team
+shortTitle: Adding a {% data variables.projects.project_v2 %} to a team
intro: You can add projects to teams to manage permissions and improve project discoverability.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
allowTitleToDifferFromFilename: true
permissions: Organization owners or people with the team maintainer role and admin permissions on a project can add a project to a team.
+contentType: tutorials
---
## About adding projects to teams
diff --git a/content/issues/planning-and-tracking-with-projects/managing-your-project/closing-and-deleting-your-projects.md b/content/issues/planning-and-tracking-with-projects/managing-your-project/closing-and-deleting-your-projects.md
index d0670ef960b2..9444bcd21859 100644
--- a/content/issues/planning-and-tracking-with-projects/managing-your-project/closing-and-deleting-your-projects.md
+++ b/content/issues/planning-and-tracking-with-projects/managing-your-project/closing-and-deleting-your-projects.md
@@ -1,15 +1,15 @@
---
-title: 'Closing and deleting your {% data variables.projects.projects_v2 %}'
-shortTitle: 'Closing and deleting {% data variables.projects.projects_v2 %}'
-intro: 'Learn about closing, re-opening, and permanently deleting a {% data variables.projects.project_v2 %}.'
+title: Closing and deleting your {% data variables.projects.projects_v2 %}
+shortTitle: Closing and deleting {% data variables.projects.projects_v2 %}
+intro: Learn about closing, re-opening, and permanently deleting a {% data variables.projects.project_v2 %}.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
redirect_from:
- /issues/trying-out-the-new-projects-experience/managing-projects
-type: tutorial
allowTitleToDifferFromFilename: true
+contentType: tutorials
---
diff --git a/content/issues/planning-and-tracking-with-projects/managing-your-project/exporting-your-projects-data.md b/content/issues/planning-and-tracking-with-projects/managing-your-project/exporting-your-projects-data.md
index e10969b26954..732f7125696d 100644
--- a/content/issues/planning-and-tracking-with-projects/managing-your-project/exporting-your-projects-data.md
+++ b/content/issues/planning-and-tracking-with-projects/managing-your-project/exporting-your-projects-data.md
@@ -1,14 +1,14 @@
---
-title: 'Exporting your {% data variables.projects.project_v2 %} data'
-shortTitle: 'Exporting your {% data variables.projects.project_v2 %} data'
-intro: 'Learn about exporting your {% data variables.projects.project_v2 %} data.'
-permissions: 'People who can access a project can export a view. For more information, see [AUTOTITLE](/issues/planning-and-tracking-with-projects/managing-your-project/managing-visibility-of-your-projects) and [AUTOTITLE](/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects).'
+title: Exporting your {% data variables.projects.project_v2 %} data
+shortTitle: Exporting your {% data variables.projects.project_v2 %} data
+intro: Learn about exporting your {% data variables.projects.project_v2 %} data.
+permissions: People who can access a project can export a view. For more information, see [AUTOTITLE](/issues/planning-and-tracking-with-projects/managing-your-project/managing-visibility-of-your-projects) and [AUTOTITLE](/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects).
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
allowTitleToDifferFromFilename: true
+contentType: tutorials
---
You can download a view as a _.tsv_ (tab-separated) file.
diff --git a/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects.md b/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects.md
index e5a562132bc8..bd96925edaee 100644
--- a/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects.md
+++ b/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects.md
@@ -1,15 +1,15 @@
---
-title: 'Managing access to your {% data variables.projects.projects_v2 %}'
-shortTitle: 'Managing {% data variables.projects.project_v2 %} access'
-intro: 'Learn how to manage team and individual access to your {% data variables.projects.project_v2 %}.'
+title: Managing access to your {% data variables.projects.projects_v2 %}
+shortTitle: Managing {% data variables.projects.project_v2 %} access
+intro: Learn how to manage team and individual access to your {% data variables.projects.project_v2 %}.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
redirect_from:
- /issues/trying-out-the-new-projects-experience/managing-access-to-projects
-type: tutorial
allowTitleToDifferFromFilename: true
+contentType: tutorials
---
diff --git a/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-project-templates-in-your-organization.md b/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-project-templates-in-your-organization.md
index 00a331230898..8c3d07f46d71 100644
--- a/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-project-templates-in-your-organization.md
+++ b/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-project-templates-in-your-organization.md
@@ -1,14 +1,14 @@
---
-title: 'Managing {% data variables.projects.project_v2 %} templates in your organization'
-shortTitle: 'Managing templates'
-intro: 'You can create templates or set projects as templates in your organization, allowing other people to select your template as the base for projects they create.'
+title: Managing {% data variables.projects.project_v2 %} templates in your organization
+shortTitle: Managing templates
+intro: You can create templates or set projects as templates in your organization, allowing other people to select your template as the base for projects they create.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
-permissions: 'People with admin permissions for a project in an organization can set the project as a template. People with admin or write permissions for a project in an organization can copy the project and set the copied project as a template.'
+permissions: People with admin permissions for a project in an organization can set the project as a template. People with admin or write permissions for a project in an organization can copy the project and set the copied project as a template.
allowTitleToDifferFromFilename: true
+contentType: tutorials
---
diff --git a/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-visibility-of-your-projects.md b/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-visibility-of-your-projects.md
index a3dedd112435..bed86821f1f0 100644
--- a/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-visibility-of-your-projects.md
+++ b/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-visibility-of-your-projects.md
@@ -1,16 +1,16 @@
---
-title: 'Managing visibility of your {% data variables.projects.projects_v2 %}'
-shortTitle: 'Managing {% data variables.projects.project_v2 %} visibility'
-intro: 'Learn about setting your {% data variables.projects.project_v2 %} to private or public visibility.'
+title: Managing visibility of your {% data variables.projects.projects_v2 %}
+shortTitle: Managing {% data variables.projects.project_v2 %} visibility
+intro: Learn about setting your {% data variables.projects.project_v2 %} to private or public visibility.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
redirect_from:
- /issues/trying-out-the-new-projects-experience/managing-the-visibility-of-your-projects
-type: tutorial
allowTitleToDifferFromFilename: true
-permissions: 'Organization owners can manage the visibility of {% data variables.projects.projects_v2 %} in their organization. Organization owners can also allow collaborators with admin permissions to manage project visibility. Visibility of user projects can be managed by the owner of the project and collaborators with admin permissions.'
+permissions: Organization owners can manage the visibility of {% data variables.projects.projects_v2 %} in their organization. Organization owners can also allow collaborators with admin permissions to manage project visibility. Visibility of user projects can be managed by the owner of the project and collaborators with admin permissions.
+contentType: tutorials
---
## About project visibility
diff --git a/content/issues/planning-and-tracking-with-projects/sharing-project-updates.md b/content/issues/planning-and-tracking-with-projects/sharing-project-updates.md
index 7dfe1c82b41a..45c11aef73ec 100644
--- a/content/issues/planning-and-tracking-with-projects/sharing-project-updates.md
+++ b/content/issues/planning-and-tracking-with-projects/sharing-project-updates.md
@@ -1,6 +1,6 @@
---
-title: 'Sharing {% data variables.projects.project_v2 %} updates'
-intro: 'You can post updates to your {% data variables.projects.projects_v2 %} that share the current status, start date, and target date of the {% data variables.projects.project_v2 %} itself.'
+title: Sharing {% data variables.projects.project_v2 %} updates
+intro: You can post updates to your {% data variables.projects.projects_v2 %} that share the current status, start date, and target date of the {% data variables.projects.project_v2 %} itself.
redirect_from:
- /issues/planning-and-tracking-with-projects/learning-about-projects/sharing-project-updates
allowTitleToDifferFromFilename: true
@@ -8,8 +8,8 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: overview
permissions: Anyone with write access for a project can add a status update. Anyone with read access for a project can view status updates and subscribe.
+contentType: concepts
---
## About status updates
diff --git a/content/issues/planning-and-tracking-with-projects/understanding-fields/about-date-fields.md b/content/issues/planning-and-tracking-with-projects/understanding-fields/about-date-fields.md
index 7d412ac557a1..575316fcf320 100644
--- a/content/issues/planning-and-tracking-with-projects/understanding-fields/about-date-fields.md
+++ b/content/issues/planning-and-tracking-with-projects/understanding-fields/about-date-fields.md
@@ -6,9 +6,9 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
redirect_from:
- /issues/planning-and-tracking-with-projects/understanding-field-types/about-date-fields
+contentType: tutorials
---
You can filter for date values using the `YYYY-MM-DD` format, for example: `date:2022-07-01`. You can also use operators, such as `>`, `>=`, `<`, `<=`, and `..`. For example, `date:>2022-07-01` and `date:2022-07-01..2022-07-31`. You can also provide `@today` to represent the current day in your filter. For more information, see [AUTOTITLE](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects).
diff --git a/content/issues/planning-and-tracking-with-projects/understanding-fields/about-issue-fields.md b/content/issues/planning-and-tracking-with-projects/understanding-fields/about-issue-fields.md
index 4071889fa0e0..486979c4b342 100644
--- a/content/issues/planning-and-tracking-with-projects/understanding-fields/about-issue-fields.md
+++ b/content/issues/planning-and-tracking-with-projects/understanding-fields/about-issue-fields.md
@@ -4,7 +4,7 @@ shortTitle: About issue fields
intro: 'Learn how to use organization-level issue fields in your projects to track structured metadata like priority, effort, and dates.'
versions:
feature: issue-fields
-type: tutorial
+contentType: tutorials
topics:
- Projects
- Issues
diff --git a/content/issues/planning-and-tracking-with-projects/understanding-fields/about-iteration-fields.md b/content/issues/planning-and-tracking-with-projects/understanding-fields/about-iteration-fields.md
index 46c02e5d0cad..c23a3b522f7b 100644
--- a/content/issues/planning-and-tracking-with-projects/understanding-fields/about-iteration-fields.md
+++ b/content/issues/planning-and-tracking-with-projects/understanding-fields/about-iteration-fields.md
@@ -9,7 +9,7 @@ versions:
redirect_from:
- /issues/trying-out-the-new-projects-experience/managing-iterations
- /issues/planning-and-tracking-with-projects/understanding-field-types/about-iteration-fields
-type: tutorial
+contentType: tutorials
---
You can create an iteration field to associate items with specific repeating blocks of time. Iterations can be set to any length of time, can include breaks, and can be individually edited to modify name and date range. With projects, you can group by iteration to visualize the balance of upcoming work, use filters to focus on a single iteration, and sort by iteration.
diff --git a/content/issues/planning-and-tracking-with-projects/understanding-fields/about-parent-issue-and-sub-issue-progress-fields.md b/content/issues/planning-and-tracking-with-projects/understanding-fields/about-parent-issue-and-sub-issue-progress-fields.md
index 481c64dba242..b3f1f038906b 100644
--- a/content/issues/planning-and-tracking-with-projects/understanding-fields/about-parent-issue-and-sub-issue-progress-fields.md
+++ b/content/issues/planning-and-tracking-with-projects/understanding-fields/about-parent-issue-and-sub-issue-progress-fields.md
@@ -1,10 +1,10 @@
---
title: About parent issue and sub-issue progress fields
shortTitle: About sub-issue fields
-intro: 'You can show an issue''s parent issue and view sub-issue progress in your projects.'
+intro: You can show an issue's parent issue and view sub-issue progress in your projects.
versions:
feature: sub-issues
-type: tutorial
+contentType: tutorials
---
If your organization uses sub-issues, you can enable the "Parent issue" and "Sub-issue progress" fields on your projects to see the relationships between your issues and the progress made on those issues.
diff --git a/content/issues/planning-and-tracking-with-projects/understanding-fields/about-pull-request-fields.md b/content/issues/planning-and-tracking-with-projects/understanding-fields/about-pull-request-fields.md
index 2d39bdcae724..b1bb790facf2 100644
--- a/content/issues/planning-and-tracking-with-projects/understanding-fields/about-pull-request-fields.md
+++ b/content/issues/planning-and-tracking-with-projects/understanding-fields/about-pull-request-fields.md
@@ -1,11 +1,11 @@
---
title: About pull request fields
shortTitle: About pull request fields
-intro: 'You can show a linked pull request and the pull request reviewers in your projects.'
+intro: You can show a linked pull request and the pull request reviewers in your projects.
versions:
fpt: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
---
You can enable the "Linked pull requests" and "Reviewers" fields on your projects to see information about a pull request, making a project the way to plan and track your issues, pull request, and code.
diff --git a/content/issues/planning-and-tracking-with-projects/understanding-fields/about-single-select-fields.md b/content/issues/planning-and-tracking-with-projects/understanding-fields/about-single-select-fields.md
index 5ce5799a1776..7e869f072706 100644
--- a/content/issues/planning-and-tracking-with-projects/understanding-fields/about-single-select-fields.md
+++ b/content/issues/planning-and-tracking-with-projects/understanding-fields/about-single-select-fields.md
@@ -1,14 +1,14 @@
---
title: About single select fields
shortTitle: About single select fields
-intro: 'You can create single select fields with multiple options, each with a description and a color, that can be selected from a dropdown menu.'
+intro: You can create single select fields with multiple options, each with a description and a color, that can be selected from a dropdown menu.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
redirect_from:
- /issues/planning-and-tracking-with-projects/understanding-field-types/about-single-select-fields
+contentType: tutorials
---
You can filter by your single select fields by specifying the option, for example: `fieldname:option`. You can filter for multiple values by providing a comma-separated list of options, for example: `fieldname:option,option`. For more information, see [AUTOTITLE](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects).
diff --git a/content/issues/planning-and-tracking-with-projects/understanding-fields/about-text-and-number-fields.md b/content/issues/planning-and-tracking-with-projects/understanding-fields/about-text-and-number-fields.md
index 1e3d87eba85a..7c63d99d402b 100644
--- a/content/issues/planning-and-tracking-with-projects/understanding-fields/about-text-and-number-fields.md
+++ b/content/issues/planning-and-tracking-with-projects/understanding-fields/about-text-and-number-fields.md
@@ -6,9 +6,9 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
redirect_from:
- /issues/planning-and-tracking-with-projects/understanding-field-types/about-text-and-number-fields
+contentType: tutorials
---
You can use text fields to include notes or any other freeform text in your project.
diff --git a/content/issues/planning-and-tracking-with-projects/understanding-fields/about-the-issue-type-field.md b/content/issues/planning-and-tracking-with-projects/understanding-fields/about-the-issue-type-field.md
index 11aa7704328d..c43601482ef9 100644
--- a/content/issues/planning-and-tracking-with-projects/understanding-fields/about-the-issue-type-field.md
+++ b/content/issues/planning-and-tracking-with-projects/understanding-fields/about-the-issue-type-field.md
@@ -1,10 +1,10 @@
---
title: About the issue type field
shortTitle: About the issue type field
-intro: 'You can show the type of the issue in your projects.'
+intro: You can show the type of the issue in your projects.
versions:
feature: issue-types
-type: tutorial
+contentType: tutorials
---
If your organization uses issue types, you can enable the "Type" field on your projects to see the issue type and how the issue is classified in your organization, such as a bug, task, or feature.
diff --git a/content/issues/planning-and-tracking-with-projects/understanding-fields/deleting-custom-fields.md b/content/issues/planning-and-tracking-with-projects/understanding-fields/deleting-custom-fields.md
index 4fa862270944..ebfd1361ab81 100644
--- a/content/issues/planning-and-tracking-with-projects/understanding-fields/deleting-custom-fields.md
+++ b/content/issues/planning-and-tracking-with-projects/understanding-fields/deleting-custom-fields.md
@@ -1,13 +1,13 @@
---
title: Deleting custom fields
-intro: 'Learn how to delete a custom field from your {% data variables.projects.project_v2 %}.'
+intro: Learn how to delete a custom field from your {% data variables.projects.project_v2 %}.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
redirect_from:
- /issues/planning-and-tracking-with-projects/understanding-field-types/deleting-fields
+contentType: tutorials
---
{% data reusables.projects.project-settings %}
diff --git a/content/issues/planning-and-tracking-with-projects/understanding-fields/renaming-custom-fields.md b/content/issues/planning-and-tracking-with-projects/understanding-fields/renaming-custom-fields.md
index f2bed66a4b5c..7d433799e504 100644
--- a/content/issues/planning-and-tracking-with-projects/understanding-fields/renaming-custom-fields.md
+++ b/content/issues/planning-and-tracking-with-projects/understanding-fields/renaming-custom-fields.md
@@ -1,13 +1,13 @@
---
title: Renaming custom fields
-intro: 'Learn about renaming existing custom fields in your {% data variables.projects.project_v2 %}.'
+intro: Learn about renaming existing custom fields in your {% data variables.projects.project_v2 %}.
versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
redirect_from:
- /issues/planning-and-tracking-with-projects/understanding-field-types/renaming-fields
+contentType: tutorials
---
{% data reusables.projects.project-settings %}
diff --git a/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects.md b/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects.md
index 067a7caaba63..f9cbbac9d348 100644
--- a/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects.md
+++ b/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects.md
@@ -1,5 +1,5 @@
---
-title: 'About insights for {% data variables.product.prodname_projects_v2 %}'
+title: About insights for {% data variables.product.prodname_projects_v2 %}
intro: You can view and customize charts that are built from your project's data.
versions:
fpt: '*'
@@ -7,8 +7,8 @@ versions:
ghes: '*'
redirect_from:
- /issues/trying-out-the-new-projects-experience/using-insights-with-projects
-type: tutorial
allowTitleToDifferFromFilename: true
+contentType: tutorials
---
You can use insights for {% data variables.product.prodname_projects_v2 %} to view, create, and customize charts that use the items added to your project as their source data. You can apply filters to the default chart and also create your own charts. When you create a chart, you set the filters, chart type, the information displayed, and the chart is available to anyone that can view the project. You can generate two types of chart: current charts and historical charts.
diff --git a/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/configuring-charts.md b/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/configuring-charts.md
index fd66e8c1532e..3a710a9bf44d 100644
--- a/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/configuring-charts.md
+++ b/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/configuring-charts.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
+contentType: tutorials
---
{% data reusables.projects.access-insights %}
diff --git a/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/creating-charts.md b/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/creating-charts.md
index 60cd5400b146..3f89c479015f 100644
--- a/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/creating-charts.md
+++ b/content/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/creating-charts.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: tutorial
+contentType: tutorials
---
{% data reusables.projects.access-insights %}
diff --git a/content/issues/tracking-your-work-with-issues/learning-about-issues/planning-and-tracking-work-for-your-team-or-project.md b/content/issues/tracking-your-work-with-issues/learning-about-issues/planning-and-tracking-work-for-your-team-or-project.md
index 3d00b9cde9b5..36562a0a1441 100644
--- a/content/issues/tracking-your-work-with-issues/learning-about-issues/planning-and-tracking-work-for-your-team-or-project.md
+++ b/content/issues/tracking-your-work-with-issues/learning-about-issues/planning-and-tracking-work-for-your-team-or-project.md
@@ -1,14 +1,14 @@
---
title: Planning and tracking work for your team or project
-intro: 'The essentials for using {% data variables.product.prodname_dotcom %}''s planning and tracking tools to manage work on a team or project.'
+intro: The essentials for using {% data variables.product.prodname_dotcom %}'s planning and tracking tools to manage work on a team or project.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
redirect_from:
- /issues/tracking-your-work-with-issues/planning-and-tracking-work-for-your-team-or-project
- /issues/tracking-your-work-with-issues/configuring-issues/planning-and-tracking-work-for-your-team-or-project
+contentType: concepts
---
## Introduction
diff --git a/content/issues/tracking-your-work-with-issues/learning-about-issues/quickstart.md b/content/issues/tracking-your-work-with-issues/learning-about-issues/quickstart.md
index 7cd11c1c9c1e..c20e6e755a4f 100644
--- a/content/issues/tracking-your-work-with-issues/learning-about-issues/quickstart.md
+++ b/content/issues/tracking-your-work-with-issues/learning-about-issues/quickstart.md
@@ -1,15 +1,15 @@
---
title: Quickstart for GitHub Issues
-intro: 'Follow this brief interactive guide to learn about {% data variables.product.prodname_github_issues %}.'
+intro: Follow this brief interactive guide to learn about {% data variables.product.prodname_github_issues %}.
allowTitleToDifferFromFilename: true
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: quick_start
redirect_from:
- /issues/tracking-your-work-with-issues/quickstart
- /issues/tracking-your-work-with-issues/configuring-issues/quickstart
+contentType: get-started
---
## Introduction
diff --git a/content/issues/tracking-your-work-with-issues/using-issues/adding-and-managing-issue-fields.md b/content/issues/tracking-your-work-with-issues/using-issues/adding-and-managing-issue-fields.md
index 8fc2e8fb8267..d07a19dd4ef9 100644
--- a/content/issues/tracking-your-work-with-issues/using-issues/adding-and-managing-issue-fields.md
+++ b/content/issues/tracking-your-work-with-issues/using-issues/adding-and-managing-issue-fields.md
@@ -3,7 +3,7 @@ title: Adding and managing issue fields
intro: 'You can set, edit, and clear issue field values on individual issues to capture structured metadata for your team.'
versions:
feature: issue-fields
-type: how_to
+contentType: how-tos
topics:
- Project management
shortTitle: 'Using issue fields'
diff --git a/content/issues/tracking-your-work-with-issues/using-issues/adding-sub-issues.md b/content/issues/tracking-your-work-with-issues/using-issues/adding-sub-issues.md
index 5ed68485b232..e254b2ec2d0b 100644
--- a/content/issues/tracking-your-work-with-issues/using-issues/adding-sub-issues.md
+++ b/content/issues/tracking-your-work-with-issues/using-issues/adding-sub-issues.md
@@ -1,10 +1,9 @@
---
title: Adding sub-issues
-intro: 'Learn about using sub-issues to break down your work into tasks.'
+intro: Learn about using sub-issues to break down your work into tasks.
versions:
- feature: 'sub-issues'
-type: overview
-permissions: 'People with at least triage permissions for a repository can add sub-issues.'
+ feature: sub-issues
+permissions: People with at least triage permissions for a repository can add sub-issues.
redirect_from:
- /early-access/issues/about-tasklists
- /issues/tracking-your-work-with-issues/about-tasklists
@@ -14,6 +13,7 @@ redirect_from:
- /issues/managing-your-tasks-with-tasklists/managing-tasks-in-a-tasklist
- /issues/managing-your-tasks-with-tasklists/quickstart-for-tasklists
- /issues/managing-your-tasks-with-tasklists/using-projects-and-tasklists
+contentType: concepts
---
You can add sub-issues to an issue to break down larger pieces of work into tasks. Your sub-issues show their relationship to the parent issue allowing you to track your work across {% data variables.product.github %}. Parent issues and sub-issue progress is also available in your {% data variables.projects.projects_v2 %}, allowing you to build views, filter, and group by parent issue.
diff --git a/content/issues/tracking-your-work-with-issues/using-issues/browsing-sub-issues.md b/content/issues/tracking-your-work-with-issues/using-issues/browsing-sub-issues.md
index d3824e7bb138..866aae7b6c7d 100644
--- a/content/issues/tracking-your-work-with-issues/using-issues/browsing-sub-issues.md
+++ b/content/issues/tracking-your-work-with-issues/using-issues/browsing-sub-issues.md
@@ -1,9 +1,9 @@
---
title: Browsing sub-issues
-intro: 'Learn how to navigate issue hierarchy in your repositories.'
+intro: Learn how to navigate issue hierarchy in your repositories.
versions:
- feature: 'sub-issues'
-type: overview
+ feature: sub-issues
+contentType: concepts
---
{% data reusables.issues.about-sub-issues %}
diff --git a/content/issues/tracking-your-work-with-issues/using-issues/creating-an-issue.md b/content/issues/tracking-your-work-with-issues/using-issues/creating-an-issue.md
index 73d921b8241e..416348e0c027 100644
--- a/content/issues/tracking-your-work-with-issues/using-issues/creating-an-issue.md
+++ b/content/issues/tracking-your-work-with-issues/using-issues/creating-an-issue.md
@@ -1,7 +1,7 @@
---
title: Creating an issue
-intro: 'Issues can be created in a variety of ways, so you can choose the most convenient method for your workflow.'
-permissions: 'People with read access can create an issue in a repository where issues are enabled. {% data reusables.enterprise-accounts.emu-permission-repo %}'
+intro: Issues can be created in a variety of ways, so you can choose the most convenient method for your workflow.
+permissions: People with read access can create an issue in a repository where issues are enabled. {% data reusables.enterprise-accounts.emu-permission-repo %}
redirect_from:
- /github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests/creating-an-issue
- /articles/creating-an-issue
@@ -24,7 +24,7 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Create an issue
-type: how_to
+contentType: how-tos
---
Issues can be used to keep track of bugs, enhancements, or other requests. For more information, see [AUTOTITLE](/issues/tracking-your-work-with-issues/about-issues).
diff --git a/content/issues/tracking-your-work-with-issues/using-issues/creating-issue-dependencies.md b/content/issues/tracking-your-work-with-issues/using-issues/creating-issue-dependencies.md
index c9b6f5aa2570..86603eadd346 100644
--- a/content/issues/tracking-your-work-with-issues/using-issues/creating-issue-dependencies.md
+++ b/content/issues/tracking-your-work-with-issues/using-issues/creating-issue-dependencies.md
@@ -1,12 +1,12 @@
---
title: Creating issue dependencies
-intro: 'Learn how to create issue dependencies so that you can see which issues are blocked by, or blocking, other work.'
+intro: Learn how to create issue dependencies so that you can see which issues are blocked by, or blocking, other work.
versions:
- fpt: '*'
- ghec: '*'
-type: overview
-permissions: 'People with at least triage permissions for a repository can create issue dependencies.'
-product: 'Issue dependencies are available for users on {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, and {% data variables.product.prodname_ghe_cloud %} plans.'
+ fpt: '*'
+ ghec: '*'
+permissions: People with at least triage permissions for a repository can create issue dependencies.
+product: Issue dependencies are available for users on {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, and {% data variables.product.prodname_ghe_cloud %} plans.
+contentType: concepts
---
Issue dependencies let you define issues that are blocked by, or blocking, other work.
diff --git a/content/issues/tracking-your-work-with-issues/using-issues/editing-an-issue.md b/content/issues/tracking-your-work-with-issues/using-issues/editing-an-issue.md
index 332ed58dbab6..8771195beb63 100644
--- a/content/issues/tracking-your-work-with-issues/using-issues/editing-an-issue.md
+++ b/content/issues/tracking-your-work-with-issues/using-issues/editing-an-issue.md
@@ -1,12 +1,12 @@
---
title: Editing an issue
-intro: 'Learn how to make changes to an existing issue.'
-permissions: 'Issue authors, people with write access or higher in repositories owned by an organization, and collaborators in repositories owned by a personal account can make changes to issues. {% data reusables.enterprise-accounts.emu-permission-repo %}'
+intro: Learn how to make changes to an existing issue.
+permissions: Issue authors, people with write access or higher in repositories owned by an organization, and collaborators in repositories owned by a personal account can make changes to issues. {% data reusables.enterprise-accounts.emu-permission-repo %}
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Editing an issue title
diff --git a/content/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests.md b/content/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests.md
index 054989f86d9b..bf3a77771873 100644
--- a/content/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests.md
+++ b/content/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests.md
@@ -1,6 +1,6 @@
---
title: Filtering and searching issues and pull requests
-intro: 'To find detailed information about a repository on {% data variables.product.github %}, you can filter, sort, and search issues and pull requests that are relevant to the repository.'
+intro: To find detailed information about a repository on {% data variables.product.github %}, you can filter, sort, and search issues and pull requests that are relevant to the repository.
redirect_from:
- /github/managing-your-work-on-github/finding-information-in-a-repository/filtering-issues-and-pull-requests-by-assignees
- /articles/filtering-issues-and-pull-requests-by-assignees
@@ -39,7 +39,7 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Filter and search
-type: how_to
+contentType: how-tos
---
{% data reusables.cli.filter-issues-and-pull-requests-tip %}
diff --git a/content/issues/tracking-your-work-with-issues/using-issues/managing-issue-fields-in-your-organization.md b/content/issues/tracking-your-work-with-issues/using-issues/managing-issue-fields-in-your-organization.md
index ba956198232a..72a09a4fd1f8 100644
--- a/content/issues/tracking-your-work-with-issues/using-issues/managing-issue-fields-in-your-organization.md
+++ b/content/issues/tracking-your-work-with-issues/using-issues/managing-issue-fields-in-your-organization.md
@@ -5,7 +5,7 @@ redirect_from:
- /issues/tracking-your-work-with-issues/using-issues/managing-issue-fields-in-an-organization
versions:
feature: issue-fields
-type: overview
+contentType: concepts
topics:
- Project management
shortTitle: 'Managing issue fields'
diff --git a/content/issues/tracking-your-work-with-issues/using-issues/managing-issue-types-in-an-organization.md b/content/issues/tracking-your-work-with-issues/using-issues/managing-issue-types-in-an-organization.md
index 39706fad6b84..8a18048aa6da 100644
--- a/content/issues/tracking-your-work-with-issues/using-issues/managing-issue-types-in-an-organization.md
+++ b/content/issues/tracking-your-work-with-issues/using-issues/managing-issue-types-in-an-organization.md
@@ -1,13 +1,13 @@
---
title: Managing issue types in an organization
-intro: 'Learn about issue types and how to manage them in your organization.'
+intro: Learn about issue types and how to manage them in your organization.
redirect_from:
- /issues/tracking-your-work-with-issues/configuring-issues/managing-issue-types-in-an-organization
versions:
feature: issue-types
-type: overview
-shortTitle: 'Managing issue types'
-permissions: 'Organization owners can modify issue types.'
+shortTitle: Managing issue types
+permissions: Organization owners can modify issue types.
+contentType: concepts
---
You can use issue types to classify and manage different types of issues across your organization. You can create up to {% data variables.projects.issue_type_limit %} issue types that your organization members can apply to issues, making it easier for you and your members to find issues and plan work.
diff --git a/content/issues/tracking-your-work-with-issues/using-issues/viewing-all-of-your-issues-and-pull-requests.md b/content/issues/tracking-your-work-with-issues/using-issues/viewing-all-of-your-issues-and-pull-requests.md
index 93b1d7e3ed27..5ebcf0014e36 100644
--- a/content/issues/tracking-your-work-with-issues/using-issues/viewing-all-of-your-issues-and-pull-requests.md
+++ b/content/issues/tracking-your-work-with-issues/using-issues/viewing-all-of-your-issues-and-pull-requests.md
@@ -1,6 +1,6 @@
---
title: Viewing all issues and pull requests
-intro: 'The Issues and Pull Request dashboards list the open issues and pull requests you''ve created{% ifversion issues-saved-views %}, as well as your saved views{% endif %}. You can use them to update items that have gone stale, close them, or keep track of where you''ve been mentioned across all repositories—including those you''re not subscribed to.'
+intro: The Issues and Pull Request dashboards list the open issues and pull requests you've created{% ifversion issues-saved-views %}, as well as your saved views{% endif %}. You can use them to update items that have gone stale, close them, or keep track of where you've been mentioned across all repositories—including those you're not subscribed to.
redirect_from:
- /github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests/viewing-all-of-your-issues-and-pull-requests
- /articles/viewing-all-of-your-issues-and-pull-requests
@@ -13,7 +13,7 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: View all issues & PRs
-type: how_to
+contentType: how-tos
---
## Viewing your issues and pull requests
diff --git a/content/issues/using-labels-and-milestones-to-track-work/creating-and-editing-milestones-for-issues-and-pull-requests.md b/content/issues/using-labels-and-milestones-to-track-work/creating-and-editing-milestones-for-issues-and-pull-requests.md
index d1a4f9e0477b..a3ced5cafc2d 100644
--- a/content/issues/using-labels-and-milestones-to-track-work/creating-and-editing-milestones-for-issues-and-pull-requests.md
+++ b/content/issues/using-labels-and-milestones-to-track-work/creating-and-editing-milestones-for-issues-and-pull-requests.md
@@ -11,7 +11,7 @@ versions:
ghes: '*'
ghec: '*'
shortTitle: Create & edit milestones
-type: how_to
+contentType: how-tos
---
{% data reusables.repositories.navigate-to-repo %}
{% data reusables.repositories.sidebar-issue-pr %}
diff --git a/content/issues/using-labels-and-milestones-to-track-work/managing-labels.md b/content/issues/using-labels-and-milestones-to-track-work/managing-labels.md
index 0e34dbf9cbc0..f78a875cd6a1 100644
--- a/content/issues/using-labels-and-milestones-to-track-work/managing-labels.md
+++ b/content/issues/using-labels-and-milestones-to-track-work/managing-labels.md
@@ -1,6 +1,6 @@
---
title: Managing labels
-intro: 'You can classify {% ifversion fpt or ghec %}issues, pull requests, and discussions{% else %}issues and pull requests{% endif %} by creating, editing, applying, and deleting labels.'
+intro: You can classify {% ifversion fpt or ghec %}issues, pull requests, and discussions{% else %}issues and pull requests{% endif %} by creating, editing, applying, and deleting labels.
permissions: '{% data reusables.enterprise-accounts.emu-permission-repo %}'
redirect_from:
- /github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests/managing-labels
@@ -24,7 +24,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## About labels
diff --git a/content/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-from-other-version-control-systems-with-the-administrative-shell.md b/content/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-from-other-version-control-systems-with-the-administrative-shell.md
index 85ddeb6b8ae4..bb12cdabf446 100644
--- a/content/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-from-other-version-control-systems-with-the-administrative-shell.md
+++ b/content/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-from-other-version-control-systems-with-the-administrative-shell.md
@@ -1,6 +1,6 @@
---
title: Importing from other version control systems with the administrative shell
-intro: 'Using the administrative shell, you can import from Subversion, Mercurial and Team Foundation Version Control to Git repositories on {% data variables.product.prodname_ghe_server %}.'
+intro: Using the administrative shell, you can import from Subversion, Mercurial and Team Foundation Version Control to Git repositories on {% data variables.product.prodname_ghe_server %}.
redirect_from:
- /enterprise/admin/migrations/importing-data-from-third-party-version-control-systems
- /enterprise/admin/user-management/importing-data-from-third-party-version-control-systems
@@ -8,9 +8,9 @@ redirect_from:
- /admin/user-management/migrating-data-to-and-from-your-enterprise/importing-data-from-third-party-version-control-systems
versions:
ghes: '*'
-type: how_to
shortTitle: Administrative shell
permissions: Site administrators can use the administrative shell to import data from other version control systems.
+contentType: how-tos
---
## Importing projects from Mercurial
diff --git a/content/migrations/overview/programmatically-importing-repositories.md b/content/migrations/overview/programmatically-importing-repositories.md
index 435dca3f0dd4..402bdaaa4ffc 100644
--- a/content/migrations/overview/programmatically-importing-repositories.md
+++ b/content/migrations/overview/programmatically-importing-repositories.md
@@ -1,10 +1,10 @@
---
title: Programmatically importing repositories
shortTitle: Programmatic repository imports
-intro: 'You can programmatically import repositories to {% data variables.product.prodname_dotcom %}.'
+intro: You can programmatically import repositories to {% data variables.product.prodname_dotcom %}.
versions:
feature: source-imports-api-deprecation
-type: tutorial
+contentType: tutorials
---
## About programmatic import of repositories
diff --git a/content/migrations/using-ghe-migrator/about-ghe-migrator.md b/content/migrations/using-ghe-migrator/about-ghe-migrator.md
index 81d58524f0f9..f693b37466b2 100644
--- a/content/migrations/using-ghe-migrator/about-ghe-migrator.md
+++ b/content/migrations/using-ghe-migrator/about-ghe-migrator.md
@@ -1,6 +1,6 @@
---
title: About ghe-migrator
-intro: 'You can use `ghe-migrator` to transfer data from a *source* location (either a {% data variables.product.prodname_dotcom_the_website %} organization or a {% data variables.product.prodname_ghe_server %} instance) to a *target* {% data variables.product.prodname_ghe_server %} instance.'
+intro: You can use `ghe-migrator` to transfer data from a *source* location (either a {% data variables.product.prodname_dotcom_the_website %} organization or a {% data variables.product.prodname_ghe_server %} instance) to a *target* {% data variables.product.prodname_ghe_server %} instance.
redirect_from:
- /enterprise/admin/migrations/about-migrations
- /enterprise/admin/user-management/about-migrations
@@ -10,7 +10,7 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: overview
+contentType: concepts
---
## Types of migrations
diff --git a/content/migrations/using-ghe-migrator/exporting-migration-data-from-github-enterprise-server.md b/content/migrations/using-ghe-migrator/exporting-migration-data-from-github-enterprise-server.md
index 5f3a994bcf35..db0445ecd43e 100644
--- a/content/migrations/using-ghe-migrator/exporting-migration-data-from-github-enterprise-server.md
+++ b/content/migrations/using-ghe-migrator/exporting-migration-data-from-github-enterprise-server.md
@@ -1,6 +1,6 @@
---
title: Exporting migration data from GitHub Enterprise Server
-intro: 'To change platforms or move from a trial instance to a production instance, you can export migration data from a {% data variables.product.prodname_ghe_server %} instance by preparing the instance, locking the repositories, and generating a migration archive.'
+intro: To change platforms or move from a trial instance to a production instance, you can export migration data from a {% data variables.product.prodname_ghe_server %} instance by preparing the instance, locking the repositories, and generating a migration archive.
redirect_from:
- /enterprise/admin/guides/migrations/exporting-migration-data-from-github-enterprise
- /enterprise/admin/migrations/exporting-migration-data-from-github-enterprise-server
@@ -15,8 +15,8 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: how_to
shortTitle: Export from GHES
+contentType: how-tos
---
## Preparing the {% data variables.product.prodname_ghe_server %} source instance
diff --git a/content/migrations/using-ghe-migrator/exporting-migration-data-from-githubcom.md b/content/migrations/using-ghe-migrator/exporting-migration-data-from-githubcom.md
index 6ad97799fc06..fd55a966db65 100644
--- a/content/migrations/using-ghe-migrator/exporting-migration-data-from-githubcom.md
+++ b/content/migrations/using-ghe-migrator/exporting-migration-data-from-githubcom.md
@@ -1,6 +1,6 @@
---
title: Exporting migration data from GitHub.com
-intro: 'You can export migration data from an organization on {% data variables.product.prodname_dotcom_the_website %} by using the API to select repositories to migrate, then generating a migration archive that you can import into a {% data variables.product.prodname_ghe_server %} instance.'
+intro: You can export migration data from an organization on {% data variables.product.prodname_dotcom_the_website %} by using the API to select repositories to migrate, then generating a migration archive that you can import into a {% data variables.product.prodname_ghe_server %} instance.
redirect_from:
- /enterprise/admin/guides/migrations/exporting-migration-data-from-github-com
- /enterprise/admin/migrations/exporting-migration-data-from-githubcom
@@ -15,8 +15,8 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: how_to
shortTitle: Export from GitHub.com
+contentType: how-tos
---
## Preparing the source organization on {% data variables.product.prodname_dotcom %}
diff --git a/content/migrations/using-ghe-migrator/migrating-data-to-github-enterprise-server.md b/content/migrations/using-ghe-migrator/migrating-data-to-github-enterprise-server.md
index 36e4cdce137c..dc4b7ae3342d 100644
--- a/content/migrations/using-ghe-migrator/migrating-data-to-github-enterprise-server.md
+++ b/content/migrations/using-ghe-migrator/migrating-data-to-github-enterprise-server.md
@@ -1,6 +1,6 @@
---
title: Migrating data to GitHub Enterprise Server
-intro: 'After generating a migration archive, you can import the data to your target {% data variables.product.prodname_ghe_server %} instance. You''ll be able to review changes for potential conflicts before permanently applying the changes to your target instance.'
+intro: After generating a migration archive, you can import the data to your target {% data variables.product.prodname_ghe_server %} instance. You'll be able to review changes for potential conflicts before permanently applying the changes to your target instance.
redirect_from:
- /enterprise/admin/guides/migrations/importing-migration-data-to-github-enterprise
- /enterprise/admin/migrations/applying-the-imported-data-on-github-enterprise-server
@@ -18,8 +18,8 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: how_to
shortTitle: Migrate data
+contentType: how-tos
---
## Preparing the migrated data
diff --git a/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/accessing-compliance-reports-for-your-organization.md b/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/accessing-compliance-reports-for-your-organization.md
index d91a5898435a..849877406d31 100644
--- a/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/accessing-compliance-reports-for-your-organization.md
+++ b/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/accessing-compliance-reports-for-your-organization.md
@@ -1,12 +1,12 @@
---
title: Accessing compliance reports for your organization
-intro: 'You can access {% data variables.product.company_short %}''s compliance reports, such as our SOC reports and Cloud Security Alliance CAIQ self-assessment (CSA CAIQ), for your organization.'
+intro: You can access {% data variables.product.company_short %}'s compliance reports, such as our SOC reports and Cloud Security Alliance CAIQ self-assessment (CSA CAIQ), for your organization.
versions:
fpt: '*'
ghec: '*'
-type: how_to
permissions: Organization owners can access compliance reports for the organization.
shortTitle: Access compliance reports
+contentType: how-tos
---
## About {% data variables.product.company_short %}'s compliance reports
diff --git a/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/displaying-ip-addresses-in-the-audit-log-for-your-organization.md b/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/displaying-ip-addresses-in-the-audit-log-for-your-organization.md
index 23c86629afb7..960276b7608e 100644
--- a/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/displaying-ip-addresses-in-the-audit-log-for-your-organization.md
+++ b/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/displaying-ip-addresses-in-the-audit-log-for-your-organization.md
@@ -5,7 +5,7 @@ shortTitle: IP addresses in audit log
permissions: Organization owners can display IP addresses in the audit log for an enterprise.
versions:
feature: display-ip-org-audit-log
-type: how_to
+contentType: how-tos
---
> [!NOTE]
diff --git a/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/restricting-email-notifications-for-your-organization.md b/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/restricting-email-notifications-for-your-organization.md
index fda6a9a45cfb..a8b278ecdc6b 100644
--- a/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/restricting-email-notifications-for-your-organization.md
+++ b/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/restricting-email-notifications-for-your-organization.md
@@ -1,6 +1,6 @@
---
title: Restricting email notifications for your organization
-intro: 'To prevent organization information from leaking into personal email accounts, you can restrict the domains where members can receive email notifications about organization activity.'
+intro: To prevent organization information from leaking into personal email accounts, you can restrict the domains where members can receive email notifications about organization activity.
permissions: Organization owners can restrict email notifications for an organization.
redirect_from:
- /articles/restricting-email-notifications-about-organization-activity-to-an-approved-email-domain
@@ -11,8 +11,8 @@ redirect_from:
versions:
ghes: '*'
ghec: '*'
-type: how_to
shortTitle: Restrict email notifications
+contentType: how-tos
---
## About email restrictions
diff --git a/content/organizations/managing-organization-settings/about-azure-private-networking-for-github-hosted-runners-in-your-organization.md b/content/organizations/managing-organization-settings/about-azure-private-networking-for-github-hosted-runners-in-your-organization.md
index 0b8369beb0f2..147f3ca3a054 100644
--- a/content/organizations/managing-organization-settings/about-azure-private-networking-for-github-hosted-runners-in-your-organization.md
+++ b/content/organizations/managing-organization-settings/about-azure-private-networking-for-github-hosted-runners-in-your-organization.md
@@ -1,13 +1,13 @@
---
title: About Azure private networking for GitHub-hosted runners in your organization
shortTitle: About Azure private networking
-intro: 'You can create a private network configuration for your organization to use {% data variables.product.company_short %}-hosted runners in your Azure Virtual Network(s) (VNET).'
+intro: You can create a private network configuration for your organization to use {% data variables.product.company_short %}-hosted runners in your Azure Virtual Network(s) (VNET).
versions:
feature: actions-private-networking-azure-vnet
-type: overview
permissions: '{% data reusables.actions.azure-vnet-organization-permissions %}'
redirect_from:
- /organizations/managing-organization-settings/about-using-github-hosted-runners-in-your-azure-virtual-network
+contentType: concepts
---
## About Azure private networking for {% data variables.product.company_short %}-hosted runners
diff --git a/content/organizations/managing-organization-settings/about-networking-for-hosted-compute-products-in-your-organization.md b/content/organizations/managing-organization-settings/about-networking-for-hosted-compute-products-in-your-organization.md
index f61f8db4151c..c2441fd05625 100644
--- a/content/organizations/managing-organization-settings/about-networking-for-hosted-compute-products-in-your-organization.md
+++ b/content/organizations/managing-organization-settings/about-networking-for-hosted-compute-products-in-your-organization.md
@@ -1,11 +1,11 @@
---
title: About networking for hosted compute products in your organization
shortTitle: About private networking
-intro: 'You can manage private networking for {% data variables.product.company_short %}-hosted products using network configurations in your organization.'
+intro: You can manage private networking for {% data variables.product.company_short %}-hosted products using network configurations in your organization.
permissions: '{% data reusables.actions.azure-vnet-organization-permissions %}'
versions:
feature: actions-private-networking-azure-vnet
-type: how_to
+contentType: how-tos
---
## About network configurations
diff --git a/content/organizations/managing-organization-settings/configuring-private-networking-for-github-hosted-runners-in-your-organization.md b/content/organizations/managing-organization-settings/configuring-private-networking-for-github-hosted-runners-in-your-organization.md
index 6286a8b2d595..8b395f09c3b1 100644
--- a/content/organizations/managing-organization-settings/configuring-private-networking-for-github-hosted-runners-in-your-organization.md
+++ b/content/organizations/managing-organization-settings/configuring-private-networking-for-github-hosted-runners-in-your-organization.md
@@ -1,11 +1,11 @@
---
title: Configuring private networking for GitHub-hosted runners in your organization
shortTitle: Configuring private networking
-intro: 'Learn how to use {% data variables.product.company_short %}-hosted runners with an Azure private network in your organization.'
+intro: Learn how to use {% data variables.product.company_short %}-hosted runners with an Azure private network in your organization.
versions:
feature: actions-private-networking-azure-vnet
-type: how_to
permissions: '{% data reusables.actions.azure-vnet-organization-permissions %}'
+contentType: how-tos
---
## About Azure private networking for {% data variables.product.company_short %}-hosted runners
diff --git a/content/organizations/managing-organization-settings/creating-an-announcement-banner-for-your-organization.md b/content/organizations/managing-organization-settings/creating-an-announcement-banner-for-your-organization.md
index e1ffa2918d2f..51623dae0fb9 100644
--- a/content/organizations/managing-organization-settings/creating-an-announcement-banner-for-your-organization.md
+++ b/content/organizations/managing-organization-settings/creating-an-announcement-banner-for-your-organization.md
@@ -5,7 +5,7 @@ intro: Organization owners can create announcement banners for the organization.
versions:
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
{% ifversion ghec %}
diff --git a/content/organizations/managing-organization-settings/governing-how-people-use-repositories-in-your-organization.md b/content/organizations/managing-organization-settings/governing-how-people-use-repositories-in-your-organization.md
index d6f4d2f721dc..0efcb93b1d3a 100644
--- a/content/organizations/managing-organization-settings/governing-how-people-use-repositories-in-your-organization.md
+++ b/content/organizations/managing-organization-settings/governing-how-people-use-repositories-in-your-organization.md
@@ -1,11 +1,11 @@
---
title: Governing how people use repositories in your organization
-intro: "Create a repository policy to control who can do things like create and delete repositories."
+intro: Create a repository policy to control who can do things like create and delete repositories.
permissions: Organization owners
versions:
feature: repo-policy-rules
-type: how_to
shortTitle: Govern repository usage
+contentType: how-tos
---
{% data reusables.enterprise.repo-policy-rules-preview %}
diff --git a/content/organizations/managing-organization-settings/troubleshooting-azure-private-network-configurations-for-github-hosted-runners-in-your-organization.md b/content/organizations/managing-organization-settings/troubleshooting-azure-private-network-configurations-for-github-hosted-runners-in-your-organization.md
index c4835d841b2d..0165479edbd2 100644
--- a/content/organizations/managing-organization-settings/troubleshooting-azure-private-network-configurations-for-github-hosted-runners-in-your-organization.md
+++ b/content/organizations/managing-organization-settings/troubleshooting-azure-private-network-configurations-for-github-hosted-runners-in-your-organization.md
@@ -1,11 +1,11 @@
---
title: Troubleshooting Azure private network configurations for GitHub-hosted runners in your organization
shortTitle: Troubleshooting Azure private networking
-intro: 'Learn how to fix common issues while creating Azure private network configurations to use {% data variables.product.company_short %}-hosted runners with an Azure VNET.'
+intro: Learn how to fix common issues while creating Azure private network configurations to use {% data variables.product.company_short %}-hosted runners with an Azure VNET.
versions:
feature: actions-private-networking-azure-vnet
-type: how_to
permissions: '{% data reusables.actions.azure-vnet-organization-permissions %}'
+contentType: how-tos
---
## Troubleshooting configuring private networking for {% data variables.product.company_short %}-hosted runners in your organization
diff --git a/content/organizations/managing-organization-settings/verifying-or-approving-a-domain-for-your-organization.md b/content/organizations/managing-organization-settings/verifying-or-approving-a-domain-for-your-organization.md
index 43643ea49cf9..3c51554fec4e 100644
--- a/content/organizations/managing-organization-settings/verifying-or-approving-a-domain-for-your-organization.md
+++ b/content/organizations/managing-organization-settings/verifying-or-approving-a-domain-for-your-organization.md
@@ -1,6 +1,6 @@
---
title: Verifying or approving a domain for your organization
-intro: 'You can verify your ownership of domains with {% data variables.product.company_short %} to confirm your organization''s identity.{% ifversion ghec or ghes %} You can also approve domains that {% data variables.product.company_short %} can send email notifications to for members of your organization.{% endif %}'
+intro: You can verify your ownership of domains with {% data variables.product.company_short %} to confirm your organization's identity.{% ifversion ghec or ghes %} You can also approve domains that {% data variables.product.company_short %} can send email notifications to for members of your organization.{% endif %}
redirect_from:
- /articles/verifying-your-organization-s-domain
- /articles/verifying-your-organizations-domain
@@ -11,8 +11,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
shortTitle: Verify or approve a domain
+contentType: how-tos
---
## About domain verification
diff --git a/content/pages/quickstart.md b/content/pages/quickstart.md
index fa1e76421b02..72ca207ffe52 100644
--- a/content/pages/quickstart.md
+++ b/content/pages/quickstart.md
@@ -1,16 +1,16 @@
---
title: Quickstart for GitHub Pages
-intro: 'You can use {% data variables.product.prodname_pages %} to showcase some open source projects, host a blog, or even share your résumé. This guide will help get you started on creating your next website.'
+intro: You can use {% data variables.product.prodname_pages %} to showcase some open source projects, host a blog, or even share your résumé. This guide will help get you started on creating your next website.
allowTitleToDifferFromFilename: true
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: quick_start
shortTitle: Quickstart
product: '{% data reusables.gated-features.pages %}'
category:
- Set up a GitHub Pages site
+contentType: get-started
---
## Introduction
diff --git a/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-dependency-changes-in-a-pull-request.md b/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-dependency-changes-in-a-pull-request.md
index d51d619c4f43..942ff0328622 100644
--- a/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-dependency-changes-in-a-pull-request.md
+++ b/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-dependency-changes-in-a-pull-request.md
@@ -1,17 +1,17 @@
---
title: Reviewing dependency changes in a pull request
-intro: 'If a pull request contains changes to dependencies, you can view a summary of what has changed and whether there are known vulnerabilities in any of the dependencies.'
+intro: If a pull request contains changes to dependencies, you can view a summary of what has changed and whether there are known vulnerabilities in any of the dependencies.
product: '{% data reusables.gated-features.dependency-review %}'
versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
redirect_from:
- /github/collaborating-with-issues-and-pull-requests/reviewing-changes-in-pull-requests/reviewing-dependency-changes-in-a-pull-request
- /github/collaborating-with-issues-and-pull-requests/reviewing-dependency-changes-in-a-pull-request
- /github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-dependency-changes-in-a-pull-request
shortTitle: Review dependency changes
+contentType: how-tos
category:
- Review pull requests
---
diff --git a/content/repositories/creating-and-managing-repositories/quickstart-for-repositories.md b/content/repositories/creating-and-managing-repositories/quickstart-for-repositories.md
index 5f86783420d0..125a25d26f1b 100644
--- a/content/repositories/creating-and-managing-repositories/quickstart-for-repositories.md
+++ b/content/repositories/creating-and-managing-repositories/quickstart-for-repositories.md
@@ -1,17 +1,17 @@
---
title: Quickstart for repositories
-type: quick_start
redirect_from:
- /create-a-repo
- /articles/create-a-repo
- /github/getting-started-with-github/create-a-repo
- /github/getting-started-with-github/quickstart/create-a-repo
- /get-started/quickstart/create-a-repo
-intro: 'Learn how to create a new repository and commit your first change in 5 minutes.'
+intro: Learn how to create a new repository and commit your first change in 5 minutes.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
+contentType: get-started
category:
- Create and set up a repository
---
diff --git a/content/repositories/creating-and-managing-repositories/viewing-all-your-repositories.md b/content/repositories/creating-and-managing-repositories/viewing-all-your-repositories.md
index dc21d2ea393f..b262d0dd0690 100644
--- a/content/repositories/creating-and-managing-repositories/viewing-all-your-repositories.md
+++ b/content/repositories/creating-and-managing-repositories/viewing-all-your-repositories.md
@@ -1,13 +1,13 @@
---
title: Viewing all repositories
-intro: 'The repository dashboard lists the repositories you''ve created as well as where you''ve made contributions. You can use search and filters to find the right repositories and create saved views.'
+intro: The repository dashboard lists the repositories you've created as well as where you've made contributions. You can use search and filters to find the right repositories and create saved views.
allowTitleToDifferFromFilename: true
versions:
fpt: '*'
ghec: '*'
ghes: '>=3.22'
shortTitle: View all repositories
-type: how_to
+contentType: how-tos
category:
- Manage, move, and archive a repository
---
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md
index 53969c97dab9..cdae54043b3d 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md
@@ -1,6 +1,6 @@
---
title: Managing GitHub Actions settings for a repository
-intro: 'You can disable or configure {% data variables.product.prodname_actions %} for a specific repository.'
+intro: You can disable or configure {% data variables.product.prodname_actions %} for a specific repository.
redirect_from:
- /github/administering-a-repository/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository
- /github/administering-a-repository/managing-repository-settings/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository
@@ -10,8 +10,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
shortTitle: Manage GitHub Actions settings
+contentType: how-tos
category:
- Manage access and repository policies
---
diff --git a/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-security-and-analysis-settings-for-your-repository.md b/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-security-and-analysis-settings-for-your-repository.md
index 1e3762bcce59..6c3d2e40eab3 100644
--- a/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-security-and-analysis-settings-for-your-repository.md
+++ b/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-security-and-analysis-settings-for-your-repository.md
@@ -1,6 +1,6 @@
---
title: Managing security and analysis settings for your repository
-intro: 'You can control features that secure and analyze the code in your project on {% data variables.product.github %}.'
+intro: You can control features that secure and analyze the code in your project on {% data variables.product.github %}.
permissions: People with admin permissions to a repository can manage security and analysis settings for the repository.
redirect_from:
- /articles/managing-alerts-for-vulnerable-dependencies-in-your-organization-s-repositories
@@ -13,8 +13,8 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
shortTitle: Security & analysis
+contentType: how-tos
category:
- Manage access and repository policies
---
diff --git a/content/rest/guides/scripting-with-the-rest-api-and-javascript.md b/content/rest/guides/scripting-with-the-rest-api-and-javascript.md
index 060935cf664e..7cadd74cdb15 100644
--- a/content/rest/guides/scripting-with-the-rest-api-and-javascript.md
+++ b/content/rest/guides/scripting-with-the-rest-api-and-javascript.md
@@ -6,7 +6,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
---
## About Octokit.js
diff --git a/content/rest/guides/scripting-with-the-rest-api-and-ruby.md b/content/rest/guides/scripting-with-the-rest-api-and-ruby.md
index 112a5a6045fc..00e06b88fd0d 100644
--- a/content/rest/guides/scripting-with-the-rest-api-and-ruby.md
+++ b/content/rest/guides/scripting-with-the-rest-api-and-ruby.md
@@ -6,7 +6,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
---
## About Octokit.rb
diff --git a/content/sponsors/getting-started-with-github-sponsors/about-github-sponsors.md b/content/sponsors/getting-started-with-github-sponsors/about-github-sponsors.md
index 897925405aa9..9b7d0ca644b4 100644
--- a/content/sponsors/getting-started-with-github-sponsors/about-github-sponsors.md
+++ b/content/sponsors/getting-started-with-github-sponsors/about-github-sponsors.md
@@ -7,7 +7,7 @@ redirect_from:
versions:
fpt: '*'
ghec: '*'
-type: overview
+contentType: concepts
---
## About {% data variables.product.prodname_sponsors %}
diff --git a/content/sponsors/getting-started-with-github-sponsors/navigating-your-sponsors-dashboard.md b/content/sponsors/getting-started-with-github-sponsors/navigating-your-sponsors-dashboard.md
index e8ea0f0effb0..de31d0d75f2d 100644
--- a/content/sponsors/getting-started-with-github-sponsors/navigating-your-sponsors-dashboard.md
+++ b/content/sponsors/getting-started-with-github-sponsors/navigating-your-sponsors-dashboard.md
@@ -1,10 +1,10 @@
---
title: Navigating your Sponsors dashboard
-intro: 'View {% data variables.product.prodname_sponsors %}-related activity from your Sponsors dashboard.'
+intro: View {% data variables.product.prodname_sponsors %}-related activity from your Sponsors dashboard.
versions:
fpt: '*'
ghec: '*'
-type: overview
+contentType: concepts
---
## About your Sponsors dashboard
diff --git a/content/sponsors/getting-started-with-github-sponsors/quickstart-for-finding-contributors-to-sponsor.md b/content/sponsors/getting-started-with-github-sponsors/quickstart-for-finding-contributors-to-sponsor.md
index 3706cf43095e..d9dfd59ca8c0 100644
--- a/content/sponsors/getting-started-with-github-sponsors/quickstart-for-finding-contributors-to-sponsor.md
+++ b/content/sponsors/getting-started-with-github-sponsors/quickstart-for-finding-contributors-to-sponsor.md
@@ -4,8 +4,8 @@ intro: Learn some best practices for finding open source contributors to sponsor
versions:
fpt: '*'
ghec: '*'
-type: quick_start
shortTitle: Quickstart
+contentType: get-started
---
## Explore projects you depend on
diff --git a/content/sponsors/integrating-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account.md b/content/sponsors/integrating-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account.md
index 7bebc45b227e..e683bd8b59e4 100644
--- a/content/sponsors/integrating-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account.md
+++ b/content/sponsors/integrating-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account.md
@@ -6,8 +6,8 @@ redirect_from:
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Webhooks for events
+contentType: how-tos
---
## About webhooks for events in your sponsored account
diff --git a/content/sponsors/integrating-with-github-sponsors/getting-started-with-the-sponsors-graphql-api.md b/content/sponsors/integrating-with-github-sponsors/getting-started-with-the-sponsors-graphql-api.md
index c98203c3c74c..a4fda4a49295 100644
--- a/content/sponsors/integrating-with-github-sponsors/getting-started-with-the-sponsors-graphql-api.md
+++ b/content/sponsors/integrating-with-github-sponsors/getting-started-with-the-sponsors-graphql-api.md
@@ -1,11 +1,11 @@
---
title: Getting started with the Sponsors GraphQL API
-intro: 'Using the GraphQL API, you can build custom integrations to manage or review your sponsorships.'
+intro: Using the GraphQL API, you can build custom integrations to manage or review your sponsorships.
versions:
fpt: '*'
ghec: '*'
-type: overview
shortTitle: Sponsors GraphQL API
+contentType: concepts
---
To get started with the GraphQL API, see [AUTOTITLE](/graphql/guides/introduction-to-graphql).
diff --git a/content/sponsors/receiving-sponsorships-through-github-sponsors/about-github-sponsors-for-open-source-contributors.md b/content/sponsors/receiving-sponsorships-through-github-sponsors/about-github-sponsors-for-open-source-contributors.md
index d66965634ad7..e8067844190f 100644
--- a/content/sponsors/receiving-sponsorships-through-github-sponsors/about-github-sponsors-for-open-source-contributors.md
+++ b/content/sponsors/receiving-sponsorships-through-github-sponsors/about-github-sponsors-for-open-source-contributors.md
@@ -1,14 +1,14 @@
---
title: About GitHub Sponsors for open source contributors
-intro: 'If you provide value to an open source project, you can become a sponsored contributor to receive payments for your work.'
+intro: If you provide value to an open source project, you can become a sponsored contributor to receive payments for your work.
redirect_from:
- /articles/about-github-sponsors-for-sponsored-developers
- /github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors-for-sponsored-developers
versions:
fpt: '*'
ghec: '*'
-type: overview
shortTitle: Open source contributors
+contentType: concepts
---
## Joining {% data variables.product.prodname_sponsors %}
diff --git a/content/sponsors/receiving-sponsorships-through-github-sponsors/contacting-your-sponsors.md b/content/sponsors/receiving-sponsorships-through-github-sponsors/contacting-your-sponsors.md
index cf7eed0e285c..3d4c7ede551a 100644
--- a/content/sponsors/receiving-sponsorships-through-github-sponsors/contacting-your-sponsors.md
+++ b/content/sponsors/receiving-sponsorships-through-github-sponsors/contacting-your-sponsors.md
@@ -7,7 +7,7 @@ redirect_from:
versions:
fpt: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## About sponsorship updates
diff --git a/content/sponsors/receiving-sponsorships-through-github-sponsors/disabling-your-github-sponsors-account.md b/content/sponsors/receiving-sponsorships-through-github-sponsors/disabling-your-github-sponsors-account.md
index a204a6d16e36..e2954ce3e9cd 100644
--- a/content/sponsors/receiving-sponsorships-through-github-sponsors/disabling-your-github-sponsors-account.md
+++ b/content/sponsors/receiving-sponsorships-through-github-sponsors/disabling-your-github-sponsors-account.md
@@ -1,11 +1,11 @@
---
title: Disabling your GitHub Sponsors account
-intro: 'If you no longer want to participate in {% data variables.product.prodname_sponsors %}, you can disable your {% data variables.product.prodname_sponsors %} account.'
+intro: If you no longer want to participate in {% data variables.product.prodname_sponsors %}, you can disable your {% data variables.product.prodname_sponsors %} account.
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Disable your account
+contentType: how-tos
---
If you are receiving sponsorship payments, you'll need to contact GitHub Support to disable your {% data variables.product.prodname_sponsors %} account.
diff --git a/content/sponsors/receiving-sponsorships-through-github-sponsors/editing-your-profile-details-for-github-sponsors.md b/content/sponsors/receiving-sponsorships-through-github-sponsors/editing-your-profile-details-for-github-sponsors.md
index b899b56a0ee2..60648c9331c9 100644
--- a/content/sponsors/receiving-sponsorships-through-github-sponsors/editing-your-profile-details-for-github-sponsors.md
+++ b/content/sponsors/receiving-sponsorships-through-github-sponsors/editing-your-profile-details-for-github-sponsors.md
@@ -8,8 +8,8 @@ redirect_from:
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Edit profile details
+contentType: how-tos
---
## About sponsor profiles
diff --git a/content/sponsors/receiving-sponsorships-through-github-sponsors/enabling-sponsorships-through-patreon.md b/content/sponsors/receiving-sponsorships-through-github-sponsors/enabling-sponsorships-through-patreon.md
index 5768686bce48..8216617c9d61 100644
--- a/content/sponsors/receiving-sponsorships-through-github-sponsors/enabling-sponsorships-through-patreon.md
+++ b/content/sponsors/receiving-sponsorships-through-github-sponsors/enabling-sponsorships-through-patreon.md
@@ -1,11 +1,11 @@
---
title: Enabling sponsorships through Patreon
-intro: 'You can connect your Patreon and {% data variables.product.prodname_dotcom %} accounts to receive {% data variables.product.prodname_sponsors %} sponsorships through Patreon.'
+intro: You can connect your Patreon and {% data variables.product.prodname_dotcom %} accounts to receive {% data variables.product.prodname_sponsors %} sponsorships through Patreon.
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Enable Patreon sponsorships
+contentType: how-tos
---
## Prerequisites
diff --git a/content/sponsors/receiving-sponsorships-through-github-sponsors/managing-your-payouts-from-github-sponsors.md b/content/sponsors/receiving-sponsorships-through-github-sponsors/managing-your-payouts-from-github-sponsors.md
index 2c502c95bb9e..c6df6935f284 100644
--- a/content/sponsors/receiving-sponsorships-through-github-sponsors/managing-your-payouts-from-github-sponsors.md
+++ b/content/sponsors/receiving-sponsorships-through-github-sponsors/managing-your-payouts-from-github-sponsors.md
@@ -1,14 +1,14 @@
---
title: Managing your payouts from GitHub Sponsors
-intro: 'You can view information about past and future payouts from {% data variables.product.prodname_sponsors %} and edit your bank information.'
+intro: You can view information about past and future payouts from {% data variables.product.prodname_sponsors %} and edit your bank information.
redirect_from:
- /articles/managing-your-payouts-from-github-sponsors
- /github/supporting-the-open-source-community-with-github-sponsors/managing-your-payouts-from-github-sponsors
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Manage payouts
+contentType: how-tos
---
## About payouts from {% data variables.product.prodname_sponsors %}
diff --git a/content/sponsors/receiving-sponsorships-through-github-sponsors/managing-your-sponsorship-goal.md b/content/sponsors/receiving-sponsorships-through-github-sponsors/managing-your-sponsorship-goal.md
index 47b7fe78f913..f7fbf729bde2 100644
--- a/content/sponsors/receiving-sponsorships-through-github-sponsors/managing-your-sponsorship-goal.md
+++ b/content/sponsors/receiving-sponsorships-through-github-sponsors/managing-your-sponsorship-goal.md
@@ -7,8 +7,8 @@ redirect_from:
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Manage sponsor goals
+contentType: how-tos
---
## About sponsorship goals
diff --git a/content/sponsors/receiving-sponsorships-through-github-sponsors/managing-your-sponsorship-tiers.md b/content/sponsors/receiving-sponsorships-through-github-sponsors/managing-your-sponsorship-tiers.md
index 7227b12e9b47..f1abc3dd8ef7 100644
--- a/content/sponsors/receiving-sponsorships-through-github-sponsors/managing-your-sponsorship-tiers.md
+++ b/content/sponsors/receiving-sponsorships-through-github-sponsors/managing-your-sponsorship-tiers.md
@@ -1,6 +1,6 @@
---
title: Managing your sponsorship tiers
-intro: 'You can add a new sponsorship tier, or edit or retire an existing tier.'
+intro: You can add a new sponsorship tier, or edit or retire an existing tier.
redirect_from:
- /articles/changing-your-sponsorship-tiers
- /github/supporting-the-open-source-community-with-github-sponsors/changing-your-sponsorship-tiers
@@ -8,8 +8,8 @@ redirect_from:
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Manage payment tiers
+contentType: how-tos
---
## About sponsorship tiers
diff --git a/content/sponsors/receiving-sponsorships-through-github-sponsors/setting-up-github-sponsors-for-your-organization.md b/content/sponsors/receiving-sponsorships-through-github-sponsors/setting-up-github-sponsors-for-your-organization.md
index 462548569428..fa8b7007cb4a 100644
--- a/content/sponsors/receiving-sponsorships-through-github-sponsors/setting-up-github-sponsors-for-your-organization.md
+++ b/content/sponsors/receiving-sponsorships-through-github-sponsors/setting-up-github-sponsors-for-your-organization.md
@@ -1,16 +1,16 @@
---
title: Setting up GitHub Sponsors for your organization
-intro: 'Your organization can join {% data variables.product.prodname_sponsors %} to receive payments for your work.'
+intro: Your organization can join {% data variables.product.prodname_sponsors %} to receive payments for your work.
redirect_from:
- /articles/setting-up-github-sponsorship-for-your-organization
- /articles/receiving-sponsorships-as-a-sponsored-organization
- /github/supporting-the-open-source-community-with-github-sponsors/setting-up-github-sponsors-for-your-organization
-permissions: 'Organization owners can set up {% data variables.product.prodname_sponsors %} for an organization.'
+permissions: Organization owners can set up {% data variables.product.prodname_sponsors %} for an organization.
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Set up for organization
+contentType: how-tos
---
## Joining {% data variables.product.prodname_sponsors %}
diff --git a/content/sponsors/receiving-sponsorships-through-github-sponsors/setting-up-github-sponsors-for-your-personal-account.md b/content/sponsors/receiving-sponsorships-through-github-sponsors/setting-up-github-sponsors-for-your-personal-account.md
index 1c3a38244df9..c3ad50e94b0e 100644
--- a/content/sponsors/receiving-sponsorships-through-github-sponsors/setting-up-github-sponsors-for-your-personal-account.md
+++ b/content/sponsors/receiving-sponsorships-through-github-sponsors/setting-up-github-sponsors-for-your-personal-account.md
@@ -1,6 +1,6 @@
---
title: Setting up GitHub Sponsors for your personal account
-intro: 'You can become a sponsored developer by joining {% data variables.product.prodname_sponsors %}, completing your sponsored developer profile, creating sponsorship tiers, submitting your bank and tax information, and enabling two-factor authentication for your account on {% data variables.product.prodname_dotcom %}.'
+intro: You can become a sponsored developer by joining {% data variables.product.prodname_sponsors %}, completing your sponsored developer profile, creating sponsorship tiers, submitting your bank and tax information, and enabling two-factor authentication for your account on {% data variables.product.prodname_dotcom %}.
redirect_from:
- /articles/becoming-a-sponsored-developer
- /github/supporting-the-open-source-community-with-github-sponsors/becoming-a-sponsored-developer
@@ -9,8 +9,8 @@ redirect_from:
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Set up for personal account
+contentType: how-tos
---
## Joining {% data variables.product.prodname_sponsors %}
diff --git a/content/sponsors/receiving-sponsorships-through-github-sponsors/tax-information-for-github-sponsors.md b/content/sponsors/receiving-sponsorships-through-github-sponsors/tax-information-for-github-sponsors.md
index 109e46f1dbe5..1599a4cd77ff 100644
--- a/content/sponsors/receiving-sponsorships-through-github-sponsors/tax-information-for-github-sponsors.md
+++ b/content/sponsors/receiving-sponsorships-through-github-sponsors/tax-information-for-github-sponsors.md
@@ -1,14 +1,14 @@
---
title: Tax information for GitHub Sponsors
-intro: 'Sponsored developers and organizations must submit tax information to {% data variables.product.prodname_dotcom %} and are responsible for evaluating and paying their own taxes.'
+intro: Sponsored developers and organizations must submit tax information to {% data variables.product.prodname_dotcom %} and are responsible for evaluating and paying their own taxes.
redirect_from:
- /articles/tax-information-for-sponsored-developers
- /github/supporting-the-open-source-community-with-github-sponsors/tax-information-for-sponsored-developers
versions:
fpt: '*'
ghec: '*'
-type: overview
shortTitle: Tax information
+contentType: concepts
---
## W-9/W-8 tax forms
diff --git a/content/sponsors/receiving-sponsorships-through-github-sponsors/unlinking-your-patreon-account-from-your-github-sponsors-profile.md b/content/sponsors/receiving-sponsorships-through-github-sponsors/unlinking-your-patreon-account-from-your-github-sponsors-profile.md
index deeb1a648316..951245185148 100644
--- a/content/sponsors/receiving-sponsorships-through-github-sponsors/unlinking-your-patreon-account-from-your-github-sponsors-profile.md
+++ b/content/sponsors/receiving-sponsorships-through-github-sponsors/unlinking-your-patreon-account-from-your-github-sponsors-profile.md
@@ -1,11 +1,11 @@
---
title: Unlinking your Patreon account from your GitHub Sponsors profile
-intro: 'You can disconnect your Patreon account from your {% data variables.product.prodname_sponsors %} profile to stop receiving new sponsorships through Patreon.'
+intro: You can disconnect your Patreon account from your {% data variables.product.prodname_sponsors %} profile to stop receiving new sponsorships through Patreon.
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Unlink Patreon
+contentType: how-tos
---
> [!NOTE]
diff --git a/content/sponsors/receiving-sponsorships-through-github-sponsors/unpublishing-your-github-sponsors-profile.md b/content/sponsors/receiving-sponsorships-through-github-sponsors/unpublishing-your-github-sponsors-profile.md
index 61eaf98a61b5..bd743427b4c2 100644
--- a/content/sponsors/receiving-sponsorships-through-github-sponsors/unpublishing-your-github-sponsors-profile.md
+++ b/content/sponsors/receiving-sponsorships-through-github-sponsors/unpublishing-your-github-sponsors-profile.md
@@ -1,11 +1,11 @@
---
title: Unpublishing your GitHub Sponsors profile
-intro: 'If you don''t have any sponsors, you can unpublish your {% data variables.product.prodname_sponsors %} profile.'
+intro: If you don't have any sponsors, you can unpublish your {% data variables.product.prodname_sponsors %} profile.
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Unpublish your profile
+contentType: how-tos
---
If you have sponsors, you'll need to contact GitHub Support to help you unpublish your {% data variables.product.prodname_sponsors %} account.
diff --git a/content/sponsors/receiving-sponsorships-through-github-sponsors/using-a-fiscal-host-to-receive-github-sponsors-payouts.md b/content/sponsors/receiving-sponsorships-through-github-sponsors/using-a-fiscal-host-to-receive-github-sponsors-payouts.md
index dbd3b4a7a838..d5f701cee4c3 100644
--- a/content/sponsors/receiving-sponsorships-through-github-sponsors/using-a-fiscal-host-to-receive-github-sponsors-payouts.md
+++ b/content/sponsors/receiving-sponsorships-through-github-sponsors/using-a-fiscal-host-to-receive-github-sponsors-payouts.md
@@ -1,11 +1,11 @@
---
title: Using a fiscal host to receive GitHub Sponsors payouts
-intro: 'You can become a sponsored developer by joining {% data variables.product.prodname_sponsors %} and choosing a fiscal host for your payouts to come through.'
+intro: You can become a sponsored developer by joining {% data variables.product.prodname_sponsors %} and choosing a fiscal host for your payouts to come through.
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Using a fiscal host
+contentType: how-tos
---
## About using a fiscal host to receive {% data variables.product.prodname_sponsors %} payouts
diff --git a/content/sponsors/receiving-sponsorships-through-github-sponsors/viewing-your-sponsors-and-sponsorships.md b/content/sponsors/receiving-sponsorships-through-github-sponsors/viewing-your-sponsors-and-sponsorships.md
index 17d01a449ec7..c6d2490fcbe0 100644
--- a/content/sponsors/receiving-sponsorships-through-github-sponsors/viewing-your-sponsors-and-sponsorships.md
+++ b/content/sponsors/receiving-sponsorships-through-github-sponsors/viewing-your-sponsors-and-sponsorships.md
@@ -7,8 +7,8 @@ redirect_from:
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: View sponsors & sponsorships
+contentType: how-tos
---
## About sponsors and sponsorships
diff --git a/content/sponsors/sponsoring-open-source-contributors/about-sponsorships-fees-and-taxes.md b/content/sponsors/sponsoring-open-source-contributors/about-sponsorships-fees-and-taxes.md
index 7d2871b91467..0903eaa3b047 100644
--- a/content/sponsors/sponsoring-open-source-contributors/about-sponsorships-fees-and-taxes.md
+++ b/content/sponsors/sponsoring-open-source-contributors/about-sponsorships-fees-and-taxes.md
@@ -4,9 +4,9 @@ intro: Learn about sponsorships, payment, and tax information for {% data variab
versions:
fpt: '*'
ghec: '*'
-type: overview
shortTitle: About sponsorships
allowTitleToDifferFromFilename: true
+contentType: concepts
---
## About sponsorships
diff --git a/content/sponsors/sponsoring-open-source-contributors/attributing-sponsorships-to-your-organization.md b/content/sponsors/sponsoring-open-source-contributors/attributing-sponsorships-to-your-organization.md
index fec05587b17e..5652ccdc501e 100644
--- a/content/sponsors/sponsoring-open-source-contributors/attributing-sponsorships-to-your-organization.md
+++ b/content/sponsors/sponsoring-open-source-contributors/attributing-sponsorships-to-your-organization.md
@@ -7,8 +7,8 @@ versions:
fpt: '*'
ghec: '*'
permissions: People who are organization owners of both organizations can attribute one organization's sponsorships to another organization.
-type: how_to
shortTitle: Attribute sponsorships
+contentType: how-tos
---
1. Navigate to the organization whose sponsorships you want to attribute to another organization.
diff --git a/content/sponsors/sponsoring-open-source-contributors/managing-your-sponsorship.md b/content/sponsors/sponsoring-open-source-contributors/managing-your-sponsorship.md
index 2eb7b9e9629a..3b760b320cf8 100644
--- a/content/sponsors/sponsoring-open-source-contributors/managing-your-sponsorship.md
+++ b/content/sponsors/sponsoring-open-source-contributors/managing-your-sponsorship.md
@@ -7,7 +7,7 @@ redirect_from:
versions:
fpt: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Managing the privacy setting for your sponsorship
diff --git a/content/sponsors/sponsoring-open-source-contributors/paying-for-github-sponsors-by-invoice.md b/content/sponsors/sponsoring-open-source-contributors/paying-for-github-sponsors-by-invoice.md
index 3b7d3da311c2..bceecbe3febc 100644
--- a/content/sponsors/sponsoring-open-source-contributors/paying-for-github-sponsors-by-invoice.md
+++ b/content/sponsors/sponsoring-open-source-contributors/paying-for-github-sponsors-by-invoice.md
@@ -1,13 +1,13 @@
---
title: Paying for GitHub Sponsors by invoice
shortTitle: Paying by invoice
-intro: 'Organizations can set up invoicing to sponsor accounts.'
+intro: Organizations can set up invoicing to sponsor accounts.
versions:
fpt: '*'
ghec: '*'
-type: how_to
redirect_from:
- /sponsors/sponsoring-open-source-contributors/paying-for-github-sponsors-via-invoice
+contentType: how-tos
---
## About paying for {% data variables.product.prodname_sponsors %} by invoice
diff --git a/content/sponsors/sponsoring-open-source-contributors/sponsoring-an-open-source-contributor-through-github.md b/content/sponsors/sponsoring-open-source-contributors/sponsoring-an-open-source-contributor-through-github.md
index c1e3ff17ce30..929b34c18a89 100644
--- a/content/sponsors/sponsoring-open-source-contributors/sponsoring-an-open-source-contributor-through-github.md
+++ b/content/sponsors/sponsoring-open-source-contributors/sponsoring-an-open-source-contributor-through-github.md
@@ -1,6 +1,6 @@
---
title: Sponsoring an open source contributor through GitHub
-intro: 'You can make payments through {% data variables.product.prodname_dotcom %} to a developer or organization who designs, creates, or maintains open source projects you depend on.'
+intro: You can make payments through {% data variables.product.prodname_dotcom %} to a developer or organization who designs, creates, or maintains open source projects you depend on.
redirect_from:
- /articles/sponsoring-a-developer
- /articles/sponsoring-an-open-source-contributor
@@ -11,8 +11,8 @@ versions:
fpt: '*'
ghec: '*'
permissions: '{% data reusables.sponsors.sponsorship-permissions %}'
-type: how_to
shortTitle: Sponsor through {% data variables.product.prodname_dotcom %}
+contentType: how-tos
---
## About sponsorships with payments through {% data variables.product.prodname_dotcom %}
diff --git a/content/sponsors/sponsoring-open-source-contributors/sponsoring-an-open-source-contributor-through-patreon.md b/content/sponsors/sponsoring-open-source-contributors/sponsoring-an-open-source-contributor-through-patreon.md
index 56ff318c9568..75d16a74be60 100644
--- a/content/sponsors/sponsoring-open-source-contributors/sponsoring-an-open-source-contributor-through-patreon.md
+++ b/content/sponsors/sponsoring-open-source-contributors/sponsoring-an-open-source-contributor-through-patreon.md
@@ -1,12 +1,12 @@
---
title: Sponsoring an open source contributor through Patreon
-intro: 'You can make payments through Patreon on {% data variables.product.prodname_dotcom %} to a developer or organization who designs, creates, or maintains open source projects you depend on.'
+intro: You can make payments through Patreon on {% data variables.product.prodname_dotcom %} to a developer or organization who designs, creates, or maintains open source projects you depend on.
versions:
fpt: '*'
ghec: '*'
permissions: '{% data reusables.sponsors.sponsorship-permissions %}'
-type: how_to
shortTitle: Sponsor through Patreon
+contentType: how-tos
---
## About sponsoring through Patreon
diff --git a/content/sponsors/sponsoring-open-source-contributors/unlinking-your-patreon-account-from-github.md b/content/sponsors/sponsoring-open-source-contributors/unlinking-your-patreon-account-from-github.md
index 410ae25459ff..a6cdc93299b4 100644
--- a/content/sponsors/sponsoring-open-source-contributors/unlinking-your-patreon-account-from-github.md
+++ b/content/sponsors/sponsoring-open-source-contributors/unlinking-your-patreon-account-from-github.md
@@ -1,13 +1,13 @@
---
title: Unlinking your Patreon account from GitHub
-intro: 'You can disconnect your Patreon account from {% data variables.product.prodname_dotcom %} to stop receiving recognition for Patreon sponsorships on {% data variables.product.prodname_dotcom %}.'
+intro: You can disconnect your Patreon account from {% data variables.product.prodname_dotcom %} to stop receiving recognition for Patreon sponsorships on {% data variables.product.prodname_dotcom %}.
versions:
fpt: '*'
ghec: '*'
-type: how_to
shortTitle: Unlink Patreon
redirect_from:
- /sponsors/sponsoring-open-source-contributors/unlinking-your-patreon-account-from-your-github-account
+contentType: how-tos
---
> [!NOTE]
diff --git a/content/support/learning-about-github-support/about-copilot-in-github-support.md b/content/support/learning-about-github-support/about-copilot-in-github-support.md
index adb40e7adce4..c14651b60c1e 100644
--- a/content/support/learning-about-github-support/about-copilot-in-github-support.md
+++ b/content/support/learning-about-github-support/about-copilot-in-github-support.md
@@ -6,7 +6,7 @@ versions:
ghec: '*'
ghes: '*'
shortTitle: About Copilot in GitHub Support
-type: rai
+contentType: rai
---
## About {% data variables.copilot.copilot_in_support %}
diff --git a/data/ui.yml b/data/ui.yml
index b008831d4fdb..a9412e255088 100644
--- a/data/ui.yml
+++ b/data/ui.yml
@@ -321,10 +321,10 @@ product_guides:
one: 1 guide found
none: No guides found
guide_types:
- overview: Overview
- quick_start: Quickstart
- tutorial: Tutorial
- how_to: How-to guide
+ get-started: Quickstart
+ concepts: Concepts
+ how-tos: How-to guide
+ tutorials: Tutorial
reference: Reference
learning_track_nav:
prev_guide: Previous
diff --git a/src/app/lib/main-context-adapter.ts b/src/app/lib/main-context-adapter.ts
index ccca0c98a17a..5c8b0b63feae 100644
--- a/src/app/lib/main-context-adapter.ts
+++ b/src/app/lib/main-context-adapter.ts
@@ -72,7 +72,6 @@ export function createMinimalMainContext(
introPlainText?: string
topics?: string[]
documentType?: string
- type?: string
hidden?: boolean
},
appContext?: AppRouterContext,
@@ -95,7 +94,6 @@ export function createMinimalMainContext(
page: pageData
? {
documentType: pageData.documentType || 'article',
- type: pageData.type,
topics: pageData.topics || [],
title: pageData.title || 'Page Not Found',
fullTitle: pageData.fullTitle || pageData.title,
diff --git a/src/content-linter/lib/linting-rules/rai-app-card-structure.ts b/src/content-linter/lib/linting-rules/rai-app-card-structure.ts
index 3f92e5e5bc39..d166ed89ee45 100644
--- a/src/content-linter/lib/linting-rules/rai-app-card-structure.ts
+++ b/src/content-linter/lib/linting-rules/rai-app-card-structure.ts
@@ -326,13 +326,12 @@ function validateReusables(
interface Frontmatter {
contentType?: string
- type?: string
[key: string]: unknown
}
function isFileRaiCard(params: RuleParams): boolean {
const fm: Frontmatter = (getFrontmatter(params.frontMatterLines) as Frontmatter) || {}
- return fm.contentType === 'rai' || fm.type === 'rai'
+ return fm.contentType === 'rai'
}
export const raiAppCardStructure: Rule = {
diff --git a/src/content-linter/lib/linting-rules/rai-reusable-usage.ts b/src/content-linter/lib/linting-rules/rai-reusable-usage.ts
index 05268c8d06b7..753a30570e20 100644
--- a/src/content-linter/lib/linting-rules/rai-reusable-usage.ts
+++ b/src/content-linter/lib/linting-rules/rai-reusable-usage.ts
@@ -8,8 +8,7 @@ import { getLiquidTokens, getPositionData } from '../helpers/liquid-utils'
import type { RuleParams, RuleErrorCallback, Rule } from '../../types'
interface Frontmatter {
- type?: string
- // Allow any additional frontmatter properties since we only care about 'type'
+ contentType?: string
[key: string]: unknown
}
@@ -76,5 +75,5 @@ function isFileRai(params: RuleParams): boolean {
}
const fm: Frontmatter = (getFrontmatter(params.frontMatterLines) as Frontmatter) || {}
- return fm.type === 'rai'
+ return fm.contentType === 'rai'
}
diff --git a/src/content-linter/tests/unit/rai-app-card-structure.ts b/src/content-linter/tests/unit/rai-app-card-structure.ts
index 42488bdfa9e8..863c750ef68d 100644
--- a/src/content-linter/tests/unit/rai-app-card-structure.ts
+++ b/src/content-linter/tests/unit/rai-app-card-structure.ts
@@ -121,13 +121,6 @@ describe(raiAppCardStructure.names.join(' - '), () => {
expect(errors.length).toBe(0)
})
- test('valid RAI card using legacy type: rai frontmatter produces zero errors', async () => {
- const markdown = validCard().replace('contentType: rai', 'type: rai')
- const result = await runRule(raiAppCardStructure, { strings: { markdown } })
- const errors = result.markdown
- expect(errors.length).toBe(0)
- })
-
test('non-RAI file is skipped entirely', async () => {
const markdown = [
'---',
diff --git a/src/content-linter/tests/unit/rai-resuable-usage.ts b/src/content-linter/tests/unit/rai-resuable-usage.ts
index db465de6fe47..570ded41ee98 100644
--- a/src/content-linter/tests/unit/rai-resuable-usage.ts
+++ b/src/content-linter/tests/unit/rai-resuable-usage.ts
@@ -33,7 +33,7 @@ describe(raiReusableUsage.names.join(' - '), () => {
const markdown = [
'---',
'title: article',
- 'type: rai',
+ 'contentType: rai',
'---',
'',
'{% data reusables.injectables.multiple_numbers %}',
@@ -51,7 +51,7 @@ describe(raiReusableUsage.names.join(' - '), () => {
const markdown = [
'---',
'title: article',
- 'type: rai',
+ 'contentType: rai',
'---',
'',
'{% data reusables.rai.note %}',
diff --git a/src/content-render/scripts/add-content-type.ts b/src/content-render/scripts/add-content-type.ts
index ead62e3f0cc9..92c2380e70e5 100644
--- a/src/content-render/scripts/add-content-type.ts
+++ b/src/content-render/scripts/add-content-type.ts
@@ -19,7 +19,6 @@ const OTHER_TYPE = 'other'
interface ScriptOptions {
dryRun?: boolean
paths?: string[]
- removeType?: boolean
verbose?: boolean
}
@@ -29,7 +28,6 @@ program
'-p, --paths [paths...]',
'One or more specific paths to process (e.g., copilot or content/copilot/how-tos/file.md)',
)
- .option('-r, --remove-type', `Remove the legacy 'type' frontmatter property if present`)
.option('-d, --dry-run', 'Preview changes without modifying files')
.option('-v, --verbose', 'Show detailed output of changes made')
.addHelpText(
@@ -39,10 +37,10 @@ Possible contentType values:
${contentTypesEnum.join(', ')}
Examples:
- npm run-script -- add-content-type // runs on all content files, does not remove legacy 'type' prop
- npm run-script -- add-content-type --paths copilot actions --remove-type --dry-run
- npm run-script -- add-content-type --paths content/copilot/how-tos
- npm run-script -- add-content-type --verbose`,
+ npm run add-content-type // runs on all content files
+ npm run add-content-type -- --paths copilot actions --dry-run
+ npm run add-content-type -- --paths content/copilot/how-tos
+ npm run add-content-type -- --verbose`,
)
.parse(process.argv)
@@ -99,19 +97,13 @@ function processFile(filePath: string, scriptOptions: ScriptOptions) {
if (!data) return { processed: false, updated: false }
- // Remove the legacy type property if option is passed
- const removeLegacyType = Boolean(scriptOptions.removeType && data.type)
-
- const newContentType = determineContentType(relativePath, data.type || '')
+ const newContentType = determineContentType(relativePath)
if (scriptOptions.dryRun) {
console.log(`\n${relativePath}`)
if (!data.contentType) {
console.log(` ✅ Would set contentType: "${newContentType}"`)
}
- if (removeLegacyType) {
- console.log(` ✂️ Would remove legacy type: "${data.type}"`)
- }
return { processed: true, updated: false }
}
@@ -135,27 +127,18 @@ function processFile(filePath: string, scriptOptions: ScriptOptions) {
return { processed: true, updated: false }
}
- let legacyTypeValue
- if (removeLegacyType) {
- legacyTypeValue = data.type
- delete data.type
- }
-
// Write the file back
fs.writeFileSync(filePath, frontmatter.stringify(content, data, { lineWidth: -1 } as any))
if (scriptOptions.verbose) {
console.log(`\n${relativePath}`)
console.log(` ✅ Set contentType: "${newContentType}"`)
- if (removeLegacyType) {
- console.log(` ✂️ Removed legacy type: "${legacyTypeValue}"`)
- }
}
return { processed: true, updated: true }
}
-function determineContentType(relativePath: string, legacyType: string): string {
+function determineContentType(relativePath: string): string {
// The split path array will be structured like:
// [ 'copilot', 'how-tos', 'troubleshoot', 'index.md' ]
// where the content type we want is in slot 1.
@@ -168,9 +151,8 @@ function determineContentType(relativePath: string, legacyType: string): string
if (topLevelDirectory === 'index.md') return 'homepage'
// SPECIAL HANDLING FOR RAI
- // If a legacy type includes 'rai', use it for the contentType.
// If a directory name includes a responsible-use string, assume the 'rai' type.
- if (legacyType === 'rai' || derivedContentType.includes(RESPONSIBLE_USE_STRING)) {
+ if (derivedContentType.includes(RESPONSIBLE_USE_STRING)) {
return RAI_TYPE
}
diff --git a/src/fixtures/fixtures/content/actions/category/subcategory/article.md b/src/fixtures/fixtures/content/actions/category/subcategory/article.md
index fa1d332f36e4..ab5f44d044c0 100644
--- a/src/fixtures/fixtures/content/actions/category/subcategory/article.md
+++ b/src/fixtures/fixtures/content/actions/category/subcategory/article.md
@@ -6,7 +6,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
---
## First sub-heading
diff --git a/src/fixtures/fixtures/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise.md b/src/fixtures/fixtures/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise.md
index 36c8f6bb82bc..053b0923544f 100644
--- a/src/fixtures/fixtures/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise.md
+++ b/src/fixtures/fixtures/content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise.md
@@ -12,7 +12,7 @@ redirect_from:
versions:
ghec: '*'
ghes: '*'
-type: reference
+contentType: reference
topics:
- Auditing
- Enterprise
diff --git a/src/fixtures/fixtures/content/code-security/codeql-cli/codeql-cli-manual/database-analyze.md b/src/fixtures/fixtures/content/code-security/codeql-cli/codeql-cli-manual/database-analyze.md
index 7c15fa25285e..28204f54b1db 100644
--- a/src/fixtures/fixtures/content/code-security/codeql-cli/codeql-cli-manual/database-analyze.md
+++ b/src/fixtures/fixtures/content/code-security/codeql-cli/codeql-cli-manual/database-analyze.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghec: '*'
ghes: '*'
-type: reference
+contentType: reference
product: Code Security
autogenerated: codeql-cli
---
diff --git a/src/fixtures/fixtures/content/code-security/getting-started/index.md b/src/fixtures/fixtures/content/code-security/getting-started/index.md
index 8a5fc302a396..adb77ab513ff 100644
--- a/src/fixtures/fixtures/content/code-security/getting-started/index.md
+++ b/src/fixtures/fixtures/content/code-security/getting-started/index.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: quick_start
+contentType: get-started
topics:
- Pull requests
- Fundamentals
diff --git a/src/fixtures/fixtures/content/code-security/getting-started/quickstart.md b/src/fixtures/fixtures/content/code-security/getting-started/quickstart.md
index e3b70f1df469..e593e179542a 100644
--- a/src/fixtures/fixtures/content/code-security/getting-started/quickstart.md
+++ b/src/fixtures/fixtures/content/code-security/getting-started/quickstart.md
@@ -5,7 +5,7 @@ allowTitleToDifferFromFilename: true
versions:
fpt: '*'
ghec: '*'
-type: quick_start
+contentType: get-started
topics:
- Codespaces
---
diff --git a/src/fixtures/fixtures/content/code-security/getting-started/securing-your-organization.md b/src/fixtures/fixtures/content/code-security/getting-started/securing-your-organization.md
index 19afd4b6892a..73286f33f7b8 100644
--- a/src/fixtures/fixtures/content/code-security/getting-started/securing-your-organization.md
+++ b/src/fixtures/fixtures/content/code-security/getting-started/securing-your-organization.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
topics:
- Organizations
- Dependencies
diff --git a/src/fixtures/fixtures/content/code-security/secret-scanning/introduction/supported-secret-scanning-patterns.md b/src/fixtures/fixtures/content/code-security/secret-scanning/introduction/supported-secret-scanning-patterns.md
index fc0c866631af..5c90c0388fbd 100644
--- a/src/fixtures/fixtures/content/code-security/secret-scanning/introduction/supported-secret-scanning-patterns.md
+++ b/src/fixtures/fixtures/content/code-security/secret-scanning/introduction/supported-secret-scanning-patterns.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: reference
+contentType: reference
autogenerated: secret-scanning
---
diff --git a/src/fixtures/fixtures/content/get-started/empty-categories/only-ghec.md b/src/fixtures/fixtures/content/get-started/empty-categories/only-ghec.md
index cf1ca6a1060a..ab35f7b3940a 100644
--- a/src/fixtures/fixtures/content/get-started/empty-categories/only-ghec.md
+++ b/src/fixtures/fixtures/content/get-started/empty-categories/only-ghec.md
@@ -4,7 +4,7 @@ intro: Empty categories only ghec
shortTitle: Empty categories only ghec
versions:
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Exclusive heading
diff --git a/src/fixtures/fixtures/content/get-started/foo/anchor-autotitling.md b/src/fixtures/fixtures/content/get-started/foo/anchor-autotitling.md
index 692e00e0d298..e90de31c3384 100644
--- a/src/fixtures/fixtures/content/get-started/foo/anchor-autotitling.md
+++ b/src/fixtures/fixtures/content/get-started/foo/anchor-autotitling.md
@@ -4,7 +4,7 @@ intro: If the author use an anchor link for AUTOTITLE it should fail
versions:
fpt: '*'
ghes: '*'
-type: how_to
+contentType: how-tos
---
## Introduction
diff --git a/src/fixtures/fixtures/content/get-started/foo/autotitling.md b/src/fixtures/fixtures/content/get-started/foo/autotitling.md
index c99fd530bfe6..c36205bc7704 100644
--- a/src/fixtures/fixtures/content/get-started/foo/autotitling.md
+++ b/src/fixtures/fixtures/content/get-started/foo/autotitling.md
@@ -6,7 +6,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Introduction
diff --git a/src/fixtures/fixtures/content/get-started/foo/cross-version-linking.md b/src/fixtures/fixtures/content/get-started/foo/cross-version-linking.md
index 64ffe0a80011..f5b9a39e2afd 100644
--- a/src/fixtures/fixtures/content/get-started/foo/cross-version-linking.md
+++ b/src/fixtures/fixtures/content/get-started/foo/cross-version-linking.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Get right into it
diff --git a/src/fixtures/fixtures/content/get-started/foo/typo-autotitling.md b/src/fixtures/fixtures/content/get-started/foo/typo-autotitling.md
index 6ad96bf19517..7d35715517f7 100644
--- a/src/fixtures/fixtures/content/get-started/foo/typo-autotitling.md
+++ b/src/fixtures/fixtures/content/get-started/foo/typo-autotitling.md
@@ -4,7 +4,7 @@ intro: If the author typos the word "AUTOTITLE" it will throw
versions:
fpt: '*'
ghes: '*'
-type: how_to
+contentType: how-tos
---
## Example
diff --git a/src/fixtures/fixtures/content/get-started/images/images-in-lists.md b/src/fixtures/fixtures/content/get-started/images/images-in-lists.md
index a0b7313a5162..237ad23da21c 100644
--- a/src/fixtures/fixtures/content/get-started/images/images-in-lists.md
+++ b/src/fixtures/fixtures/content/get-started/images/images-in-lists.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## A numbered list with images
diff --git a/src/fixtures/fixtures/content/get-started/images/link-to-image.md b/src/fixtures/fixtures/content/get-started/images/link-to-image.md
index 657718dfdc21..54c1d934b3e9 100644
--- a/src/fixtures/fixtures/content/get-started/images/link-to-image.md
+++ b/src/fixtures/fixtures/content/get-started/images/link-to-image.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Expand your mind
diff --git a/src/fixtures/fixtures/content/get-started/images/retina-image.md b/src/fixtures/fixtures/content/get-started/images/retina-image.md
index 5e7d2bf0b53b..f592ff2bd904 100644
--- a/src/fixtures/fixtures/content/get-started/images/retina-image.md
+++ b/src/fixtures/fixtures/content/get-started/images/retina-image.md
@@ -5,7 +5,7 @@ versions:
fpt: "*"
ghes: "*"
ghec: "*"
-type: how_to
+contentType: how-tos
---
## An image
diff --git a/src/fixtures/fixtures/content/get-started/images/single-image.md b/src/fixtures/fixtures/content/get-started/images/single-image.md
index 2ad25238fdbb..717e0ef1d4e3 100644
--- a/src/fixtures/fixtures/content/get-started/images/single-image.md
+++ b/src/fixtures/fixtures/content/get-started/images/single-image.md
@@ -5,7 +5,7 @@ versions:
fpt: "*"
ghes: "*"
ghec: "*"
-type: how_to
+contentType: how-tos
---
## An image
diff --git a/src/fixtures/fixtures/content/get-started/liquid/danger.md b/src/fixtures/fixtures/content/get-started/liquid/danger.md
index 7a7c6cbefec8..c05c666c7acc 100644
--- a/src/fixtures/fixtures/content/get-started/liquid/danger.md
+++ b/src/fixtures/fixtures/content/get-started/liquid/danger.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Introduction
diff --git a/src/fixtures/fixtures/content/get-started/liquid/data.md b/src/fixtures/fixtures/content/get-started/liquid/data.md
index c343338be1ea..327f3c4001bf 100644
--- a/src/fixtures/fixtures/content/get-started/liquid/data.md
+++ b/src/fixtures/fixtures/content/get-started/liquid/data.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Introduction
diff --git a/src/fixtures/fixtures/content/get-started/liquid/ifversion.md b/src/fixtures/fixtures/content/get-started/liquid/ifversion.md
index 520dbd4c7271..23f85b63ecf0 100644
--- a/src/fixtures/fixtures/content/get-started/liquid/ifversion.md
+++ b/src/fixtures/fixtures/content/get-started/liquid/ifversion.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## ifversion without operators
diff --git a/src/fixtures/fixtures/content/get-started/liquid/links-with-liquid.md b/src/fixtures/fixtures/content/get-started/liquid/links-with-liquid.md
index 6f8eea0d4c0e..af773cf03076 100644
--- a/src/fixtures/fixtures/content/get-started/liquid/links-with-liquid.md
+++ b/src/fixtures/fixtures/content/get-started/liquid/links-with-liquid.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Introduction
diff --git a/src/fixtures/fixtures/content/get-started/liquid/notes.md b/src/fixtures/fixtures/content/get-started/liquid/notes.md
index 16772f914fc9..bb19002f5ed9 100644
--- a/src/fixtures/fixtures/content/get-started/liquid/notes.md
+++ b/src/fixtures/fixtures/content/get-started/liquid/notes.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Introduction
diff --git a/src/fixtures/fixtures/content/get-started/liquid/platform-specific.md b/src/fixtures/fixtures/content/get-started/liquid/platform-specific.md
index b470e7064bf6..db8ffddbc325 100644
--- a/src/fixtures/fixtures/content/get-started/liquid/platform-specific.md
+++ b/src/fixtures/fixtures/content/get-started/liquid/platform-specific.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
defaultPlatform: windows
---
diff --git a/src/fixtures/fixtures/content/get-started/liquid/raw.md b/src/fixtures/fixtures/content/get-started/liquid/raw.md
index 0d1ea2c61cfb..94c5d6b95295 100644
--- a/src/fixtures/fixtures/content/get-started/liquid/raw.md
+++ b/src/fixtures/fixtures/content/get-started/liquid/raw.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Introduction
diff --git a/src/fixtures/fixtures/content/get-started/liquid/table-row-headers.md b/src/fixtures/fixtures/content/get-started/liquid/table-row-headers.md
index 54f22997daae..b02b1b16b4af 100644
--- a/src/fixtures/fixtures/content/get-started/liquid/table-row-headers.md
+++ b/src/fixtures/fixtures/content/get-started/liquid/table-row-headers.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Example table
diff --git a/src/fixtures/fixtures/content/get-started/liquid/tips.md b/src/fixtures/fixtures/content/get-started/liquid/tips.md
index 544703f7d054..e459a196a3c2 100644
--- a/src/fixtures/fixtures/content/get-started/liquid/tips.md
+++ b/src/fixtures/fixtures/content/get-started/liquid/tips.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Introduction
diff --git a/src/fixtures/fixtures/content/get-started/liquid/tool-picker-issue.md b/src/fixtures/fixtures/content/get-started/liquid/tool-picker-issue.md
index d60e7041a471..e1787e1d4fbd 100644
--- a/src/fixtures/fixtures/content/get-started/liquid/tool-picker-issue.md
+++ b/src/fixtures/fixtures/content/get-started/liquid/tool-picker-issue.md
@@ -6,7 +6,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
---
## Starting a review
diff --git a/src/fixtures/fixtures/content/get-started/liquid/tool-platform-switcher.md b/src/fixtures/fixtures/content/get-started/liquid/tool-platform-switcher.md
index 4d88b7cb69ad..1b575988a856 100644
--- a/src/fixtures/fixtures/content/get-started/liquid/tool-platform-switcher.md
+++ b/src/fixtures/fixtures/content/get-started/liquid/tool-platform-switcher.md
@@ -7,7 +7,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
---
## Running a workflow
diff --git a/src/fixtures/fixtures/content/get-started/liquid/tool-specific.md b/src/fixtures/fixtures/content/get-started/liquid/tool-specific.md
index d19398730498..5d86ea10bcef 100644
--- a/src/fixtures/fixtures/content/get-started/liquid/tool-specific.md
+++ b/src/fixtures/fixtures/content/get-started/liquid/tool-specific.md
@@ -6,7 +6,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: tutorial
+contentType: tutorials
---
## Running a workflow
diff --git a/src/fixtures/fixtures/content/get-started/liquid/warnings.md b/src/fixtures/fixtures/content/get-started/liquid/warnings.md
index bd6ac148e895..58572fc6a9e6 100644
--- a/src/fixtures/fixtures/content/get-started/liquid/warnings.md
+++ b/src/fixtures/fixtures/content/get-started/liquid/warnings.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Introduction
diff --git a/src/fixtures/fixtures/content/get-started/liquid/whitespace.md b/src/fixtures/fixtures/content/get-started/liquid/whitespace.md
index 47482c3c10dc..b4e96355c8ff 100644
--- a/src/fixtures/fixtures/content/get-started/liquid/whitespace.md
+++ b/src/fixtures/fixtures/content/get-started/liquid/whitespace.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Paragraphs
diff --git a/src/fixtures/fixtures/content/get-started/markdown/alerts.md b/src/fixtures/fixtures/content/get-started/markdown/alerts.md
index 85769b84b97d..378ad89ab86e 100644
--- a/src/fixtures/fixtures/content/get-started/markdown/alerts.md
+++ b/src/fixtures/fixtures/content/get-started/markdown/alerts.md
@@ -6,7 +6,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Tip
diff --git a/src/fixtures/fixtures/content/get-started/markdown/code-annotations.md b/src/fixtures/fixtures/content/get-started/markdown/code-annotations.md
index 4b211112bcd7..9329e70fe024 100644
--- a/src/fixtures/fixtures/content/get-started/markdown/code-annotations.md
+++ b/src/fixtures/fixtures/content/get-started/markdown/code-annotations.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
layout: inline
---
diff --git a/src/fixtures/fixtures/content/get-started/markdown/html-comments.md b/src/fixtures/fixtures/content/get-started/markdown/html-comments.md
index 29fc6225a266..3633c424268a 100644
--- a/src/fixtures/fixtures/content/get-started/markdown/html-comments.md
+++ b/src/fixtures/fixtures/content/get-started/markdown/html-comments.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Introduction
diff --git a/src/fixtures/fixtures/content/get-started/markdown/intro.md b/src/fixtures/fixtures/content/get-started/markdown/intro.md
index a232fd69245d..57d8997f24c3 100644
--- a/src/fixtures/fixtures/content/get-started/markdown/intro.md
+++ b/src/fixtures/fixtures/content/get-started/markdown/intro.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Introduction
diff --git a/src/fixtures/fixtures/content/get-started/markdown/permissions.md b/src/fixtures/fixtures/content/get-started/markdown/permissions.md
index 94728c3e1d17..e0972a7450ef 100644
--- a/src/fixtures/fixtures/content/get-started/markdown/permissions.md
+++ b/src/fixtures/fixtures/content/get-started/markdown/permissions.md
@@ -6,7 +6,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Introduction
diff --git a/src/fixtures/fixtures/content/get-started/minitocs/markup-heading.md b/src/fixtures/fixtures/content/get-started/minitocs/markup-heading.md
index e261628a12b5..8f6c19d191d4 100644
--- a/src/fixtures/fixtures/content/get-started/minitocs/markup-heading.md
+++ b/src/fixtures/fixtures/content/get-started/minitocs/markup-heading.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
Here is content with multiple subheadings.
diff --git a/src/fixtures/fixtures/content/get-started/minitocs/multiple-headings.md b/src/fixtures/fixtures/content/get-started/minitocs/multiple-headings.md
index 1b62357e3888..6878ecf04aeb 100644
--- a/src/fixtures/fixtures/content/get-started/minitocs/multiple-headings.md
+++ b/src/fixtures/fixtures/content/get-started/minitocs/multiple-headings.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
Here is content with multiple subheadings.
diff --git a/src/fixtures/fixtures/content/get-started/minitocs/no-heading.md b/src/fixtures/fixtures/content/get-started/minitocs/no-heading.md
index a506445e93ee..da3ade90e1c6 100644
--- a/src/fixtures/fixtures/content/get-started/minitocs/no-heading.md
+++ b/src/fixtures/fixtures/content/get-started/minitocs/no-heading.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
Here is some content with no heading.
diff --git a/src/fixtures/fixtures/content/get-started/minitocs/one-heading.md b/src/fixtures/fixtures/content/get-started/minitocs/one-heading.md
index bde6e1d068ff..ca47fae384be 100644
--- a/src/fixtures/fixtures/content/get-started/minitocs/one-heading.md
+++ b/src/fixtures/fixtures/content/get-started/minitocs/one-heading.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Single heading
diff --git a/src/fixtures/fixtures/content/get-started/start-your-journey/api-article-body-test-page.md b/src/fixtures/fixtures/content/get-started/start-your-journey/api-article-body-test-page.md
index 9bd0a3dd5f87..70cf0fe8eae9 100644
--- a/src/fixtures/fixtures/content/get-started/start-your-journey/api-article-body-test-page.md
+++ b/src/fixtures/fixtures/content/get-started/start-your-journey/api-article-body-test-page.md
@@ -6,7 +6,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: overview
+contentType: concepts
topics:
- Git
- Fundamentals
diff --git a/src/fixtures/fixtures/content/get-started/start-your-journey/dynamic-title.md b/src/fixtures/fixtures/content/get-started/start-your-journey/dynamic-title.md
index 98712ed200b6..74757e890135 100644
--- a/src/fixtures/fixtures/content/get-started/start-your-journey/dynamic-title.md
+++ b/src/fixtures/fixtures/content/get-started/start-your-journey/dynamic-title.md
@@ -4,7 +4,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: quick_start
+contentType: get-started
---
## Introduction
diff --git a/src/fixtures/fixtures/content/get-started/start-your-journey/hello-world.md b/src/fixtures/fixtures/content/get-started/start-your-journey/hello-world.md
index 0965bc149f8f..20fad0f4df2c 100644
--- a/src/fixtures/fixtures/content/get-started/start-your-journey/hello-world.md
+++ b/src/fixtures/fixtures/content/get-started/start-your-journey/hello-world.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: quick_start
+contentType: get-started
topics:
- Pull requests
- Fundamentals
diff --git a/src/fixtures/fixtures/content/get-started/start-your-journey/link-rewriting.md b/src/fixtures/fixtures/content/get-started/start-your-journey/link-rewriting.md
index e3eadce8c368..3cb61ea8a2dd 100644
--- a/src/fixtures/fixtures/content/get-started/start-your-journey/link-rewriting.md
+++ b/src/fixtures/fixtures/content/get-started/start-your-journey/link-rewriting.md
@@ -5,7 +5,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: quick_start
+contentType: get-started
---
## Internal links never need language prefix
diff --git a/src/fixtures/fixtures/content/get-started/versioning/only-fpt.md b/src/fixtures/fixtures/content/get-started/versioning/only-fpt.md
index 90f52ce090af..6f01024b249d 100644
--- a/src/fixtures/fixtures/content/get-started/versioning/only-fpt.md
+++ b/src/fixtures/fixtures/content/get-started/versioning/only-fpt.md
@@ -3,7 +3,7 @@ title: Only in Free, Pro, & Team
intro: Only in one version, and it's the fpt one
versions:
fpt: '*'
-type: how_to
+contentType: how-tos
---
## Sample heading
diff --git a/src/fixtures/fixtures/content/get-started/versioning/only-ghec-and-ghes.md b/src/fixtures/fixtures/content/get-started/versioning/only-ghec-and-ghes.md
index cbaf64dd4440..c486d34deaed 100644
--- a/src/fixtures/fixtures/content/get-started/versioning/only-ghec-and-ghes.md
+++ b/src/fixtures/fixtures/content/get-started/versioning/only-ghec-and-ghes.md
@@ -4,7 +4,7 @@ intro: Only in two versions, and it's the ghec and ghes
versions:
ghec: '*'
ghes: '*'
-type: how_to
+contentType: how-tos
---
## Exclusive heading
diff --git a/src/fixtures/fixtures/content/get-started/versioning/only-ghec.md b/src/fixtures/fixtures/content/get-started/versioning/only-ghec.md
index 7e68f70d2a8b..6576cab2b492 100644
--- a/src/fixtures/fixtures/content/get-started/versioning/only-ghec.md
+++ b/src/fixtures/fixtures/content/get-started/versioning/only-ghec.md
@@ -3,7 +3,7 @@ title: Only in Enterprise Cloud
intro: Only in one version, and it's the ghec one
versions:
ghec: '*'
-type: how_to
+contentType: how-tos
---
## Exclusive heading
diff --git a/src/fixtures/fixtures/content/pages/quickstart.md b/src/fixtures/fixtures/content/pages/quickstart.md
index bf7dcdb23fc5..c6d59c0dd56f 100644
--- a/src/fixtures/fixtures/content/pages/quickstart.md
+++ b/src/fixtures/fixtures/content/pages/quickstart.md
@@ -6,7 +6,7 @@ versions:
fpt: '*'
ghes: '*'
ghec: '*'
-type: quick_start
+contentType: get-started
permissions: These are permissions details, for more pages info start at the beginning with this [article intro link](#introduction). Also here's [another link](/get-started/start-your-journey/hello-world).
topics:
- Pages
diff --git a/src/fixtures/fixtures/data/ui.yml b/src/fixtures/fixtures/data/ui.yml
index b008831d4fdb..a9412e255088 100644
--- a/src/fixtures/fixtures/data/ui.yml
+++ b/src/fixtures/fixtures/data/ui.yml
@@ -321,10 +321,10 @@ product_guides:
one: 1 guide found
none: No guides found
guide_types:
- overview: Overview
- quick_start: Quickstart
- tutorial: Tutorial
- how_to: How-to guide
+ get-started: Quickstart
+ concepts: Concepts
+ how-tos: How-to guide
+ tutorials: Tutorial
reference: Reference
learning_track_nav:
prev_guide: Previous
diff --git a/src/frame/components/DefaultLayout.tsx b/src/frame/components/DefaultLayout.tsx
index 768b1f2a3247..57cc0046a127 100644
--- a/src/frame/components/DefaultLayout.tsx
+++ b/src/frame/components/DefaultLayout.tsx
@@ -163,7 +163,6 @@ export const DefaultLayout = (props: Props) => {
content={relativePath.replace('/index.md', '').replace('.md', '')}
/>
)}
- {page.type && }
{page.contentType && }
{page.documentType && }
{status && }
diff --git a/src/frame/components/context/MainContext.tsx b/src/frame/components/context/MainContext.tsx
index 560aff136184..e027c6b8871f 100644
--- a/src/frame/components/context/MainContext.tsx
+++ b/src/frame/components/context/MainContext.tsx
@@ -118,7 +118,6 @@ export type MainContextT = {
nonEnterpriseDefaultVersion: string
page: {
documentType: string
- type?: string
contentType?: string
topics: Array
title: string
@@ -222,7 +221,6 @@ export const getMainContext = async (req: any, res: any): Promise
const pageInfo =
(page && {
documentType,
- type: req.context.page.type || null,
contentType: req.context.page.contentType || null,
title: req.context.page.title,
fullTitle: req.context.page.fullTitle || null,
diff --git a/src/frame/lib/frontmatter.ts b/src/frame/lib/frontmatter.ts
index 0d4dc7ee5da6..fde3e07e81d9 100644
--- a/src/frame/lib/frontmatter.ts
+++ b/src/frame/lib/frontmatter.ts
@@ -47,12 +47,7 @@ const layoutNames = [
false,
]
-// DEPRECATED: Use 'contentType' instead of 'type' for new content.
-// 'type' exists on ~40% of files but is used only for internal analytics.
-// Migration tool: src/content-render/scripts/add-content-type.ts
-const guideTypes = ['overview', 'quick_start', 'tutorial', 'how_to', 'reference', 'rai']
-
-// As of July 2025, use 'contentType' rather than 'type'.
+// Content type values derived from directory structure.
export const contentTypesEnum = [
'get-started',
'concepts',
@@ -203,14 +198,6 @@ export const schema: Schema = {
enum: ['builder', 'driver'],
},
},
- // DEPRECATED: Use 'contentType' instead of 'type' for new content.
- // 'type' exists on ~40% of files but is used only for internal analytics.
- // Migration tool: src/content-render/scripts/add-content-type.ts
- type: {
- type: 'string',
- enum: guideTypes,
- },
- // As of July 2025, use 'contentType' rather than 'type'.
contentType: {
type: 'string',
enum: contentTypesEnum,
diff --git a/src/frame/lib/page.ts b/src/frame/lib/page.ts
index bd0079211673..8c70d2ad80db 100644
--- a/src/frame/lib/page.ts
+++ b/src/frame/lib/page.ts
@@ -57,10 +57,10 @@ type CommunityRedirect = {
href: string
}
-type GuideWithType = {
+type GuideWithContentType = {
href: string
title: string
- type?: string
+ contentType?: string
topics?: string[]
}
@@ -91,7 +91,7 @@ class Page {
public redirect_from?: string[]
public learningTracks?: any[]
public rawLearningTracks?: string[]
- public includeGuides?: GuideWithType[]
+ public includeGuides?: GuideWithContentType[]
public rawIncludeGuides?: string[]
public introLinks?: Record
public rawIntroLinks?: Record
@@ -378,10 +378,13 @@ class Page {
}
if (this.rawIncludeGuides) {
- this.includeGuides = (await getLinkData(this.rawIncludeGuides, context)) as GuideWithType[]
+ this.includeGuides = (await getLinkData(
+ this.rawIncludeGuides,
+ context,
+ )) as GuideWithContentType[]
this.includeGuides?.map((guide: any) => {
const { page } = guide
- guide.type = page.type
+ guide.contentType = page.contentType
if (page.topics) {
guide.topics = page.topics
}
diff --git a/src/landings/components/ArticleCards.tsx b/src/landings/components/ArticleCards.tsx
index 7d6ef5f54db7..c229f9458ce2 100644
--- a/src/landings/components/ArticleCards.tsx
+++ b/src/landings/components/ArticleCards.tsx
@@ -34,7 +34,7 @@ export const ArticleCards = () => {
)
})}
diff --git a/src/landings/components/ProductGuidesContext.tsx b/src/landings/components/ProductGuidesContext.tsx
index d79cbc216003..530d33c852cb 100644
--- a/src/landings/components/ProductGuidesContext.tsx
+++ b/src/landings/components/ProductGuidesContext.tsx
@@ -7,14 +7,14 @@ export type LearningTrack = {
trackProduct: string
title: string
description: string
- guides?: Array<{ href: string; type: string | null; title: string; intro: string }>
+ guides?: Array<{ href: string; contentType: string | null; title: string; intro: string }>
}
export type ArticleGuide = {
href: string
title: string
intro: string
- type: string
+ contentType: string
topics: Array
}
@@ -60,7 +60,7 @@ export const getProductGuidesContextFromRequest = (req: ExtendedRequest): Produc
title: (guide.title as string) || '',
intro: (guide.intro as string) || '',
href: (guide.href as string) || '',
- type: ((guide.page as any)?.type as string) || null,
+ contentType: ((guide.page as any)?.contentType as string) || null,
}),
),
}),
@@ -76,7 +76,7 @@ export const getProductGuidesContextFromRequest = (req: ExtendedRequest): Produc
href: (guide.href as string) || '',
title: (guide.title as string) || '',
intro: (guide.intro as string) || '',
- type: (guide.type as string) || '',
+ contentType: (guide.contentType as string) || '',
topics: (guide.topics as Array) || [],
}
}),
diff --git a/src/learning-track/components/guides/LearningTrack.tsx b/src/learning-track/components/guides/LearningTrack.tsx
index c5acf10e92a6..83422a5d9c3f 100644
--- a/src/learning-track/components/guides/LearningTrack.tsx
+++ b/src/learning-track/components/guides/LearningTrack.tsx
@@ -31,7 +31,9 @@ export const LearningTrack = ({ track }: Props) => {
{track.guides.map((guide) => (
- {tObject('guide_types')[guide.type || ''] as string}
+
+ {tObject('guide_types')[guide.contentType || ''] as string}
+
`\n - ${file}`).join('')
const listUnallowedFiles = filters.notAllowed.map((file: string) => `\n - ${file}`).join('')
- const reviewMessage = `👋 Hey there spelunker. It looks like you've modified some files that we can't accept as contributions:${listUnallowedChangedFiles}\n\nYou'll need to revert all of the files you changed that match that list using [GitHub Desktop](https://docs.github.com/en/free-pro-team@latest/desktop/contributing-and-collaborating-using-github-desktop/managing-commits/reverting-a-commit-in-github-desktop) or \`git checkout origin/main \`. Once you get those files reverted, we can continue with the review process. :octocat:\n\nThe complete list of files we can't accept are:${listUnallowedFiles}\n\nWe also can't accept contributions to files in the content directory with frontmatter \`type: rai\` or \`contentType: rai\`.`
+ const reviewMessage = `👋 Hey there spelunker. It looks like you've modified some files that we can't accept as contributions:${listUnallowedChangedFiles}\n\nYou'll need to revert all of the files you changed that match that list using [GitHub Desktop](https://docs.github.com/en/free-pro-team@latest/desktop/contributing-and-collaborating-using-github-desktop/managing-commits/reverting-a-commit-in-github-desktop) or \`git checkout origin/main \`. Once you get those files reverted, we can continue with the review process. :octocat:\n\nThe complete list of files we can't accept are:${listUnallowedFiles}\n\nWe also can't accept contributions to files in the content directory with frontmatter \`contentType: rai\`.`
let workflowFailMessage =
"It looks like you've modified some files that we can't accept as contributions."
From 15b722db909a6a2caf6ce463f55619cefcb1abd3 Mon Sep 17 00:00:00 2001
From: Stacy Carter
Date: Thu, 12 Mar 2026 15:30:14 -0400
Subject: [PATCH 6/8] Clarify certain details about the EMU setup user account
(#60162)
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Laura Coursen
---
.../concepts/identity-and-access-management/setup-user.md | 6 +++---
.../getting-started-with-enterprise-managed-users.md | 8 +++++---
2 files changed, 8 insertions(+), 6 deletions(-)
diff --git a/content/admin/concepts/identity-and-access-management/setup-user.md b/content/admin/concepts/identity-and-access-management/setup-user.md
index 22ec8db331d2..67d444fb6fcd 100644
--- a/content/admin/concepts/identity-and-access-management/setup-user.md
+++ b/content/admin/concepts/identity-and-access-management/setup-user.md
@@ -29,8 +29,8 @@ When you create the password, we strongly recommend that you **enable two-factor
Unlike provisioned managed users, the setup user cannot sign in via SSO.
-- **Without 2FA enabled**, you must provide a recovery code **every** time you sign in.
-- If **2FA is enabled**, you can sign in with a successful 2FA challenge response. You only need to provide a recovery code to access enterprise settings.
+- **Without 2FA enabled**, you must provide an enterprise recovery code **every** time you sign in.
+- If **2FA is enabled**, you must sign in with a successful 2FA challenge response. You only need to enter an enterprise recovery code to access enterprise settings.
{% data reusables.enterprise-accounts.emu-password-reset-session %}
@@ -40,4 +40,4 @@ The setup user **cannot** be deleted, because it is essential for maintaining au
## Further reading
-- [AUTOTITLE](/admin/managing-iam/managing-recovery-codes-for-your-enterprise/downloading-your-enterprise-accounts-single-sign-on-recovery-codes#downloading-codes-for-an-enterprise-with-enterprise-managed-users)
\ No newline at end of file
+- [AUTOTITLE](/admin/managing-iam/managing-recovery-codes-for-your-enterprise/downloading-your-enterprise-accounts-single-sign-on-recovery-codes#downloading-codes-for-an-enterprise-with-enterprise-managed-users)
diff --git a/content/admin/managing-iam/understanding-iam-for-enterprises/getting-started-with-enterprise-managed-users.md b/content/admin/managing-iam/understanding-iam-for-enterprises/getting-started-with-enterprise-managed-users.md
index 4723a7a5d706..a5790d32c905 100644
--- a/content/admin/managing-iam/understanding-iam-for-enterprises/getting-started-with-enterprise-managed-users.md
+++ b/content/admin/managing-iam/understanding-iam-for-enterprises/getting-started-with-enterprise-managed-users.md
@@ -26,15 +26,17 @@ The setup process for the environments is similar. However, you will need to **p
## Create the setup user
-After we create your enterprise, you will receive an email inviting you to choose a password for the setup user, which is used to configure authentication and provisioning. The username is your enterprise's shortcode (chosen by you or randomly generated), suffixed with `_admin`. For example: `fabrikam_admin`.
+After we create your enterprise, you will receive an email inviting you to choose a password for the setup user, which is used to configure authentication and provisioning. This is the first enterprise owner account, and the only user account in the enterprise that is not SCIM-provisioned. The username is your enterprise's shortcode (chosen by you or randomly generated), suffixed with `_admin`. For example: `fabrikam_admin`.
Using an **incognito or private browsing window**:
1. Set the user's password.
-1. Enable two-factor authentication (2FA), and save the recovery codes. See [AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication).
+1. Enable two-factor authentication (2FA) for the setup user account, and save the recovery codes. See [AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication).
> [!WARNING]
- > All subsequent login attempts for the setup user account will require a successful 2FA challenge response.
+ > All subsequent login attempts to the setup user account will require a successful 2FA challenge response.
+1. Download the enterprise recovery codes. See [AUTOTITLE](/admin/managing-iam/managing-recovery-codes-for-your-enterprise/downloading-your-enterprise-accounts-single-sign-on-recovery-codes).
+
{% data reusables.enterprise-accounts.emu-recommend-password-manager %}
{% data reusables.enterprise-accounts.about-setup-user %}
From aae6f168f92d4bfcaf5689997e84a982e371f9db Mon Sep 17 00:00:00 2001
From: Ryosuke Nakayama
Date: Fri, 13 Mar 2026 04:30:17 +0900
Subject: [PATCH 7/8] Update the GHES "Attaching files" page with the latest
information (#60100)
---
.../attaching-files.md | 11 -----------
1 file changed, 11 deletions(-)
diff --git a/content/get-started/writing-on-github/working-with-advanced-formatting/attaching-files.md b/content/get-started/writing-on-github/working-with-advanced-formatting/attaching-files.md
index 4ab34e02f6e6..ccf930649912 100644
--- a/content/get-started/writing-on-github/working-with-advanced-formatting/attaching-files.md
+++ b/content/get-started/writing-on-github/working-with-advanced-formatting/attaching-files.md
@@ -16,20 +16,9 @@ category:
- Write and format content
---
-{% ifversion ghes %}
-
-> [!WARNING]
-> When you upload an image or video to a pull request or issue comment, or upload a file to a ticket in the {% data variables.contact.landing_page_portal %}, anyone can view the anonymized URL without authentication, even if the pull request or issue is in a private repository, or if private mode is enabled. To keep sensitive media files private, serve them from a private network or server that requires authentication.
-
-{% endif %}
-
-{% ifversion fpt or ghec %}
-
> [!NOTE]
> For public repositories, uploaded files can be accessed without authentication. In the case of private and internal repositories, only people with access to the repository can view the uploaded files.
-{% endif %}
-
To attach a file to an issue or pull request conversation, drag and drop it into the comment box.
Alternatively, you can click {% octicon "paperclip" aria-label="Attach files" %} below the issue comment box to browse, select, and add a file from your computer.
From 48b7036dbda1d9072ddcb8e86231d10beb595b95 Mon Sep 17 00:00:00 2001
From: Copilot <198982749+Copilot@users.noreply.github.com>
Date: Thu, 12 Mar 2026 19:32:54 +0000
Subject: [PATCH 8/8] Handle bot authors (e.g. dependabot[bot]) in
ready-for-docs-review (#60194)
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: mario-campos <1663284+mario-campos@users.noreply.github.com>
---
src/workflows/ready-for-docs-review.ts | 12 +++++++++---
1 file changed, 9 insertions(+), 3 deletions(-)
diff --git a/src/workflows/ready-for-docs-review.ts b/src/workflows/ready-for-docs-review.ts
index 7eb15436dc33..c032261fc94a 100644
--- a/src/workflows/ready-for-docs-review.ts
+++ b/src/workflows/ready-for-docs-review.ts
@@ -155,10 +155,16 @@ async function run() {
const size = getSize(data)
const sizeType = findSingleSelectID(size, 'Size', data)
+ // Check if the author is a bot account (e.g. dependabot[bot], github-actions[bot]).
+ // GitHub bot logins end with '[bot]' and cannot be resolved as regular GitHub users,
+ // so we skip any user-specific GraphQL queries for them.
+ const isBotAuthor = (process.env.AUTHOR_LOGIN || '').endsWith('[bot]')
+
// If this is the OS repo, determine if this is a first time contributor
// If yes, set the author to 'first time contributor' instead of to the author login
+ // Bot accounts (e.g. dependabot[bot]) are not resolvable as GitHub users, so skip this check.
let firstTimeContributor
- if (process.env.REPO === 'github/docs') {
+ if (!isBotAuthor && process.env.REPO === 'github/docs') {
const contributorData: Record = await graphql(
`
query ($author: String!) {
@@ -242,8 +248,8 @@ async function run() {
// Determine which variable to use for the contributor type
let contributorType
- if (isCopilotAuthor) {
- // Treat Copilot PRs as Docs team
+ if (isCopilotAuthor || isBotAuthor) {
+ // Treat Copilot and bot-authored PRs (e.g. dependabot[bot]) as Docs team
contributorType = docsMemberTypeID
} else if (await isDocsTeamMember(process.env.AUTHOR_LOGIN || '')) {
contributorType = docsMemberTypeID