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