But yak shaving is funBut yak shaving is fun<br>The joy of building from scratch 2019.07.31<br>KO | ENThis blog doesn’t use a static site generator or framework like Jekyll, Hugo, or Gatsby. I tried a few of them at first, but they gave me too little freedom to customize, so I decided to build the blog myself. Early on I just wrote posts in HTML, but that was so inconvenient that I built a system for writing posts as JSON files. That too was awkward for longer pieces, so I developed a service that converts Markdown files into HTML files. Then I built a tool to compile and deploy the resulting files. In the end, I’d built a static site generator from scratch.This kind of thing is called yak shaving. The term was coined by Carlin Vieri, a PhD student at the MIT AI Lab, and it refers to doing a chain of related tasks for a single goal until you lose the original purpose entirely and end up on something completely unrelated. An example mentioned on LangDev IRC makes it clear why it’s called yak shaving.I get an axe to chop down a tree.The axe is too dull, so I go looking for a stone to sharpen it.But I hear that a certain village has a really good stone.I get a yak to travel to that village.The yak’s hair is too long, so I start shaving it.There’s also an example from Seth Godin, the entrepreneur, marketer, and author.“I should wash the car today.”“Oh no, the hose is busted. I’d better buy a new one at Home Depot.”“But Home Depot is on the other side of the Tappan Zee Bridge. I have to go through the toll, so I need an E-ZPass.”“Wait! I think I could borrow my neighbor’s E-ZPass…”“But Bob won’t lend me his E-ZPass until my son returns the pillow he borrowed.”“The pillow has shed so much yak hair that I can’t just give it back. I’ll have to restuff it with yak hair.”And so, just to wash the car, I end up at the zoo shaving a yak.Both stories came after the term yak shaving was coined; the term itself was actually born somewhere else. Carlin Vieri, who had played hockey late into a Tuesday night, was eating dinner in the middle of the night and watching TV. On TV was the Yak Shaving Day episode of the cartoon The Ren & Stimpy Show. The plot goes like this:Yak Shaving Day is five days off. Ren and Stimpy decorate the house by hanging a dirty diaper on the wall and pouring coleslaw into their boots. Then they set shaving cream and a razor on the bathroom sink and pray that a shaved yak will fly in on a magic kayak and bring them gifts. That night, the yak emerges from the bathtub drain, shaves, and leaves a gift in the sink before going: the very scum of the cream it used to shave.[1]<br>Carlin Vieri found this bizarre. A few days later, while pulling an all-nighter on paperwork (annoying chores like getting an administrator’s permission, setting up a DHL account, and finding a post office), he told a colleague he was yak shaving. He kept using the phrase with people in the lab over the next few months, and the term caught on.[2] The cartoon is so strange, and has so little to do with software, that its origin doesn’t seem to be widely known.One mistake engineers (or the managers running engineering teams) often make is “building from scratch.” An engineer might not quite like the off-the-shelf solutions, or might want to prove their own skill. A client or manager might have a mistaken idea of what existing solutions do, or might think those solutions don’t precisely meet the requirements.Whether it’s production or a toy project, most projects have a limited budget and limited time. Build from scratch and you eventually start shaving a yak, and once you start shaving, there’s no telling where it ends. In the end you give up the original goal. In a case like that, the right move is to find an alternative that satisfies the core of the requirements and to cut the work down as much as possible.But yak shaving is fun.Yak shaving can’t help but be fun. Making something that didn’t exist before, finding and solving problems, digging through a chain of knowledge to understand how something works: all of it pulls engineers in. The very idea of building the thing you want yourself is appealing even if you aren’t an engineer. In The Mythical Man-Month, Frederick P. Brooks Jr. gave these reasons why programming is fun:[3]The sheer joy of making things.The joy of making something useful to other people.The fascination of fashioning a complex, puzzle-like object out of interlocking moving parts, and watching the rules you built into it play out in subtle cycles.The joy of constant learning.The joy of working with a flexible, easily handled medium of expression.TeX, too, was born from shaving a yak. TeX is a typesetting system created by Stanford professor Donald Knuth; the name covers the whole system that runs the program, including the typesetting language and the compiler that processes it.[4] Because it makes formulas easy to enter, it’s widely used in the social sciences and in science and engineering. (LaTeX, a set of macros for...