Skip to content

Add assets to support the Cdocs stepper (not in use yet)#35312

Merged
jhgilbert merged 40 commits intomasterfrom
jen.gilbert/WEB-8372-stepper-assets
Mar 16, 2026
Merged

Add assets to support the Cdocs stepper (not in use yet)#35312
jhgilbert merged 40 commits intomasterfrom
jen.gilbert/WEB-8372-stepper-assets

Conversation

@jhgilbert
Copy link
Contributor

@jhgilbert jhgilbert commented Mar 16, 2026

What does this PR do? What is the motivation?

Adds assets to support a new Cdocs component, the stepper. The actual stepper tag will not be available in Cdocs until the next release, but you can preview the component here.

This PR also makes focus visible on keyboard navigation, which was required for us to meet the accessibility requirements in the stepper RFC. It's important for accessibility anyway, so we might as well fix it. I included some tweaks to how the focus appeared for some components, like tabs. All of this can be previewed at the above link.

Merge instructions

Merge readiness:

  • Ready for merge

For Datadog employees:

Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). Without this format, your pull request will not pass CI, the GitLab pipeline will not run, and you won't get a branch preview. Getting a branch preview makes it easier for us to check any issues with your PR, such as broken links.

If your branch doesn't follow this format, rename it or create a new branch and PR.

[6/5/2025] Merge queue has been disabled on the documentation repo. If you have write access to the repo, the PR has been reviewed by a Documentation team member, and all of the required checks have passed, you can use the Squash and Merge button to merge the PR. If you don't have write access, or you need help, reach out in the #documentation channel in Slack.

AI assistance

Additional notes

jhgilbert and others added 6 commits March 13, 2026 11:21
Reduce visual weight of the expand all / collapse toggle so it reads
as a quiet utility control rather than competing with step titles.

- font-size: 16px → 14px
- font-weight: 600 → 500
- text-transform: uppercase → none (sentence case)
- Add subtle letter-spacing
@jhgilbert jhgilbert added the WORK IN PROGRESS No review needed, it's a wip ;) label Mar 16, 2026
@jhgilbert jhgilbert requested review from a team as code owners March 16, 2026 18:50
@github-actions github-actions bot added Architecture Everything related to the Doc backend Images Images are added/removed with this PR labels Mar 16, 2026
Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ffe5f61c32

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0f1ddb6a47

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

@jhgilbert jhgilbert removed the WORK IN PROGRESS No review needed, it's a wip ;) label Mar 16, 2026
@maycmlee
Copy link
Contributor

Created docs card for review: https://datadoghq.atlassian.net/browse/DOCS-13722

@maycmlee maycmlee added the editorial review Waiting on a more in-depth review label Mar 16, 2026
Comment on lines +258 to +265
// Hide focus outlines for mouse/touch only; keep for keyboard
button:focus:not(:focus-visible) {
outline: none;
}
button:focus-visible {
outline: 2px solid $ddpurple;
outline-offset: 2px;
}
Copy link
Contributor

Choose a reason for hiding this comment

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

@jhgilbert hello! these styles seem to be a duplicate of what's in _global.scss. could we remove them and still have the intended output?

Copy link
Contributor

Choose a reason for hiding this comment

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

by the order of imports here https://github.com/DataDog/documentation/blob/master/assets/styles/style.scss, the pages/global styles would overwrite the bootstrap-custom styles

Co-authored-by: StefonSimmons <57869435+StefonSimmons@users.noreply.github.com>
@gh-worker-ownership-write-b05516 gh-worker-ownership-write-b05516 bot removed the request for review from a team March 16, 2026 21:28
Copy link
Contributor

@brett0000FF brett0000FF left a comment

Choose a reason for hiding this comment

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

🚀

@jhgilbert jhgilbert merged commit 8ca8477 into master Mar 16, 2026
20 of 21 checks passed
@jhgilbert jhgilbert deleted the jen.gilbert/WEB-8372-stepper-assets branch March 16, 2026 21:48
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 Images Images are added/removed with this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants