Skip to content

Commit a0c51f2

Browse files
committed
style(docs): render hook docblock summary as a slightly larger lead paragraph
The first sentence of a docblock renders as its own paragraph right after the page title. Bump it to 1.15rem so it reads as a lead-in, leaving the long description at body size. No heading is introduced, so the a11y heading outline and the meta description (already sourced from the first sentence) are unchanged. Claude-Session: https://claude.ai/code/session_01WGs3aAJqYoXNEVCiru5obx
1 parent dbb7ad8 commit a0c51f2

1 file changed

Lines changed: 10 additions & 0 deletions

File tree

src/css/custom.css

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -185,6 +185,16 @@
185185
color: var(--ifm-color-primary);
186186
}
187187

188+
/* Lead paragraph: the docblock summary (first sentence) sits directly after the
189+
page title, as its own paragraph. Render it slightly larger so the summary
190+
reads as a lead-in, without turning prose into a heading (keeps the a11y
191+
heading outline and meta description intact). Applies to the intro paragraph
192+
of other doc pages too. */
193+
.theme-doc-markdown > header + p {
194+
font-size: 1.15rem;
195+
line-height: 1.6;
196+
}
197+
188198
/* Hook documentation specific styles */
189199
.hook-signature {
190200
background-color: var(--ifm-code-background);

0 commit comments

Comments
 (0)