Can we get a forum section devoted to documentation?
Andre Artus
andre.artus at gmail.com
Fri Aug 16 12:57:01 PDT 2013
On Friday, 16 August 2013 at 19:29:46 UTC, Jonathan M Davis wrote:
> On Friday, August 16, 2013 10:41:19 Andrei Alexandrescu wrote:
>> The converse risk is balkanization. We already have subgroups
>> that are
>> effectively dead, for which similar arguments were made in the
>> past.
>
> Plus, if one of the main complaints with regards to the
> documentation is that
> only a few people know the correct behavior for each of the
> various items
> which need to be documented, splitting off into your own group
> where those
> people probably won't even be isn't very helpful.
>
> - Jonathan M Davis
It is disheartening to think that the people with potential for
the most valuable contributions or insight will be avoiding
discussions regarding the documentation. But I fear you are
correct.
I have admittedly not been around here for long, but haven't seen
too many discussions focused on documentation (other than to
bemoan/defend DDOC, which in itself seems not to do much towards
improving the actual documentation).
I have proposed a changes to the documentation before but it's
obviously less interesting than the optimal way to decelerate an
automobile.
English is not my mother tongue, and I am not always confident
that I have expressed myself in the manner I intended. It's
difficult to make sure that one does not just directly translate
idiomatic expressions from your mother tongue that don't make
sense to others.
I'm happy to follow the convention proposed by Andrei. Although I
fear it lacks discoverability for newcomers. Perhaps over time we
can build enough interest in the documentation to warrant a more
focused approach.
More information about the Digitalmars-d
mailing list