Making the Web Developer’s Pilgrimage
Tags: html, webdev, frontend, craft
Published: 2021-10-21 20:13:35

Have you read the <a href="https://html.spec.whatwg.org/multipage/">HTML specification</a>? Have you marked highlights, taken notes, and reviewed what you learned? Have you reported issues and made suggestions to the HTML working group, giving back and improving the standard?

As HTML is the most important language on the Web, and as this—reading, reviewing, feeding back on <a href="https://docs.google.com/gview?url=https://html.spec.whatwg.org/print.pdf&hl=en">2,182 pages about HTML</a>&nbsp;<a href="#note-pages"><sup>*</sup></a>—is such an epic endeavor, we may call this <strong>the Web Developer’s Pilgrimage</strong>. <em>I</em> call this the Web Developer’s Pilgrimage—and I recommend every web developer, and especially every frontend developer, to make it.

<h3>A Pilgrimage, What For?</h3>

While nothing here is religious, the field of web development, and even its subfield of frontend development, is not taking HTML as seriously as it should be taken. Everyone thinks they know HTML—the premise of my <a href="https://www.amazon.com/dp/B094W54R2N/?tag=j9t-21-20">book series</a>—, but <a href="https://meiert.com/en/blog/valid-html-2021/">close to no one demonstrates</a> they know the syntax. Perhaps unsurprisingly, close to no developer reads the HTML spec, either&nbsp;<a href="#note-specs"><sup>†</sup></a>.

That web and frontend developers produce <a href="https://webplatform.github.io/docs/guides/html_validation/">valid</a> HTML and CSS is <a href="https://meiert.com/en/blog/the-frontend-developer-test/">an important first step</a> for the profession to respect itself, and to be more respectable in comparison with other professions.

If we could also encourage web and frontend developers to work through the HTML specification, that might bring us to a whole new <strong>level</strong>.

<h3>About My Own Pilgrimage</h3>

Did I walk this talk, did I make the HTML pilgrimage? I did!—and while it was not my first specification, and <a href="https://meiert.com/en/blog/notes-on-html-32/">also not</a> my first HTML specification, it was much more work than I had thought.

I started this journey in November of last year, when I <a href="https://twitter.com/j9t/status/1332365147818627072">downloaded the spec as a MOBI</a> to read it on my phone.

Although I <a href="https://meiert.com/en/blog/10-books-a-month/">much enjoy reading</a>, the HTML specification was something I couldn’t go through very quickly—it took almost a year for me to finish. (To be fair, in that time I’ve read 73 other books. I enjoy and I track my reading.)

But when I finished, I did what I suggested above as part of the journey.

<ol>
<li>I read the specification.</li>
<li>I worked through my highlights, coming out at <a href="https://docs.google.com/document/d/1S3WYSxFqpgwAqVAM2uE5qDj1Uc2ECug84TqO_KHiS3I/edit">145 pages of quotes and notes</a>.</li>
<li>I edited parts of the specification, preparing <a href="https://github.com/whatwg/html/pulls?q=is%3Apr+author%3Aj9t+">19 PRs</a> with small and larger improvements. (Or not, as not all PRs found agreement.)</li>
<li>I filed <a href="https://github.com/whatwg/html/issues?q=is%3Aissue+author%3Aj9t+">12 issues</a> for discussion, including <a href="https://github.com/whatwg/html/issues/7187">1 omnibus</a>.</li>
</ol>

I cannot count the number of hours I put into reading, reviewing, and feeding back. (I cut the hours short recently, as you can tell by the issue “omnibus.”) I view all this effort a part of my work as a frontend specialist.

❧ Now I believe it would be a powerful ritual for web and frontend developers to join: Read the HTML specification, reflect on it, and give back to the <a href="https://html.spec.whatwg.org/multipage/acknowledgements.html#acknowledgments">many, many, many peers</a> who have contributed to the HTML standard, one of the most important technical standards there are.

Web professionals, standing on the shoulders of giants. Start and write about your HTML pilgrimage!&nbsp;🙏

<em>(That is the <em>fast track</em>. The spec suggests to be <a href="https://html.spec.whatwg.org/multipage/introduction.html#how-to-read-this-specification">read like this</a>: “This specification should be read like all other specifications. First, it should be read cover-to-cover, multiple times. Then, it should be read backwards at least once. Then it should be read by picking random sections from the contents list and following all the cross-references.” I’m out—you write about that part of the journey!)</em>

<em id="note-pages"><sup>*</sup> That’s the current page count of the HTML standard’s official PDF export, and it just recently changed, largely because of reformatting of the PDF. With the old formatting, <a href="https://web.archive.org/web/20210814073033/https://html.spec.whatwg.org/print.pdf">like in August</a>, the standard had “only” about 1,300 pages.</em>

<em id="note-specs"><sup>†</sup> Close to no, meaning very few. I recall polls on Twitter about this, including one of my own, but owe you to retrieve and share the respective data points.</em>