Skip to content

fix(docs): stop quick-reference boxes overlapping and double-numbering - #22

Merged
ValgulNecron merged 1 commit into
mainfrom
claude/docs-quickref-fix
Oct 15, 2026
Merged

ValgulNecron merged 1 commit into
mainfrom
claude/docs-quickref-fix

Conversation

@ValgulNecron

@ValgulNecron ValgulNecron commented Oct 15, 2026 •

Copy link
Copy Markdown
Collaborator

Before: in every docs quick-reference box (for example "FIRST OPERATING LOOP" on Dashboard tour), the label was drawn on top of the first step, and steps were numbered twice ("01 01 Choose a cluster and namespace").

After: the label sits above the steps in the accent colour, and each step shows one number ("01 Choose a cluster and namespace"), matching the design frames (e.g. X0DeYH, e8fTgD, o5zdzd in website-export/json/).

How:

  • DocsQuickReference.astro rendered its label as an <h3> inside .docs-prose, and the unlayered .docs-prose h3 rule (margin-bottom: -16px, 14px, foreground colour) beat the component's Tailwind utilities, pulling the label down over the first item. The label is now a <div>, so the prose heading rule no longer applies.
  • The component already prefixes each item with its position; 147 items across 48 pages also carried a hand-written 01 prefix. A script stripped those prefixes; every one matched its position, so displayed numbers are unchanged. Items that had no prefix were already numbered once by the component.

npm run build (99 pages) and npm run check (0 errors) pass locally; the rendered box was checked in Chromium.

🤖 Generated with Claude Code

DocsQuickReference renders its label as an h3 inside .docs-prose, whose
h3 rule (margin-bottom: -16px) pulled the label over the first step.
Render the label as a div so prose heading styles don't apply.

The component already numbers each item (01, 02, ...), but 147 items in
48 docs pages also carried a hand-written "01  " prefix, so steps showed
as "01 01 ...". Strip the duplicate prefixes from the content; every
prefix matched its position, so the displayed numbers are unchanged.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Signed-off-by: Claude <noreply@anthropic.com>
@ValgulNecron ValgulNecron self-assigned this Oct 15, 2026
@coderabbitai

coderabbitai Bot commented Oct 15, 2026

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration
  • Configuration used: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 98e141b5-4915-4d4e-942a-93a32b8bffc4
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@ValgulNecron
ValgulNecron merged commit 9cbe8d4 into main Oct 15, 2026
2 checks passed
@ValgulNecron
ValgulNecron deleted the claude/docs-quickref-fix branch October 15, 2026 23:08
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