On Thursday, 18 August 2016 at 11:28:10 UTC, Chris wrote:
On Thursday, 18 August 2016 at 09:49:17 UTC, Shachar Shemesh
wrote:
Documentation is like sex.
When it's good, it's very good.
When it's bad..... it's still better than nothing.
Your comparison is not 100% correct. While those who enjoy
making love are the same people who are doing it, writing docs
is enjoyed by others, but not by the one(s) doing it.
Warning - this is has gone quite off-topic, so before you start
to criticize the following sentence, let's better focus on the
bigger issue here: documentation for most D packages is terrible.
There is a fix: s/sex/porn/g