package.elm-lang.org icon indicating copy to clipboard operation
package.elm-lang.org copied to clipboard

It is not very semantic

Open nilslindemann opened this issue 7 years ago • 0 comments
trafficstars

Compare this or this or this or this or, for the records, this

... with this.

Lets look at the html via the Developer tools (because there is no raw html). It is not perfect in terms of semantics. It mimics <center> (which was depreaced) and <footer> using css classes. There are inline styles, there are unnamed, standalone wrapper divs.

What i see when i look at these documents is actually a <header>, a <main>, a <nav> and a <footer>. The <header> contains a .logo, a .breadcrumb (where 'elm' is not clickable, which i find irritating). The <nav> contains a .general-info, a .search-entry and the .search-results. The <main> contains another <header>, an .introduction <section>, then some .functionality <section>´s, those containing .api-element <section>´s (or <article>´s if you want), those containing .signature´s, text and .code-example <pre>´s. The <footer> contains a <time> and an <address>.

Does the html and the css names reflect that structure? Not very well. Read here and here why such a structure is good.

nilslindemann avatar Nov 07 '18 08:11 nilslindemann