"Getting involved" on dlang.org?

bachmeier via Digitalmars-d digitalmars-d at puremagic.com
Wed Dec 2 13:25:05 PST 2015


On Wednesday, 2 December 2015 at 21:22:43 UTC, bachmeier wrote:
> On Wednesday, 2 December 2015 at 16:54:56 UTC, Chris wrote:
>> Good that we're talking about this now. Maybe the D leadership 
>> is not aware of this. Too many little annoyances that keep 
>> people from contributing.
>
> I'm going to guess that they are probably not aware of it. When 
> you are the one that makes the rules, you don't face any of the 
> issues that follow from not knowing the rules. And if you are a 
> core developer, there's no problem with assuming that 
> Git/Github usage is trivial.
>
> The important question is what we are going to do about it. A 
> starting point would be to state the rules:
>
> This is the style you have to use.
> This is what you can and cannot assume the reader knows.
> This is what examples should and should not look like.
> This is what See_Also is for.
>
> And so on. Of course, I can't write the document, or else I 
> wouldn't need it.

Oh, and one more: someone should be able to say, "This is what 
I'd like to do with the documentation for this function. What do 
you think?" I have no plan to create a PR unless I expect it to 
be accepted.


More information about the Digitalmars-d mailing list