On Friday, 25 July 2014 at 17:32:38 UTC, Andrei Alexandrescu
wrote:
"Wyatt" <wyatt....@gmail.com> wrote:
On Friday, 25 July 2014 at 15:59:18 UTC, Gary Willoughby wrote:
The D community is hoping those discussion sections start
being
used in the same way the PHP documentation is used.
We are? Please, no. Holding the PHP doc comments up as an
example of a
positive thing is alternately alternately hilarious and
terrifying.
-Wyatt
Why? I don't have much context but a few people I talked to
were positive
about the community contribution to php docs. -- Andrei
I've written about this before, but here's the summary:
There will be a comment thread on every single function in the
standard library where people will say whatever they want and we
can't stop them ahead of time.
- Anything they could possibly post there that's legitimately
worth having would be better off canonised in the docs in the
first place.
- Any questions they ask would be better asked on D.learn.
- Any other post may be subtly incorrect, previously correct,
incredibly unsafe, correct with caveats, or a multitude of other
shades of wrong.
- Everything else is noise.
We'd be better off wikifying the whole lot of it, and I don't say
that lightly. At least then there's the possibility of it being
clear what's changing and who is changing it.
-Wyatt
