Merge branch 'master' into domalessi/apm-basic-docs

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: domalessi

.github/CODEOWNERS

@@ -9,11 +9,11 @@ hugo/config/                           @DataDog/corpweb
 hugo/package.json                      @DataDog/corpweb
 hugo/go.mod                            @DataDog/corpweb
 hugo/go.sum                            @DataDog/corpweb
-hugo/i18n/                             @DataDog/corpweb
 hugo/archetypes/                       @DataDog/corpweb
 
 # Websites Platform
-astro/                                                       @DataDog/WebOps-Platform   
+astro/                                                       @DataDog/WebOps-Platform
+shared/                                                      @DataDog/WebOps-Platform
 hugo/babel.config.js                                         @DataDog/WebOps-Platform
 hugo/data/reference/                                         @DataDog/WebOps-Platform
 datadog-ci.preview.json                                 @DataDog/WebOps-Platform

.github/workflows/gif_check.yml

@@ -21,7 +21,7 @@ jobs:
     - name: Checkout code
       uses: actions/checkout@08eba0b27e820071cde6df949e0beb9ba4906955 # v4.3.0
       with:
-          fetch-depth: 0
+          fetch-depth: 1
           persist-credentials: false
 
     # Branch Name Validation to be run prior to workflow

.vscode/markdown.code-snippets

@@ -91,13 +91,27 @@
         "scope": "markdown",
         "prefix": ";;callout",
         "body": [
-            "{{< callout url="#" btn_hidden=\"false\" header=\"Join the Preview!\">}}",
+            "{{< callout url=\"#\" btn_hidden=\"false\" header=\"Join the Preview!\">}}",
             "<Product name> is in Preview. Use this form to submit your request today.",
             "{{< /callout >}}"
         ],
         "description": "A callout with all parameters"
     },
 
+    "Skill callout": {
+        "scope": "markdown",
+        "prefix": ";;skill-callout",
+        "body": [
+            "{{< skill-callout",
+            "    title=\"${1:Set up APM with an agent}\"",
+            "    text=\"${2:Install the `dd-apm` skill in your AI coding agent for guided APM setup.}\"",
+            "    action_name=\"${3:copy_dd_apm_skill_install_cmd}\" >}}",
+            "${4:npx skills add https://github.com/datadog-labs/agent-skills --skill dd-apm --full-depth -y}",
+            "{{< /skill-callout >}}"
+        ],
+        "description": "Agent skill install command callout"
+    },
+
     "Integration count": {
         "scope": "markdown",
         "prefix": ";;integration",

hugo/assets/scripts/build-api-pages.js

@@ -359,11 +359,10 @@ const filterJson = (actionType, data, parentExample = null, requiredKeys = [], l
         }
       }
 
-      if(actionType === "request" && value.readOnly) {
-        // skip
-      } else if(actionType === "curl" && value.readOnly) {
-        // skip
-      } else {
+      const shouldSkip = ((actionType === "request" || actionType === "curl") && value.readOnly)
+        || (actionType === "response" && value.writeOnly);
+
+      if(!shouldSkip) {
 
         let prefixType = '';
         let suffixType = '';
@@ -978,6 +977,10 @@ const rowRecursive = (tableType, data, isNested, requiredFields=[], level = 0, p
     if (typeof data === 'object') {
       Object.entries(data).forEach(([key, value]) => {
 
+        if(tableType === "response" && value.writeOnly) {
+          return;
+        }
+
         // calculate child data in advance
         // we do this here so that we can add classes to html with this knowledge
         let childData = null;

hugo/assets/scripts/tests/build-api-pages.test.js

@@ -929,6 +929,31 @@ describe(`filterExampleJson`, () => {
     expect(actual).toEqual(expected);
   });
 
+  it('should hide writeonly fields on response json', () => {
+    const mockSchema = {
+      "description": "This is a test with writeonly",
+      "properties": {
+        "secret": {
+          "description": "This is a write only field",
+          "writeOnly": true,
+          "type": "string"
+        },
+        "metric": {
+          "description": "This is explicitly not writeonly",
+          "writeOnly": false,
+          "type": "string"
+        },
+        "length": {
+          "description": "This is implicitly by omission not writeonly",
+          "type": "string"
+        }
+      }
+    };
+    const actual = bp.filterExampleJson('response', mockSchema);
+    const expected = {'metric':'string', 'length': 'string'};
+    expect(actual).toEqual(expected);
+  });
+
   it('should show boolean without quotes', () => {
     const mockSchema = {
       "description": "A dashboard is Datadog’s tool for visually tracking, analyzing, and displaying\nkey performance metrics, which enable you to monitor the health of your infrastructure.",
@@ -2615,6 +2640,25 @@ describe(`descColumn`, () => {
 
 describe(`rowRecursive`, () => {
 
+  it('should hide writeonly fields in response models', () => {
+    const mockData = {
+      "secretField": {
+        "type": "string",
+        "writeOnly": true
+      },
+      "visibleField": {
+        "type": "string"
+      }
+    };
+
+    const response = bp.rowRecursive("response", mockData, false);
+    const request = bp.rowRecursive("request", mockData, false);
+
+    expect(response).not.toContain('secretField');
+    expect(response).toContain('visibleField');
+    expect(request).toContain('secretField');
+  });
+
   it('should handle fields named required (properties->required)', () => {
     /*
     Required fields are usually an array of string e.g ['foo'.'bar']

hugo/assets/styles/components/_skill-callout.scss

@@ -0,0 +1,73 @@
+// Bordered card promoting an agent skill install command.
+// Markup lives in layouts/shortcodes/skill-callout.html.
+//
+// The command inside the card is an ordinary highlighted shell block, so it
+// inherits the site's code block styling and hover copy button from
+// pages/_global.scss. Only the card around it is styled here.
+//
+// Class names are full BEM so they survive the eventual port to the Astro
+// site, which pairs each component with a BEM-named CSS module.
+
+.skill-callout {
+    margin: 0 0 30px;
+    padding: 20px 22px 22px;
+    border: 1px solid #e4e2ee;
+    border-radius: 8px;
+    background: #fff;
+    // Same purple-tinted shadow the tooltip uses, so the card lifts off the
+    // page without introducing a new shadow value.
+    box-shadow: 0 4px 15px rgba($ddpurple, 0.1), 0 2px 5px rgba($ddpurple, 0.08);
+
+    // Body copy in the card matches the site's paragraph scale (18px/27px in
+    // pages/_global.scss) so the card reads as part of the page rather than as
+    // a shrunken aside. The heading is set apart by weight, not size.
+    &__text {
+        margin: 0 0 16px;
+        max-width: 60ch;
+        color: #5c5c72;
+        font-size: 18px;
+        line-height: 27px;
+
+        p {
+            margin: 0;
+            font-size: inherit;
+            line-height: inherit;
+            color: inherit;
+        }
+
+        // Inline code reads as a tinted pill so a skill name such as `dd-apm`
+        // stands out from the surrounding prose. Sizing follows the site's
+        // inline code; only the tint differs.
+        code {
+            padding: 0 5px;
+            border-radius: 4px;
+            background: #f1eafb;
+            color: #5a2a94;
+            font-size: 14px;
+        }
+    }
+}
+
+// `.main p` in pages/_global.scss sets the paragraph scale and outranks a flat
+// BEM class, so the heading needs the element qualifier to set its own size.
+p.skill-callout__title {
+    margin: 0 0 6px;
+    color: #1b1b2e;
+    font-size: 18px;
+    font-weight: 600;
+    line-height: 27px;
+}
+
+// `.main pre` in pages/_global.scss adds a 24px bottom margin meant to separate
+// consecutive code blocks. The card's own padding provides that spacing here,
+// so the margin would read as dead space. Needs the element qualifier to match
+// that rule's specificity.
+.skill-callout__command pre {
+    margin: 0;
+}
+
+@media (max-width: 575px) {
+    .skill-callout {
+        padding: 16px 16px 18px;
+    }
+}

hugo/assets/styles/style.scss

@@ -69,6 +69,7 @@ $baseImgURL: '{{.Site.Params.img_url}}';
 @import 'components/expression-language';
 @import 'components/ddsql-schema';
 @import 'components/admonitions';
+@import 'components/skill-callout'; // Skill callout shortcode styles
 @import 'components/metrics-table';
 
 @import 'components/main-nav'; // imported from websites-modules

hugo/config/_default/config.yaml

@@ -146,7 +146,7 @@ module:
       target: assets
     - source: assets
       target: assets
-    - source: i18n
+    - source: ../shared/i18n
       target: i18n
     - source: archetypes
       target: archetypes

hugo/config/_default/menus/api.en.yaml

@@ -6277,6 +6277,58 @@ menu:
           - GetUsageSummaryAvailableFields
         unstable: []
         order: 13
+    - name: Update a usage quota
+      url: /api/latest/usage-metering/update-a-usage-quota/
+      identifier: usage-metering-update-a-usage-quota
+      parent: usage-metering
+      generated: true
+      params:
+        versions:
+          - v2
+        operationids:
+          - UpdateQuota
+        unstable:
+          - v2
+        order: 16
+    - name: Delete a usage quota
+      url: /api/latest/usage-metering/delete-a-usage-quota/
+      identifier: usage-metering-delete-a-usage-quota
+      parent: usage-metering
+      generated: true
+      params:
+        versions:
+          - v2
+        operationids:
+          - DeleteQuota
+        unstable:
+          - v2
+        order: 17
+    - name: Create or update usage quotas
+      url: /api/latest/usage-metering/create-or-update-usage-quotas/
+      identifier: usage-metering-create-or-update-usage-quotas
+      parent: usage-metering
+      generated: true
+      params:
+        versions:
+          - v2
+        operationids:
+          - CreateQuotas
+        unstable:
+          - v2
+        order: 15
+    - name: List usage quotas
+      url: /api/latest/usage-metering/list-usage-quotas/
+      identifier: usage-metering-list-usage-quotas
+      parent: usage-metering
+      generated: true
+      params:
+        versions:
+          - v2
+        operationids:
+          - ListQuotas
+        unstable:
+          - v2
+        order: 14
     - name: Get projected cost across your account
       url: /api/latest/usage-metering/get-projected-cost-across-your-account/
       identifier: usage-metering-get-projected-cost-across-your-account
@@ -8428,6 +8480,19 @@ menu:
         unstable:
           - v2
         order: 28
+    - name: Get an annotated queue interaction
+      url: /api/latest/agent-observability/get-an-annotated-queue-interaction/
+      identifier: agent-observability-get-an-annotated-queue-interaction
+      parent: agent-observability
+      generated: true
+      params:
+        versions:
+          - v2
+        operationids:
+          - GetLLMObsAnnotatedInteraction
+        unstable:
+          - v2
+        order: 73
     - name: Get annotated queue interactions
       url: /api/latest/agent-observability/get-annotated-queue-interactions/
       identifier: agent-observability-get-annotated-queue-interactions
@@ -17862,6 +17927,23 @@ menu:
           - SubmitProductAnalyticsEvent
         unstable: []
         order: 1
+    - name: Product Catalog
+      url: /api/latest/product-catalog/
+      identifier: product-catalog
+      generated: true
+    - name: List SKUs
+      url: /api/latest/product-catalog/list-skus/
+      identifier: product-catalog-list-skus
+      parent: product-catalog
+      generated: true
+      params:
+        versions:
+          - v2
+        operationids:
+          - ListProductCatalogSKUs
+        unstable:
+          - v2
+        order: 1
     - name: RUM
       url: /api/latest/rum/
       identifier: rum
@@ -22214,6 +22296,23 @@ menu:
           - UpdateFlakyTestsManagementPolicies
         unstable: []
         order: 7
+    - name: Threat Intelligence
+      url: /api/latest/threat-intelligence/
+      identifier: threat-intelligence
+      generated: true
+    - name: Ingest STIX threat intelligence
+      url: /api/latest/threat-intelligence/ingest-stix-threat-intelligence/
+      identifier: threat-intelligence-ingest-stix-threat-intelligence
+      parent: threat-intelligence
+      generated: true
+      params:
+        versions:
+          - v2
+        operationids:
+          - AddSTIXThreatIntel
+        unstable:
+          - v2
+        order: 1
     - name: Twilio Integration Accounts
       url: /api/latest/twilio-integration-accounts/
       identifier: twilio-integration-accounts