News for hackers. Stuff that matters.
Re:WTFM - Write The Freaking Manual by protomyth on Friday September 28, 2012 @11:13AM (#4585933)
I remember reading a story about Pages for Pages on NeXTSTEP. The manual was done before the software, so if there was any design question about how the program should work, they turned to the manual. I think it was an article by Bruce Webster (he is an awesome writer).
Re:WTFM - Write The Freaking Manual by dredmorbius on Friday September 28, 2012 @07:12PM (#4588244)
That's a code authoring technique I picked up from Code Complete.

It's useful for keeping your code in conformance with documentation. The problem is when the original spec turns out to be impossible (or difficult/expensive) to implement, and needs to be changed.

However if you doc then build, you've got a change control process that should accommodate this.