Skip to content

Remove redundant top-level H1 headings and normalize page titles#6197

Merged
Blargian merged 2 commits into
mainfrom
codex/remove-duplicate-h1-elements-from-docs-pages
May 12, 2026
Merged

Remove redundant top-level H1 headings and normalize page titles#6197
Blargian merged 2 commits into
mainfrom
codex/remove-duplicate-h1-elements-from-docs-pages

Conversation

@Blargian
Copy link
Copy Markdown
Member

@Blargian Blargian commented May 9, 2026

Motivation

  • Clean up documentation source files by removing duplicated top-level headings that are already provided via frontmatter to avoid rendering duplicate titles and improve consistency.
  • Normalize a small number of frontmatter title values and inline titles for consistency and correct formatting.

Description

  • Removed redundant # <Title> H1 lines from many markdown files so the site uses the frontmatter title (or hide_title) consistently.
  • Adjusted select frontmatter titles and inline text for consistency, including adding code formatting to OPTIMIZE FINAL and minor capitalization/wording changes (for example, DataStore I/O operationsDatastore I/O operations, and changelog titles lowercased).
  • Kept all existing frontmatter and content structure intact aside from the removed H1 lines and the few targeted title edits.

Testing

  • Built the documentation site with yarn build to verify no rendering errors and ensure titles render from frontmatter, and the build completed successfully.
  • Ran markdownlint over the modified files to validate markdown style and found no lint failures.
  • Performed a quick local link/preview pass to confirm pages render and navigation remains intact.

Codex Task

@Blargian Blargian requested review from a team as code owners May 9, 2026 20:45
@vercel
Copy link
Copy Markdown

vercel Bot commented May 9, 2026

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

Project Deployment Actions Updated (UTC)
clickhouse-docs Ready Ready Preview, Comment May 11, 2026 3:51pm
3 Skipped Deployments
Project Deployment Actions Updated (UTC)
clickhouse-docs-ko Ignored Ignored Preview May 11, 2026 3:51pm
clickhouse-docs-ru Ignored Ignored Preview May 11, 2026 3:51pm
clickhouse-docs-zh Ignored Ignored Preview May 11, 2026 3:51pm

Request Review

@Blargian Blargian merged commit 938adb0 into main May 12, 2026
16 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants