// the find
necolas/idiomatic-html
Principles of writing consistent, idiomatic HTML.
A short style guide for HTML authored by Nicolas Gallagher around 2012, covering indentation, attribute ordering, and naming conventions. It's explicitly unmaintained and hasn't been touched in over a decade. Useful mainly as a historical reference for what front-end conventions looked like before modern tooling took over.
The attribute ordering convention (class, id, data-*, everything else) is still sensible and not obviously wrong. The naming section makes a real point about abbreviated class names being a maintenance tax. It's short enough to read in five minutes, which is appropriate for the scope.
Unmaintained since 2015 — a lot has changed. No mention of ARIA attributes, which are now a first-class concern in any HTML guide worth following. The multi-line attribute formatting example uses inconsistent indentation (one space instead of four) which is exactly the kind of thing a style guide shouldn't do. At 524 stars and a single markdown file, this is basically a gist that got popular; Prettier and HTMLHint have made most of this moot.