Skip to content

Comments

chore(kno-11556): Update Step component to add h4 support and heading size alignment#1307

Open
rachael-t wants to merge 2 commits intomainfrom
rt-kno-11556-fix-step-titlesize
Open

chore(kno-11556): Update Step component to add h4 support and heading size alignment#1307
rachael-t wants to merge 2 commits intomainfrom
rt-kno-11556-fix-step-titlesize

Conversation

@rachael-t
Copy link
Contributor

@rachael-t rachael-t commented Feb 5, 2026

Description

I noticed that step headings weren't appearing in this section of the docs, and after digging in realized that this was because the titleSize was set to h4 and the Step component was returning null in this case. To have better support moving forward, I've added the following changes:

  1. Explicitly added support for titleSize="h4" (previously there was only support for "p", "h2" and "h3"
  2. Updated the default case to no longer return null, so titles won't be missing in the case of an unsupported (or typo'd) titleSize.
  3. Updated the heading sizes to align with the markdown headings. Step titles now use the same Telegraph Heading size as SectionHeading (used for ##, ###, #### in MDX via mdxComponents) to help keep the step headings consistent with the rest of the docs.

Tasks

KNO-11556

Screenshots

Before:
Screenshot 2026-02-04 at 4 58 01 PM

After:
Screenshot 2026-02-04 at 5 04 12 PM

Cursor Bugbot found 1 potential issue for commit 48a6f48

@linear
Copy link

linear bot commented Feb 5, 2026

@vercel
Copy link

vercel bot commented Feb 5, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Feb 5, 2026 0:08am

Request Review

Copy link

@cursor cursor bot left a comment

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.

>
{title}
</Heading>
);
Copy link

Choose a reason for hiding this comment

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

Duplicated code between h2 case and default case

Low Severity

The h2 case and default case in TitleTag now have identical implementations - both render a Heading with as="h2" and size="4" with the same props. This duplication increases maintenance burden and risks inconsistent bug fixes if someone updates one case but forgets to update the other. The cases could be combined using a fallthrough pattern.

Additional Locations (1)

Fix in Cursor Fix in Web


<Steps titleSize="h4">
<Step title="Get the `access_token` stored in Knock for the user's tenant">
<Step title="Get the access_token stored in Knock for the user's tenant">
Copy link
Contributor

Choose a reason for hiding this comment

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

Didn't see this in the PR description so just making sure you intend to include this?

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants