Thatâs in a Guideline
Post from May 17, 2016 (â» December 5, 2021), filed under Web Development (feed).
About two weeks ago I ended a little lottery to give away signed copies of my last book, The Little Book of HTML/CSS Coding Guidelines. Overall, the response was low (8 comments, 3 tweets, 2 notes elsewhere). But I promised to feature select feedback and, of course, the winners. Here we go.
-
Matthias Schelling: âIn CSS, not every property/value pair speaks for itself
[âŠ]. Always write comments for these ambiguous declarations[âŠ]!âI wish to comment without rating: I deem this an important idea but also a tricky one, for it involves making assumptions about what fellow developers know. For beginners we could need to comment everything, for some experts truly nothing.
-
Gabriel Song: âGuidelines improve consistency among code by multiple authors [which leads to] better readability and collaboration.â
This hits close to an opening point in The Little Book of HTML/CSS Coding Guidelines: âThe major, direct benefit of coding guidelines is improved consistency. Why? Because with comprehensive coding guidelines all code gets formatted the same way.â
-
Shay Cojocaru: âConsistency among team members and keeping concerns separated.â
Separation of Concerns is a key to improving maintainability and I agree that this makes for a vital piece in coding guidelines.
-
Sophie CĂ©line: âMost important lesson for me was keeping code well structured and as clean, short and simple as possible.â
This is a great lesson that serves all of us đ
-
Anton Maslo: âFor me the most important part of guidelines is to avoid future pain. It may be quick to bolt on thoughtless hacks here and there (getting the job done!)âuntil something trivial takes hours to find out âWhere does it fit in this bloated mess?ââ
Although the interesting question for our work is, how exactly do we avoid future pain, it is the forward direction that I like to see in this thinking. We should develop for the present but still look ahead.
The frameworks book, then, shall go to:
-
Jim Lehmer: âCoding guidelines are important because they keep me from walking down the hall and strangling a junior dev!â (with a smiley).
I wish this not to become common practice but like to acknowledge this comment for most of us will be able to relate, in a compassionate way đ
Thanks everyone for participating! If youâre among the winners, please email me so that I can arrange for getting you your copy. Until the next âLittle Bookâ!
About Me

Iâm Jens, and Iâm an engineering lead and author. Iâve worked as a technical lead for Google, Iâm close to W3C and WHATWG, and I write and review books for OâReilly. I love trying things, sometimes including philosophy, art, and adventure. Here on meiert.com I share some of my views and experiences.
If you have a question or suggestion about what I write, please leave a comment (if available) or a message. Thank you!
Read More
Maybe this is interesting to you, too:
- Next: Problems, No Problems, Desires
- Previous: Whatâs in a Guideline? Win a Copy of the Little Book of HTML/CSS Coding Guidelines!
- More under Web Development, or from 2016
- Most popular posts
Looking for a way to comment? Comments have been disabled, unfortunately.

Get a good look at web development? Try The Web Development Glossary (2020). With explanations and definitions for literally thousands of terms from Web Development and related fields, building on Wikipedia as well as the MDN Web Docs. Available at Apple Books, Kobo, Google Play Books, and Leanpub.