httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From André Malo ...@perlig.de>
Subject Re: Proposal to move docs to Apache CMS
Date Thu, 03 May 2012 07:20:50 GMT
On Thursday 03 May 2012 00:52:02 Daniel Gruno wrote:
> Clean slate here, because this is just some free thoughts:
>
> I am for moving both the site and the documentation to the CMS system if
> it indeed works as Tony explained. I'm also in favor of Noirin's
> suggestion about making how to contribute to documentation clearer.
>
> My train of thoughts as I start from the front page is:
>
> 1) Where can I contribute to documentation? I don't see it
> 2) I'm a newbie, what or who is SVN?
> 3) How do I write a patch or check out a repo? (I see a LOT of bugs on
> the docs bugzilla where people obviously don't know what a patch is)
> 4) Okay, I wrote something - why doesn't it show? I need to rebuild?
> 5) What's XSLT, I just wanted to help with a translation?!
> 6) Will everything blow up when I commit something?
> 7) I can't make Java or Perl or insert-process-here work!
>
> Apart from question 2, I had to ask all of those questions when I
> started as a contributor and moved up as a committer, and if it weren't
> for my enthusiasm, I would've stayed as a contributor and just mailed a
> few patches here and there at best.

Maybe I've missed it (quite possible), but did you ask here on the ML? I've 
heard a lot about IRC (or other) talks lately about this and that. Things 
should happen on the list - and not only the conclusions. Maybe we already 
would have a better self-documentation by now.

> So I think what Noirin pointed out 
> is actually something vital that's preventing people from contributing
> more to our documentation that they could, adding more work for the rest
> of us to do.

Yes. Answering those questions above would be a big help. Beside the technical 
answers we should also point the people to the mailing list to ask their 
questions.
However, I'm also inclined to say, that if we're not able to use our own 
self-documentation properly, we're doing something very wrong. And it's not 
very much. Just a few pages. No offense to anyone, but I'm pretty frustrated 
by the "I would contribute, but I don't bother to get some community context" 
attitude floating around.

nd

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Mime
View raw message