Comment by alasdair_
5 years 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-functiona...
Sense 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/140130...