News for hackers. Stuff that matters.
Re:Ask HN: How do I learn to write good software specificati... by AnimalMuppet on Tuesday April 25, 2017 @03:11PM (#14197009)
First, you should have had to implement a number of specifications yourself, so that you have experience about what kinds of things are unclear.

Second, you should have someone else read the specs you produce, to help find the places where what you wrote was clear to you, but not clear to someone who didn't already know what you meant.

And third, you need to make it very clear: If you don't understand, ask. Email me. Better yet, call me.

There are no comments on this comment yet.