Skip to content

Prevent redundant H1 titles causing rendering issues with DocItemContent theme #1860

@patrikbraborec

Description

@patrikbraborec

When using "redundant" titles in documentation, the new DocItemContent theme that handles LLM buttons renders titles in a messy way. This occurs because of how Docusaurus handles titles internally.

Impact

  • Messy rendering of titles when LLM buttons are present
  • Inconsistent title display across documentation
  • Potential for recurring bugs

Proposed Solution

  • Option 1: Handle at theme level (DocItemContent) by some useEffectLayout cleaning
  • Option 2: Enforce through linter rules

Metadata

Metadata

Labels

t-docsIssues owned by technical writing team.t-dxIssues owned by the DX team.

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions