document journeyTracks frontmatter ✏️ (#57976)

Co-authored-by: Copilot <[email protected]>

Author: rsese

content/README.md

@@ -25,6 +25,7 @@ See the [contributing docs](https://docs.github.com/en/contributing) for general
   - [`defaultTool`](#defaulttool)
   - [`learningTracks`](#learningtracks)
   - [`includeGuides`](#includeguides)
+  - [`journeyTracks`](#journeytracks)
   - [`type`](#type)
   - [`topics`](#topics)
   - [`communityRedirect`](#communityRedirect)
@@ -252,6 +253,35 @@ includeGuides:
   - /actions/guides/building-and-testing-powershell
 ```
 
+### `journeyTracks`
+- Purpose: Define journeys for journey landing pages.
+- Type: `Array` of objects with the following properties:
+  - `id` (required): Unique identifier for the journey. The id only needs to be unique for journeys within a single journey landing page.
+  - `title` (required): Display title for the journey (supports Liquid variables)
+  - `description` (optional): Description of the journey (supports Liquid variables)
+  - `guides` (required): Array of article paths that make up this journey
+- Only applicable when used with `layout: journey-landing`.
+- Optional.
+
+Example:
+
+```yaml
+journeyTracks:
+  - id: 'getting_started'
+    title: 'Getting started with {% data variables.product.prodname_actions %}'
+    description: 'Learn the basics of GitHub Actions.'
+    guides:
+      - '/actions/quickstart'
+      - '/actions/learn-github-actions'
+      - '/actions/using-workflows'
+  - id: 'advanced'
+    title: 'Advanced {% data variables.product.prodname_actions %}'
+    description: 'Dive deeper into advanced features.'
+    guides:
+      - '/actions/using-workflows/workflow-syntax-for-github-actions'
+      - '/actions/deployment/deploying-with-github-actions'
+```
+
 ### `type`
 - Purpose: Indicate the type of article.
 - Type: `String`, one of the `overview`, `quick_start`, `tutorial`, `how_to`, `reference`.

content/contributing/writing-for-github-docs/using-yaml-frontmatter.md

@@ -39,6 +39,7 @@ For more information, see [`lib/frontmatter.js`](https://github.com/github/docs/
 * [`defaultTool`](#defaulttool)
 * [`learningTracks`](#learningtracks)
 * [`includeGuides`](#includeguides)
+* [`journeyTracks`](#journeytracks)
 * [`type`](#type)
 * [`topics`](#topics)
 * [`communityRedirect`](#communityredirect)
@@ -249,6 +250,36 @@ includeGuides:
   - /actions/guides/building-and-testing-powershell
 ```
 
+### `journeyTracks`
+
+* Purpose: Define journeys for journey landing pages.
+* Type: `Array` of objects with the following properties:
+  * `id` (required): Unique identifier for the journey. The id only needs to be unique for journeys within a single journey landing page.
+  * `title` (required): Display title for the journey (supports Liquid variables)
+  * `description` (optional): Description of the journey (supports Liquid variables)
+  * `guides` (required): Array of article paths that make up this journey
+* Only applicable when used with `layout: journey-landing`.
+* Optional.
+
+Example:
+
+```yaml
+journeyTracks:
+  - id: 'getting_started'
+    title: 'Getting started with {% data variables.product.prodname_actions %}'
+    description: 'Learn the basics of GitHub Actions.'
+    guides:
+      - '/actions/quickstart'
+      - '/actions/learn-github-actions'
+      - '/actions/using-workflows'
+  - id: 'advanced'
+    title: 'Advanced {% data variables.product.prodname_actions %}'
+    description: 'Dive deeper into advanced features.'
+    guides:
+      - '/actions/using-workflows/workflow-syntax-for-github-actions'
+      - '/actions/deployment/deploying-with-github-actions'
+```
+
 ### `type`
 
 * Purpose: Indicate the type of article.