tinacms / tina.io

Website for TinaCMS 🦙 - General info, documentation, blogs & contribution guidelines.
https://tina.io
246 stars 1.59k forks source link

🐛 Heading structure - should only be a single h1 per page #2373

Open bradystroud opened 2 weeks ago

bradystroud commented 2 weeks ago

🐛 Describe the Bug

Right now the heading hierarchy doesn't make sense. This is important for SEO and accessibility

Image

🧑‍💻 Reproduction Steps

  1. Test tina.io on https://adresults.com/tools/heading-tag-checker-check-h1-t-m-h6-tags
  2. See that the headings dont make sense

🎯 Expected Behavior

Headings make sense

Details

Heading tags are levels in the structure of a web page, with the `

` tag by default serving as the page title. There should therefore only be one `

` tag per web page. Then levels can be created with `

` tags, and sublevels with `

` to `

` tags. `

` and `

` tags should appear on every web page; the usage of `

` to `

` tags is optional. The most important thing is that heading tags are used according to the standard paragraph structure. So for what would normally be paragraph 1.1 and subsection 1.1.1, you respectively use `

` and `

` tags. To give you an idea of what that might look like: ```html

Title

Paragraph 1

Paragraph 2

Paragraph 2.1

Section 2.1.1

Paragraph 2.2

Section 2.1.2

Paragraph 3

``` In this example the levels are also indicated by indentations, to show you that a

tag is never directly followed by a

tag. Source - https://adresults.com/tools/heading-tag-checker-check-h1-t-m-h6-tags

💼 Tasks

✅ Acceptance Criteria

-[ ] Heading structure follows

Cc: @Marxoz @bettybondoc

landonmaxwell commented 1 day ago

Image Figure: Pages that need fixing - no h1

landonmaxwell commented 1 day ago

tina.io_multiple_h1_tags_20241113.xlsx Pages with multiple h1 headings