Merge branch 'main' into feature/extensionless-urls

Author: reakaleek

.github/release-drafter.yml

@@ -29,6 +29,9 @@ categories:
     labels:
       - 'automation' # When automation is updated
       - 'ci' # When automation is updated
+  - title: '🎨 Redesign' # Temporary category while we're redesigning the docs
+    labels:
+      - 'redesign' # When it's a redesign feature
 exclude-labels:
   - 'changelog:skip' # When a PR should be excluded from the changelog
 version-resolver:

.github/workflows/comment-on-asciidoc-changes.yml

@@ -36,7 +36,7 @@ jobs:
               owner: context.repo.owner,
               repo: context.repo.repo,
               issue_number: context.payload.pull_request.number,
-              body: 'It looks like this PR modifies one or more `.asciidoc` files. These files are being migrated to Markdown, and any changes merged now will be lost. See the [migration guide](https://elastic.github.io/docs-builder/migration/freeze/index.html) for details.'
+              body: '> [!WARNING]\n> It looks like this PR modifies one or more `.asciidoc` files. These files are being migrated to Markdown, and any changes merged now will be lost. See the [migration guide](https://elastic.github.io/docs-builder/migration/freeze/index.html) for details.'
             })
 
       - name: Error if .asciidoc files changed

.github/workflows/preview-build.yml

@@ -1,7 +1,13 @@
 name: preview-build
 
 on:
-  pull_request: ~
+  pull_request: 
+    types:
+      - opened
+      - synchronize
+      - reopened
+      - labeled
+      - unlabeled
   workflow_call:
     inputs:
       strict:
@@ -25,6 +31,9 @@ permissions:
 
 jobs:
   build:
+    concurrency: 
+      group: ${{ github.workflow }}-${{ github.ref }}
+      cancel-in-progress: true
     runs-on: ubuntu-latest
     steps:
 
@@ -66,6 +75,10 @@ jobs:
       - name: Bootstrap Action Workspace
         if: github.repository == 'elastic/docs-builder' && steps.check-files.outputs.any_changed == 'true'
         uses: ./.github/actions/bootstrap
+        
+      - name: Set REDESIGN feature flag
+        if: contains(github.event.pull_request.labels.*.name, 'redesign')
+        run: echo "REDESIGN=true" >> $GITHUB_ENV
 
       # we run our artifact directly please use the prebuild
       # elastic/docs-builder@main GitHub Action for all other repositories!

.github/workflows/preview-deploy.yml

@@ -89,7 +89,9 @@ jobs:
           PR_NUMBER: ${{ needs.pull-request-data.outputs.number }}
         run: |
           aws s3 sync ./html "s3://elastic-docs-v3-website-preview/${GITHUB_REPOSITORY}/pull/${PR_NUMBER}" --delete
-          aws cloudfront create-invalidation --distribution-id EKT7LT5PM8RKS --paths "/${GITHUB_REPOSITORY}/pull/${PR_NUMBER}/*"
+          aws cloudfront create-invalidation \
+            --distribution-id EKT7LT5PM8RKS \
+            --paths "/${GITHUB_REPOSITORY}/pull/${PR_NUMBER}" "/${GITHUB_REPOSITORY}/pull/${PR_NUMBER}/*"
 
       - name: Update deployment status
         uses: actions/github-script@v7

docs/syntax/applies.md

@@ -52,9 +52,7 @@ Are equivalent, note `all` just means we won't be rendering the version portion
 ## This section has its own applies annotations [#sections]
 
 :::{applies}
-:stack: unavailable
-:serverless: tech-preview
-:cloud: ga
+:serverless: unavailable
 :::
 
 :::{note}

docs/syntax/substitutions.md

@@ -24,6 +24,8 @@ subs:
 If a substitution is defined globally it may not be redefined (shaded) in a files `frontmatter`. 
 Doing so will result in a build error.
 
+To use the variables in your files, surround them in curly brackets (`{{variable}}`).
+
 ## Example
 
 Here are some variable substitutions:

src/Elastic.Markdown/.gitignore

@@ -4,3 +4,4 @@ _static/main.js
 _static/main.js.map
 _static/styles.css
 _static/styles.css.map
+_static/*.woff2

src/Elastic.Markdown/Assets/fonts.css

@@ -0,0 +1,7 @@
+@import url('https://fonts.googleapis.com/css2?family=Inter:ital,opsz,wght@0,14..32,100..900;1,14..32,100..900&display=swap');
+
+
+@font-face {
+	font-family: "Mier B";
+	src: url("./fonts/MierB-Regular.woff2") format("woff2")
+}