Aliki format for class/module has H1 element for title, and H3 elements for boiler-plate sections "Constants,", "Public Class Methods," etc.
This means that when the last heading in the (human-written) class/module doc is H2 (say, titled "Foo"), the right-side "On This Page" section will make it appear the boiler-plate elements are subordinate to the "Foo" section.
See, for example, https://docs.ruby-lang.org/en/master/Integer.html, wherein the H2 section "What's Here" seems to contain sections "Constants" etc.
I think the boiler-plate sections should be H2, and thereby subordinate only to the H1 title.
Aliki format for class/module has H1 element for title, and H3 elements for boiler-plate sections "Constants,", "Public Class Methods," etc.
This means that when the last heading in the (human-written) class/module doc is H2 (say, titled "Foo"), the right-side "On This Page" section will make it appear the boiler-plate elements are subordinate to the "Foo" section.
See, for example, https://docs.ruby-lang.org/en/master/Integer.html, wherein the H2 section "What's Here" seems to contain sections "Constants" etc.
I think the boiler-plate sections should be H2, and thereby subordinate only to the H1 title.