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-unsubscr...@httpd.apache.org For additional commands, e-mail: docs-h...@httpd.apache.org
