Can we get a forum section devoted to documentation?

Craig Dillabaugh cdillaba at cg.scs.carleton.ca
Fri Aug 16 09:29:40 PDT 2013


On Friday, 16 August 2013 at 16:07:59 UTC, Andre Artus wrote:
> I would like to contribute to the D ecosystem, but as I'm still 
> in the learning process I do not want to get my sticky fingers 
> all over someones nice clean code.
>
> I have poured over the documentation and see that there are a 
> few low-hanging fruit that I would like to pluck. So I have 
> decided to do so.
>
> I would like for there to be a section were people interested 
> in working on the docs can collaborate.

It is pretty easy to make minor corrections to the documentation
through the GitHub repo. I made such a correction myself to a
glaring documentation error recently.  My first ever open source
contribution, but hopefully many more to come in the future.  I
often thought, like yourself, that improving the D documentation
would be a good way to contribute.  Having a forum to vet ideas
would be very nice.

I find the D documentation is sorely lacking in example code, and
high level descriptions of modules (thinking more of Phobos here)
and having a forum to say "Here is some 'description/example
code' I want to add to the Phobos docs", would be a good way for
less experienced developers to start contributing. Such a forum
would be a good way to get some feedback before getting to the
point of pushing your changes to the Repo.


More information about the Digitalmars-d mailing list