Skip to content

Split deployment gates setup into JIT and preconfigured pages#37364

Open
GabrielAnca wants to merge 2 commits into
masterfrom
gabriel.anca/split-deployment-gates-setup-pages
Open

Split deployment gates setup into JIT and preconfigured pages#37364
GabrielAnca wants to merge 2 commits into
masterfrom
gabriel.anca/split-deployment-gates-setup-pages

Conversation

@GabrielAnca

@GabrielAnca GabrielAnca commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

What does this PR do? What is the motivation?

Splits Deployment Gates setup into two dedicated pages — JIT and preconfigured — instead of mixing both modes on a single page. Each setup page describes only the workflow for its mode (creation steps, integration tabs, dry-run guidance), and the existing /deployment_gates/setup/ URL becomes a short landing page that helps readers choose between the two modes.

The menu adds two children under Setup (JIT and Preconfigured); the existing setup URL is preserved.

This is an alternative to #37327, which keeps both modes on the same page with JIT-first ordering.

Merge instructions

Merge readiness:

  • Ready for merge

Additional notes

TODO before merge — update version numbers once the supporting PRs land:

Once those merge, replace the placeholder version references in content/en/deployment_gates/setup/jit.md (CLI release-notes link, datadog/ci:latest image tag in the Argo example, deployment-gate-github-action@v1 major-version pin) with concrete versions.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@github-actions github-actions Bot added the Architecture Everything related to the Doc backend label Jun 9, 2026
@datadog-prod-us1-5

datadog-prod-us1-5 Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Pipelines

Fix all issues with BitsAI

⚠️ Warnings

🚦 1 Pipeline job failed

Code-Freeze | check-code-freeze-status   View in Datadog   GitHub Actions

Useful? React with 👍 / 👎

This comment will be updated automatically if new data arrives.
🔗 Commit SHA: 110b035 | Docs | Datadog PR Page | Give us feedback!

@github-actions

github-actions Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

⚠️ Possible site support note detected

The following files have a site-region shortcode at the top of the page that mentions a feature being "not available" or "not supported":

  • content/en/deployment_gates/setup/_index.md
  • content/en/deployment_gates/setup/jit.md

Are you trying to document site support for a product? If so, the site-region shortcode is not the recommended approach. See the Documenting site support guide for the preferred method.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@GabrielAnca GabrielAnca marked this pull request as ready for review June 9, 2026 11:38
@GabrielAnca GabrielAnca requested a review from a team as a code owner June 9, 2026 11:38
@rtrieu

rtrieu commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

/review

@rtrieu rtrieu added the editorial review Waiting on a more in-depth review label Jun 9, 2026
@rtrieu

rtrieu commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Created a DOCS card for an editorial review.

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 Automated review by Claude. AI-generated; verify before acting.

Nice restructure — the JIT vs preconfigured split is much clearer than a single page trying to cover both. A few specific notes inline: one typo in an example UUID, one style nit, and one minor consistency issue with an unpinned image tag.

Reviewed 110b0359fde269068efc09658f2fa241f326f19fworkflow run


You can use different modes across different gates if needed.

If you're unsure where to start, or you want to get started quickly, use JIT.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Style: quickly is on the Vale filler-word list. The "unsure where to start" clause already conveys the same idea.

Suggested change
If you're unsure where to start, or you want to get started quickly, use JIT.
If you're unsure where to start, use JIT.

"attributes": {
"dry_run": false,
"evaluation_id": "e9d2f04f-4f4b-494b-86e5-52f03e10c8e9",
"evaluation_url": "https://app.datadoghq.com/ci/deployment-gates/evaluations?index=cdgates&query=level%3Agate+%40evaluation_id%3Ae9d2f14f-4f4b-494b-86e5-52f03e10c8e9",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Issue: The evaluation_id embedded in evaluation_url (e9d2f14f-...) does not match the evaluation_id field above it (e9d2f04f-...). Looks like a one-character typo in the example.

Suggested change
"evaluation_url": "https://app.datadoghq.com/ci/deployment-gates/evaluations?index=cdgates&query=level%3Agate+%40evaluation_id%3Ae9d2f14f-4f4b-494b-86e5-52f03e10c8e9",
"evaluation_url": "https://app.datadoghq.com/ci/deployment-gates/evaluations?index=cdgates&query=level%3Agate+%40evaluation_id%3Ae9d2f04f-4f4b-494b-86e5-52f03e10c8e9",

restartPolicy: Never
containers:
- name: datadog-check
image: datadog/ci:latest

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion: The page tells readers to use a datadog-ci version that supports --config (line 202), but this example pins to datadog/ci:latest, which makes it ambiguous which version a reader actually runs. Pin to a specific tag known to support --config so the example stays consistent with the version guidance above.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Architecture Everything related to the Doc backend editorial review Waiting on a more in-depth review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants