w3c html validation error – Section lacks heading. Consider using h2-h6 elements to add identifying headings to all sections

Either: Add a heading (h1, …, h6) tag to your section element. Replace your section element with a div element. Ignore the warning. The message you’re seeing is a non-normative usage recommendation, as per the HTML5 spec (highlighting mine): The theme of each section should be identified, typically by including a heading (h1–h6 element) as … Read more

Adding a cross-reference to a subheading or anchor in another page

The expression “reST/Sphinx” makes the scope of the question unclear. Is it about reStructuredText in general and Sphinx, or only about reStructuredText as used in Sphinx (and not reStructuredText in general)? I’m going to cover both since people using RST are likely to run into both cases at some point: Sphinx Besides the domain-specific directives … Read more