On Wednesday, 30 July 2014 at 13:10:35 UTC, Wyatt wrote:
Serious question: what exactly is "supplemental documentation"?
In my view, if it's good enough to be considered
documentation, it belongs in the documentation. Anything else
is just pussy-footing around.
Consider information like "how to do X with Y". The combinations
may be endless and opinions will vary about which cases warrant
mention in the reference documentation. Placing it on a Wiki page
sidesteps all that. We have to be careful not to clutter up the
reference documentation with trivial information; it's not a
tutorial.
Further, as it is, reference documentation can only be updated by
going through peer review. A Wiki on the other hand would have to
be moderated after-the-fact and peer review would not be
guaranteed.
When it comes to asking questions, I agree we have plenty of
outlets more appropriate than Disqus as it is, including D.learn,
the IRC channel and StackOverflow.
Disqus just doesn't buy us anything, while the disadvantages are
numerous.
