How do I submit documentation...
Chad J
chadjoan at __spam.is.bad__gmail.com
Sat Jun 23 17:39:00 PDT 2012
...without wanting to slit my wrists?
I see that https://github.com/D-Programming-Language still has a bunch
of the core D projects huddled together, but no single repository that
binds it all together.
This is immensely frustrating if I want to do any contributions to DMD,
Phobos, or the documentation. Right now I'd like to contribute to
documentation mostly. I haven't done so because there is an annoying
barrier to entry: I better be able to download and compile everything so
that I can write unittests so that I can write documentation. I really
want to be able to download /one single repository/ and then type "make
all" and have it /just work/. But no, I have to download each of these
things individually and figure out where each of them goes in some kind
of canonical directory structure that everyone except me knows. Oh, the
me from a few months ago knew where to put things. The me from now will
need to be told again -- or do a grindy search over old emails.
If I'm going to make a pull request for every few words I edit or every
example/unittest I want to add, then the {pull->edit->make docs->test
with browser->push} cycle has to be very fast. Right now, it would
probably be a few hours before I even have things setup well enough that
I can even /start/ editing.
I know it takes a while to mess with this stuff because I've done it
some months ago. It was thanks to bug #5278
(http://d.puremagic.com/issues/show_bug.cgi?id=5278) which makes it so I
can't use DMD without applying my own patch and building from source.
I've done it a couple other times when I wanted to mess with DMD/phobos
internals too. Every time it takes hours of completely unproductive
wasted time to build from source.
This is in stark contrast to wikis and the like where there's a button
to /just edit the page dammit/. I understand that this would be way too
unmoderated for D's central projects, but it would be very nice if we
had something closer to that. At this point though I'd settle for just
being able to build dmd/phobos/docs easily because it seems like a
reasonable thing to ask for.
So how about it, all-encompassing D git repo and buildscripts please?
More information about the Digitalmars-d
mailing list