News for hackers. Stuff that matters.
Re:Why I close pull requests by vincnetas on Thursday December 29, 2016 @02:59AM (#13276212)
Talking about desing documments i think internet would be a mess without RFC's (https://en.wikipedia.org/wiki/Request_for_Comments) which i think are formal design documents...
Re:Why I close pull requests by fdsfsaa on Thursday December 29, 2016 @03:04AM (#13276221)
RFCs are usually protocol specifications. Specifications are usually intended to facilitate interoperability. They document protocols or grammars or some other artifact. Specifications need to be well-written and precise.

The kind of design document that I frequently find superfluous isn't a specification of some protocol, but a prose description of the code one intends to write.

In concrete terms, an RFC might describe TCP header flags and the TCP state machine, but it'd be silent on the Linux kernel's sk_buff structure. A design document would describe sk_buff in detail.