On Wed, 29 Jun 2005, James Britt wrote:
Hugh Sasse wrote:
That's *after* he's managed it. We haven't got a "pending"
repository, then? I'm thinking of somewhere he could check as and
when he has time to do so, rather than being pestered :-)...
Is this actually needed? So far, people would write docs, post them here or
on ruby-core, get the attention of the lib owner or some other responsible
party, and (assuming the docs were OK) they go into CVS.
But the start of this thread shows this is not happening, or at
least not visibly. We need to see contributions going in, being
acknowledged, criticised, rejected, accepted etc, so people feel
contributing is worthwhile. Also the lib docs have not been updated
recently, and I don't know why that is, and I am reluctant to pester
someone who is busy. With a staging area we could see it is because
there's no additions submitted, or the person in Gavin's role could see
that the incoming docs are piling up.
If the proposed docs are not correct, then some E-mail exchange would occur.
Or people could be too busy, but we can't see how much is pending
from a mailing list. And we don't know how much traffic there is
off list. And I've never used IRC.
Has that not been working well enough that yet another level of indirection
(a stop-over in some repository) is needed?
I'm not talking about indirection: it doesn't need to be indirection
as such. People contribute as their workload permits, so they
need to be able to go somewhere and look at a Big Visible Chart
http://www.xprogramming.com/xpmag/BigVisibleCharts.htm
(only ours would need to be on thw web because there's no wall we
can all see) to see what the state of play is for the documentation
in progress.
If you can't get the attention of someone to review and commit the docs, will
having them in a repository help?
Maybe having them, or a chart, somewhere might grab that person's attention.
RSS feeds could help, too.
If I've understood things correctly, and I've not had time to look
at Rails, something like this should be a piece of Black Forest
Gateau to the Rails crowd -- not just a piece of cake, but wickedly
enjoyable, too. Or I could be spectacularly wrong!
James
Hugh
|
