Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

📚 Consistent heading levels inside method rdoc #361

Merged
merged 1 commit into from
Dec 14, 2024

Conversation

nevans
Copy link
Collaborator

@nevans nevans commented Dec 14, 2024

All headings inside Net::IMAP method rdoc have been set to h4. This assumes that the method documentation is already three levels deep:

  • <h1> -- the page title, i.e: the class name
  • <h2> -- the category, i.e: "Instance Methods"
  • <h3> -- the method name

The first two heading levels are handled correctly by rdoc, but the third level is unfortunately output as a <div>, not an <h3>. (TODO: make a ruby/rdoc PR to fix this.)

All headings inside Net::IMAP method rdoc have been set to `h4`.  This
assumes that the method documentation is already three levels deep:
* `<h1>` -- the page title, i.e: the class name
* `<h2>` -- the category, i.e: "Instance Methods"
* `<h3>` -- the method name

The first two heading levels _are_ defined on the page, but the third
level is unfortunately output as a `<div>`, not an `<h3>`.
@nevans nevans added the documentation Improvements or additions to documentation label Dec 14, 2024
@nevans nevans merged commit 525577c into master Dec 14, 2024
30 checks passed
@nevans nevans deleted the docs-consistent-heading-levels branch December 14, 2024 15:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Development

Successfully merging this pull request may close these issues.

1 participant