[Bug] Footnotes in HTML are semantically incorrect

[TimidRobot]

Description

faq/faq/index.html

Lines 3747 to 3756 in 0bf0734

	<h2 id="notes">Notes</h2>
	<section id="footnotes" class="footnotes footnotes-end-of-document"
	role="doc-endnotes">
	<hr />
	<ol>
	<li id="fn1"><p>Key Publications, Inc.&#xA0;v. Chinatown Today Publishing
	Enterprises Inc., 945 F.2d 509 (2d Cir. 1991).<a href="#fnref1"
	class="footnote-back" role="doc-backlink">&#x21A9;&#xFE0E;</a></p></li>
	</ol>
	</section>

#76 (comment):

This isn't semantically correct. The h2 of "notes" would need to be inside the section element, as a section generally requires a heading element to denote it.

It could be argued that of the two, the aside is actually a more appropriate element, but it too would need the h2 to be within it as well. An aside does not require a heading element within it, but if one appears for it, it must appear within it.

The MOST semantic, and likely correct route, would be for the endnotes to appear (with the associated h2) within a footer element (instead of a section or aside). As they are meant to be footnotes for the main section, that is the next parent level sectioning element and they would then be semantically associated as the "footer of the main area", which is much more accurate to what the footnotes are in this case.

sooo...

<footer>
<h2 id="notes">Notes</h2>
notes here
</footer>
</main>

As divs are semantically meaningless whether it appears before or after the closing div tag is semantically irrelevant, just whichever one wouldn't throw off the visual styling.

Expectation

HTML should be semantic and provide best possible support for accessibility aids

[TimidRobot]

The HTML is generated from the markdown using Pandoc: Footnotes.

Unfortunately, I don't currently see any way to accomplish the desired state using Pandoc alone. I doubt we will be able to resolve this issue with the current technology stack/process.

[imme-emosol]

No support for adding/changing heading of footnotes here https://github.com/jgm/pandoc/blob/7b29962d869224e19e677cf5acc3aa3eaec1d352/src/Text/Pandoc/Writers/HTML.hs#L530

French markdown does not use markdown syntax for footnotes / document-internal-references

faq/faq-fr.md

Line 2698 in 8c7f8e2

## Remarques

Given the markdown document(s) use the markdown syntax for footnotes / document-internal-reference and the mrkdown document(s) end with a level two heading element (only followed by footnotes / document-internal-references), the build could alter the pandoc generated content based on the assumption that pandoc generates a line that begins with /<h2 id="/, followed by a line that starts with /<section id="footnotes" class="/ (followed by a /<hr \/>/, if the level two heading should come after that hr).

Since the build script shebang mentions bash, the example script written under 'Bash String Manipulation' on https://thelinuxcode.com/replace_string_in_file_bash/ should give insight on how to accomplish this post pandoc output alteration. But perhaps a tool like sed can also be expected to be available in the build environment.