Change rendering of headings: Render h1 as h3, h2 as h4, etc. This probably makes much more sense than not using h1 at all and starting with h2 in doc comments (as I currently do). Have a closer look at how hX elements are currently used by the standard doclet and the API documentation, and how we best fit in with headings in the doc comments. Alternatively, just adapt the CSS.
Note: This may break compatibility with older versions.
Change rendering of headings: Render h1 as h3, h2 as h4, etc. This probably makes much more sense than not using h1 at all and starting with h2 in doc comments (as I currently do). Have a closer look at how hX elements are currently used by the standard doclet and the API documentation, and how we best fit in with headings in the doc comments. Alternatively, just adapt the CSS.
Note: This may break compatibility with older versions.