http://wiki.dlang.org/Starting_as_a_Contributor reorganization

Andrei Alexandrescu via Digitalmars-d digitalmars-d at puremagic.com
Mon Dec 14 12:47:27 PST 2015


http://wiki.dlang.org/Starting_as_a_Contributor has multiple 
sections, each divided into subsections dedicated to distinct 
operating systems. As someone who started this document, I am 
thankful for the value added.

There's a problem though: I realized it a while ago while reading 
some assembly instructions for a piece of furniture, which were 
structured similarly for multiple languages (English, Spanish, 
French, Portuguese, ...). They were quite difficult to follow, 
and it was striking to realize that any given reader would have 
similar difficulties because they want to follow one language 
through, not each step explained in all available languages.

Similarly, the current structure of our document works against 
its readability. A given reader is likely to follow all steps 
under a given operating system, not each step on several 
operating systems.

I see Vladimir and Jack did these changes. Could you please 
restructure the document into three - one for each of the OSs we 
support?


Thanks,

Andrei


More information about the Digitalmars-d mailing list