Merge branch 'master' into brett.blue/config-visibility

Author: brett0000FF

.claude/settings.local.json

@@ -76,7 +76,7 @@ data/private_action_runner_version.json                       @Datadog/documenta
 # Serverless
 
 /content/en/serverless/                                 @DataDog/serverless @DataDog/documentation
-/layouts/shortcodes/latest-lambda-layer-version.html    @DataDog/documentation
+/layouts/shortcodes/latest-lambda-layer-version.html    @DataDog/serverless @DataDog/serverless-onboarding-and-enablement @DataDog/documentation
 
 # Database Management
 /content/en/database_monitoring/                        @DataDog/database-monitoring @DataDog/documentation
@@ -139,7 +139,7 @@ content/en/real_user_monitoring/error_tracking/kotlin_multiplatform.md   @Datado
 # Browser SDK
 content/en/real_user_monitoring/browser/                        @Datadog/rum-browser @DataDog/documentation
 content/en/real_user_monitoring/guide/                          @Datadog/rum-browser @DataDog/documentation
-content/en/real_user_monitoring/session_replay/browser          @Datadog/rum-browser @DataDog/documentation
+content/en/session_replay/browser          @Datadog/rum-browser @DataDog/documentation
 content/en/logs/log_collection/javascript.md                    @Datadog/rum-browser @DataDog/documentation
 content/en/logs/error_tracking/browser_and_mobile.md            @Datadog/rum-browser @DataDog/documentation
 content/en/real_user_monitoring/error_tracking/browser.md       @Datadog/rum-browser @DataDog/documentation

.github/CODEOWNERS

@@ -71,8 +71,8 @@ jobs:
               owner: context.repo.owner,
               repo: context.repo.repo,
               title: "(Automated) Bump version",
-              body: "### Merge instructions\n- [x] Please merge after reviewing",
+              body: "### Merge instructions\n- **Please merge this PR after approving!**",
               head: "automatic-version-update/synthetics-worker",
               base: "master",
               maintainer_can_modify: true
-            })
+            })

.github/workflows/bump_synthetics_worker_version.yml

@@ -60,9 +60,10 @@ jobs:
               pull_number: number,
             });
 
-            // Track latest review state per user
+            // Track latest review state per user (ignore commented state)
             const latestReviews = new Map();
             reviews.forEach(review => {
+              if (review.state === 'COMMENTED') return; 
               const existing = latestReviews.get(review.user.login);
               if (!existing || review.submitted_at > existing.submitted_at) {
                 latestReviews.set(review.user.login, review);
@@ -200,4 +201,4 @@ jobs:
               description: statusDescription,
               context: 'Documentation Team Approval'
             });
-            console.log(`Created commit status: ${statusState} - ${statusDescription}`);
+            console.log(`Created commit status: ${statusState} - ${statusDescription}`);

.github/workflows/codeowner_review_status.yml

@@ -17,11 +17,9 @@ jobs:
         persist-credentials: false
     - name: Check code meets quality and security standards
       id: datadog-static-analysis
-      uses: DataDog/datadog-static-analyzer-github-action@2707598b1182dce1d1792186477b5b4132338e1c # v1.2.3
+      uses: DataDog/datadog-static-analyzer-github-action@8340f18875fcefca86844b5f947ce2431387e552 # v3.0.0
       with:
         dd_api_key: ${{ secrets.DD_API_KEY }}
         dd_app_key: ${{ secrets.DD_APP_KEY }}
-        dd_service: documentation
-        dd_env: ci
         dd_site: datadoghq.com
         cpu_count: 2

.github/workflows/datadog-static-analysis.yml

@@ -9,6 +9,7 @@ _vendor/
 
 # htmltest tmp files
 bin/htmltest
+htmltest_report.txt
 tmp
 
 # Ignore generated examples
@@ -156,14 +157,17 @@ content/en/static_analysis/github_actions.md
 content/en/static_analysis/circleci_orbs.md
 content/en/static_analysis/rules/
 
+# containers - kubernetes
+content/en/containers/kubernetes/kubectl_plugin.md
+
 # containers - datadog-operator
 content/en/containers/datadog_operator/advanced_install.md
 content/en/containers/datadog_operator/configuration.md
 content/en/containers/datadog_operator/custom_check.md
 content/en/containers/datadog_operator/data_collected.md
-content/en/containers/datadog_operator/kubectl_plugin.md
 content/en/containers/datadog_operator/secret_management.md
 content/en/containers/guide/v2alpha1_migration.md
+content/en/containers/datadog_operator/kubectl_plugin.md
 
 # serverless
 content/en/serverless/libraries_integrations/plugin.md
@@ -311,9 +315,14 @@ static/cdocs
 content/en/**/*.ast.json
 layouts/shortcodes/mdoc/en/**/*.ast.json
 *.tempAst.json
+.cdocs_temp
 
 # Cursor editor configuration
 .cursor/
 
-# Generated file for LLMs
+
+# Deprecated generated file for LLMs (keep so it's not merged back in)
 static/llms.txt
+
+# AI
+.claude/*local*

.gitignore

@@ -57,7 +57,7 @@ def get_staged_files():
     """Get staged markdown files or all files if no staged files."""
     try:
         result = subprocess.run(
-            ['git', 'diff', '--cached', '--name-only', '--diff-filter=ACM'],
+            ['git', 'diff', '--cached', '--name-only', '--diff-filter=ACMR'],
             capture_output=True,
             text=True,
             check=True
@@ -76,14 +76,20 @@ def check_circular_aliases():
     """Check for circular aliases in markdown files."""
     errors = []
     staged_files = get_staged_files()
-    
+
     for file_path in staged_files:
-        if not file_path or not os.path.exists(file_path):
+        if not file_path:
             continue
-        
+
         try:
-            with open(file_path, 'r', encoding='utf-8') as f:
-                content = f.read()
+            # Read the STAGED version of the file, not the working directory version
+            result = subprocess.run(
+                ['git', 'show', f':{file_path}'],
+                capture_output=True,
+                text=True,
+                check=True
+            )
+            content = result.stdout
 
             frontmatter = parse_frontmatter(content)
             aliases = frontmatter.get('aliases', [])

.husky/check-circular-aliases.py

@@ -10,7 +10,9 @@ Datadog.Trademarks = NO
 BlockIgnores = (?s) *({{< ?code-block [^>]* >}}.*?{{< ?/ ?code-block >}}), \
 (?s) *({{< ?img [^>]*>}}), \
 (?s) *({{< ?(w|/w)hatsnext [^>]*>}}), \
-(?s) *({{< ?(n|/n)extlink [^>]*>}})
+(?s) *({{< ?(n|/n)extlink [^>]*>}}), \
+(?s) *({%\s*if\s+[^%]*%}), \
+(?s) *({%\s*partial\s+[^%]*\/%})
 TokenIgnores = ({{< ?site-region [^>]* >}})
 
 [*.html]

.vale.ini

@@ -10,7 +10,7 @@
         "scope": "markdoc",
         "prefix": ";;callout",
         "body": [
-            "{% callout src=\"${1:https://www.example.com}\" header=\"${2:Join the Preview!}\" btn_hidden=${3|false,true|} %}",
+            "{% callout url=\"${1:https://www.example.com}\" header=\"${2:Join the Preview!}\" btn_hidden=${3|false,true|} %}",
             "${4:Callout content goes here.}",
             "{% /callout %}"
         ],
@@ -28,6 +28,17 @@
         "description": "Markdoc code block with attributes and tabstop choices"
     },
 
+    "Collapse content": {
+        "scope": "markdoc",
+        "prefix": ";;collapse-content",
+        "body": [
+            "{% collapse-content title=\"${1:Your title}\" level=\"${2|h4,h1,h2,h3,h5|}\" expanded=${3|true,false|} id=\"${4:unique-id}\" %}",
+            "${5:Collapsible content goes here.}",
+            "{% /collapse-content %}"
+        ],
+        "description": "Markdoc collapse block with customizable label"
+    },
+
     "Definition list": {
         "scope": "markdoc",
         "prefix": ";;list",
@@ -132,6 +143,13 @@
         "description": "Markdoc tabs block with two labeled tabs"
     },
 
+    "Tooltip": {
+        "scope": "markdoc",
+        "prefix": ";;tooltip",
+        "body": ["{% tooltip contents=\"${1:Popup text}\" %}", "${2:display text}", "{% /tooltip %}"],
+        "description": "Markdoc tooltip block with customizable content"
+    },
+
     "Check mark": {
         "scope": "markdoc",
         "prefix": ";;check",

.vscode/markdoc.code-snippets

@@ -68,6 +68,48 @@ CRITICAL: Always use format `<name>/<description>` with forward slash. Without t
 - No branch preview will be generated
 - CI will fail
 
+### PR Checklist
+- Leave the "Ready for merge" checkbox unchecked unless explicitly requested.
+
+### PR Title Format
+Use the Jira ticket key in square brackets: `[DOCS-XXXXX] Brief description`
+
+### PR Description Template
+```
+<!-- *Note: Please remember to review the Datadog Documentation [Contribution Guidelines](https://github.com/DataDog/documentation/blob/master/CONTRIBUTING.md) if you have not yet done so.* -->
+
+### What does this PR do? What is the motivation?
+
+Fixes DOCS-XXXXX
+
+[Brief description of changes]
+
+### Merge instructions
+
+Merge readiness:
+- [ ] Ready for merge
+
+### Additional notes
+
+```
+
+### Pre-commit Checklist
+Before committing changes, run Vale to check style compliance:
+```bash
+vale /path/to/changed/file.md
+```
+Fix any warnings before committing. Common issues:
+- "once you" → "after you"
+- "fine-tune" → "customize"
+- "ensure" → "helps ensure"
+- Remove filler words: easy, simple, just, please, very
+
+### Commit Messages
+- Keep messages concise and descriptive
+
+### Jira Workflow
+- When a PR is created, transition the Jira ticket to **Reviewable** status (transition ID: 101)
+
 ### Content Guidelines
 Follow the CONTRIBUTING.md style guide:
 - Use American English (en_US)
@@ -76,6 +118,31 @@ Follow the CONTRIBUTING.md style guide:
 - Use imperative voice for instructions
 - Don't edit translated content directly (managed externally)
 
+### Style Rules (from datadog-vale)
+The full Vale linter rules are at https://github.com/DataDog/datadog-vale. Key substitutions:
+
+| Don't use | Use instead |
+|-----------|-------------|
+| once you/once the | after you/after the |
+| fine-tune | customize, optimize, or refine |
+| ensure/ensures | helps, helps ensure |
+| leverage | use, apply, take advantage of |
+| utilize | use |
+| in order to | to |
+| easy/easily | (remove) |
+| simple/simply | (remove) |
+| just | (remove) |
+| please | (remove) |
+| via | with, through |
+| Note that | **Note**: |
+| drill down/into | examine, investigate, analyze |
+| refer to/visit | see, read, follow |
+| obvious/obviously | (remove) |
+| seamless/seamlessly | (remove) |
+| quick/quickly | (remove) |
+
+Avoid temporal words: currently, now, will, won't
+
 ## Hugo-Specific Details
 
 ### Shortcodes