"Getting involved" on dlang.org?
Chris via Digitalmars-d
digitalmars-d at puremagic.com
Thu Dec 3 02:32:45 PST 2015
On Wednesday, 2 December 2015 at 21:46:39 UTC, Andrei
Alexandrescu wrote:
>
> There is awareness. Good documentation is something we know we
> need and is an ideal to live into.
>
> Problem is prioritizing. I must be spending cumulatively a
> couple of hours everyday just deciding what to work on next.
> Forty-six emails are waiting in my Inbox, earliest from
> September; most likely their senders either have long forgotten
> about them, or are wondering about my manners. But each is
> nontrivial. Some are one mini-project each, and some are major
> projects in themselves.
>
> There are occasional mini-fires on the forum, and literally I
> could fill every day with work suggested on the forum. I'm
> trying to delegate as best I can. As is widely known around
> here, that works only sometimes, and sadly not always things
> are done the way I'd wish are.
>
> At the same time my mind is burning at both ends with work on
> the containers. Which are going to be awesome. There's so much
> going on, I find myself scheming and running calculations first
> time I open eyes in the morning (actually even before :o)) and
> last time before I fall asleep.
>
> In this context, it's very difficult for me to think, "Sure,
> the best work of my life can wait. Now let me sit down and
> write a good tutorial."
>
> I thought dedicating my time to D will make things much easier
> - but in fact the added focus and productivity only piles more
> things on the plate!
>
>
> Andrei
This goes without saying. Nobody in the community expects you or
Walter to write a tutorial how to contribute to D. The points
made here refer to the fact that every so often you post a thread
asking people to contribute and mention the documentation among
other things. However, it's not really easy to get involved,
because information is hidden - "Getting involved" is not even on
the front page - and while there are steps that describe how to
pull and push with git, there are some steps in between that are
not 100% clear due to git not being the friendliest tool to work
with, and github adds yet another layer of complexity. What needs
to be added are tips & tricks along with typical pitfalls and
common mistakes (cf. bachmeier's post).
Many people have mentioned that they _would_ contribute, if it
didn't take them hours of trial and error to get things working
(even long standing contributors have said that it can be quite
nasty at times). I think the lack of action on the side of the
community can be attributed in parts to the relatively high entry
threshold for even trivial changes.
On a lighter note, I know how it feels when you think about a
project when you go to bed, and again before you even open your
eyes in the morning. I find that it helps _not_ to think about
these things too hard when you're "off" (whatever that means in
your case). Personally, I have better ideas, when I detach myself
from a project, do something else and come back with a fresh
head. But everyone is different. I don't know what works for you.
More information about the Digitalmars-d
mailing list