Wisdom

Specs need plain-English explainers

Quote

I'm reading this and I'm like, no, no, nobody, no human is going to understand this unless you already know what it does. Right. And so I think I even wrote in the spec. This thing needs, there's going to be an explainer for it

Episode 136: Moist Splits (episode page, opens in a new tab) 00:29:17 (play audio from this timestamp, opens in a new tab)

Speaker-labeled

Summary

From years of help desk work, Dave knows a spec only makes sense to people who already know what it does, so every spec needs an explainer.