Re: [Docutils-users] rst2html5 title demotion?

[Alan G. I. <ala...@gm...>]

On 5/24/2021 4:28 AM, Guenter Milde via Docutils-users wrote:
> I changed the default value for the "html5" writer to bring it in line
> with HTML5 behaviour after making it write <section> instead of <div
> class="section">. Of course you should use CSS, but I believe it is a bad
> idea to force everyone to define the visual features for every <Hn> level
> in order to override current browser default just to keep using <H1> for
> both, title and first-level section heading when the "web consensus"
> moved to using <H1> for the title and <H1+n> for section headings --
> independent of my personal preference in this question.


I am not going to drag out this discussion, but I must make one
last appeal to revert the default behavior.

Changing the meaning of a section header because it occurs
a second time seems to me to be fundamentally broken behavior.
So I must ask: how much consultation did you do on this?
E.g., Did David agree that this is good behavior?

I already pointed out that it means that combining two
documents (e.g., with an `include`) that have compatible
header notation and individually format perfect produces
a broken combined document. That's exactly how I discovered
this change. This alone should cause immense hesitation.

Also, this decision seems out of step with the current
understanding of HTML document structure.
For example, consider:
https://www.impactplus.com/blog/multiple-h1-headlines-okay
https://webdesign.tutsplus.com/articles/the-truth-about-multiple-h1-tags-in-the-html5-era--webdesign-16824

Thus I again urge reverting this change.
However, this is my last comment on this matter.

Thanks for all your work!
Alan Isaac