Use h2 for default section headings in Aliki

[st0012]

Use h2 for the default Constants, Attributes, and method group headings in Aliki. This better follows W3C guidance on heading hierarchy and fixes their misleading nesting in “On This Page.”

Keep h3 for headings inside named sections, where they sit below the section’s h2 heading.

Fixes #1822.

[github-actions]

Documentation preview

View the preview

Commit: dc2301b

[Copilot]

Copilot review overview

🟡 Changes recommended

Regression tests are needed for both default and named section heading levels.

Review effort: Balanced
Findings: 1

Open (1)

• Add generator tests for default and named section heading levels · New

What changed in this PR

Updates Aliki’s heading hierarchy to correctly represent default and named sections.

Changes:

• Uses h2 for default Constants, Attributes, and method headings.
• Retains h3 beneath named section headings.

File	Description
lib/​rdoc/​generator/​template/​aliki/​class.rhtml	Selects heading levels based on whether the section is named.

---

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Copilot review overview

🟢 Approval recommended

The focused template changes match the requested hierarchy and are covered by representative regression assertions.

Review effort: Balanced
Findings: None

Resolved since last review (1)

• Add generator tests for default and named section heading levels