Chapter 19: Being Specific
Mull It Over
Is a poor specification better than no specification at all?
A factually incorrect or painfully out-of-date specification is definitely worse. It will send readers down a blind alley and waste a lot of their time. The false information it contains could easily lead to broken code that will cost a lot of time, energy, and money to fix later on.
If a specification is ambiguous or misses important information, then you’re hoping that the readers are experienced enough to recognize the problem and interpret the information carefully. Hopefully they’ll all make the same set of assumptions about the missing information. A specification should really stand on its own and not require the intuition of its readership. ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access