4 ms·
> Is there any good reason to work this way on a one-man project ? (Not the OP.) At least for me, emphatically yes. From your question, it sounds like you're
by _jal 10y ago
> Is there any good reason to work this way on a one-man project ?
(Not the OP.) At least for me, emphatically yes.
From your question, it sounds like you're only considering the communicative value of a spec. That's of course important, but I consider it secondary.
Writing a good spec forces you to think through what you're developing in an orthogonal way. You're thinking through flow, cohesiveness, design, some implementation, UI, etc. together at a high level.
I love having the time to write a spec when I'm building something nontrivial. I've found numerous problems that I wouldn't have otherwise by doing so, ranging from simple UI problems/contradictions to spotting unconsidered assumptions that would have lead me down dead ends.
A spec and the application should naturally co-evolve during development to some extent. But the spec also provides an anchor for what you're doing, as well as a map. It is very, very helpful if you Do It Right(tm), no matter the size of your team.
- VladimirGolovin 10y agoWriting a good spec forces you to think through what you're developing in an orthogonal way. (OP here). This. A thousand times this.
- trashabout 10y agoDid you follow any standards when writing? I am currently looking for ways to document and model our process and business rules.
- VladimirGolovin 10y agoI just wrote well-structured, dense, coherent / "mentally type-checked", bulleted-list prose, often copied directly from Workflowy. Some of the critical parts were described with FP-style pseudocode, for greater exactness.
- trashabout 10y agothanks!