News for hackers. Stuff that matters.
Re:We need to document macOS by lucaspiller on Sunday August 13, 2017 @05:43AM (#15002256)
I don't disagree with you, but I feel this misses the point about technical documentation. Code tells you how something works, but it doesn't tell you why it works that way - which is often just as important.

Unless we start writing paragraphs of comments for every little five line function, there will still be a need for technical documentation outside of code.

Re:We need to document macOS by em3rgent0rdr on Sunday August 13, 2017 @02:03PM (#15004046)
Well then maybe we all should write enough comments and tests to fully document behavior.