On Wednesday, 30 July 2014 at 00:40:09 UTC, Brad Anderson wrote:
Andrei did say forum integration would be prefered back when
you mentioned it[1]. The more I think about this though the
more I think you are right that wiki would be superior to
comments but I share your concern for wiki comments being
terrible.
Wikifying the whole of the documentation itself would be more
useful than just using it for the comments. I'm not very fond of
that, personally (it tends to look generic and mediocre), but it
has paid dividends in Gentoo and Arch. And as an added benefit,
it's relatively easy to get a broad view of what's changing and
revert vandalism.
Thinking about this even more I've come to the conclusion that
there are two main use cases to justify user comments on
documentation pages: 1. Asking questions. 2. Supplemental
documentation. Neither of these is well solved by user comments
(whether by disqus or forum).
Thank you! I've been saying this since at least last year and
I'm glad I'm not the only one.
The first use case, asking questions, is best addressed by
something like Stack Overflow.
Or D.learn.
The second use case, supplemental documentation, is a perfect
fit for wiki integration.
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.
-Wyatt