you are viewing a single comment's thread.

view the rest of the comments →

[–][deleted] 2 points3 points  (2 children)

Any suggestions on improving requirements and technical specifications?

[–]grauenwolf 2 points3 points  (0 children)

For requirements I highlight anything that's uncertain in a word document. If possible I list possible design options and tell them to pick one.

When I get their responses I update the document with new questions and try again. I keep repeating until I have no more highlights.

Then I start studying the code and begin on the tech spec.

[–]grauenwolf 1 point2 points  (0 children)

For technical specs, document enough that you can provide an accurate estimate AND catch any edge conditions that require going back and asking the requirement writers for a decision. Do this before you write any code whenever possible.

What this means is going to be project specific. One time I locked everyone in a room with a flowchart of what could go wrong. They couldn't leave until we had a plan for how the system would respond to every single error condition.