3 ms·
Bland is boring and boring documents tend not to be read. Succinct writing with some humor or at least some character to it will actually get that functional s
by alasdair_ 5y ago
Bland is boring and boring documents tend not to be read.
Succinct writing with some humor or at least some character to it will actually get that functional spec read.
Joe Spolsky wrote a good piece on this topic: https://www.joelonsoftware.com/2000/10/02/painless-functional-specifications-part-1-why-bother/ https://www.joelonsoftware.com/2000/10/02/painless-functiona...
- chiefalchemist 5y agoSense of humor? 1) humor? it's subjective 2) you better be spot on because humor can easily be misinterpreted. 3) along the same lines, it's likely not everyone reading will be of the same native language and/or culture. Humor will likely marginalize them. 4) Frank Luntz "Words That Work". Chapter 1 is comms evergreen gold. https://www.amazon.com/Words-That-Work-What-People/dp/1401309291 https://www.amazon.com/Words-That-Work-What-People/dp/140130...