Login | Register For Free | Help
Search for: (Advanced)

Mailing List Archive: Apache: Docs
Re: Proposal to move docs to Apache CMS
 

Index | Next | Previous | View Flat


nd at perlig

May 3, 2012, 12:20 AM


Views: 638
Permalink
Re: Proposal to move docs to Apache CMS [In reply to]

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 [at] httpd
For additional commands, e-mail: docs-help [at] httpd

Subject User Time
Proposal to move docs to Apache CMS rumble at cord Apr 30, 2012, 8:36 AM
    Re: Proposal to move docs to Apache CMS rbowen at rcbowen Apr 30, 2012, 8:46 AM
        Re: Proposal to move docs to Apache CMS rbowen at rcbowen Apr 30, 2012, 9:21 AM
            Re: Proposal to move docs to Apache CMS sf at sfritsch Apr 30, 2012, 9:48 AM
                Re: Proposal to move docs to Apache CMS nd at perlig May 1, 2012, 10:14 AM
            Re: Proposal to move docs to Apache CMS nd at perlig May 1, 2012, 10:15 AM
    Re: Proposal to move docs to Apache CMS mads at toftum Apr 30, 2012, 9:02 AM
    Re: Proposal to move docs to Apache CMS joe_schaefer at yahoo Apr 30, 2012, 9:46 AM
    Re: Proposal to move docs to Apache CMS joe_schaefer at yahoo Apr 30, 2012, 10:02 AM
    Re: Proposal to move docs to Apache CMS nd at perlig May 1, 2012, 10:12 AM
    Re: Proposal to move docs to Apache CMS noirin at apache May 2, 2012, 2:00 PM
    Re: Proposal to move docs to Apache CMS nd at perlig May 2, 2012, 2:40 PM
        Re: Proposal to move docs to Apache CMS pctony at apache May 2, 2012, 2:46 PM
        Re: Proposal to move docs to Apache CMS noirin at apache May 2, 2012, 2:50 PM
        Re: Proposal to move docs to Apache CMS rumble at cord May 2, 2012, 2:53 PM
            Re: Proposal to move docs to Apache CMS pctony at apache May 2, 2012, 2:58 PM
    Re: Proposal to move docs to Apache CMS pctony at apache May 2, 2012, 2:55 PM
    Re: Proposal to move docs to Apache CMS nd at perlig May 2, 2012, 3:07 PM
        Re: Proposal to move docs to Apache CMS noirin at apache May 2, 2012, 3:13 PM
    Re: Proposal to move docs to Apache CMS pctony at apache May 2, 2012, 3:18 PM
    Re: Proposal to move docs to Apache CMS rumble at cord May 2, 2012, 3:28 PM
        Re: Proposal to move docs to Apache CMS rumble at cord May 2, 2012, 3:52 PM
            Re: Proposal to move docs to Apache CMS rbowen at rcbowen May 2, 2012, 5:46 PM
            Re: Proposal to move docs to Apache CMS nd at perlig May 3, 2012, 12:20 AM
                Re: Proposal to move docs to Apache CMS rumble at cord May 3, 2012, 1:38 AM
                Re: Proposal to move docs to Apache CMS rbowen at rcbowen May 3, 2012, 6:38 AM
                    Re: Proposal to move docs to Apache CMS nd at perlig May 3, 2012, 6:54 AM
                        Re: Proposal to move docs to Apache CMS i.galic at brainsware May 3, 2012, 8:52 AM
                            Re: Proposal to move docs to Apache CMS rbowen at rcbowen May 3, 2012, 2:07 PM
                                Re: Proposal to move docs to Apache CMS mads at toftum May 3, 2012, 2:26 PM
                                    Re: Proposal to move docs to Apache CMS pctony at apache May 3, 2012, 3:06 PM
                                        Re: Proposal to move docs to Apache CMS joe_schaefer at yahoo May 4, 2012, 10:54 AM
            Re: Proposal to move docs to Apache CMS i.galic at brainsware May 3, 2012, 6:37 AM
    Re: Proposal to move docs to Apache CMS rbowen at rcbowen May 2, 2012, 5:34 PM
    Re: Proposal to move docs to Apache CMS rbowen at rcbowen May 2, 2012, 5:40 PM
    Re: Proposal to move docs to Apache CMS joe_schaefer at yahoo May 2, 2012, 5:49 PM
    Re: Proposal to move docs to Apache CMS rbowen at rcbowen May 2, 2012, 5:56 PM
    Re: Proposal to move docs to Apache CMS nd at perlig May 3, 2012, 12:05 AM
    Re: Proposal to move docs to Apache CMS nd at perlig May 3, 2012, 12:08 AM
    Re: Proposal to move docs to Apache CMS nd at perlig May 3, 2012, 12:26 AM
    Re: Proposal to move docs to Apache CMS rbowen at rcbowen May 4, 2012, 11:50 AM
        Re: Proposal to move docs to Apache CMS joe_schaefer at yahoo May 4, 2012, 12:04 PM
    Re: Proposal to move docs to Apache CMS i.galic at brainsware May 4, 2012, 12:18 PM
        Re: Proposal to move docs to Apache CMS joe_schaefer at yahoo May 4, 2012, 12:21 PM
    Re: Proposal to move docs to Apache CMS rbowen at rcbowen May 4, 2012, 12:19 PM
        Re: Proposal to move docs to Apache CMS joe_schaefer at yahoo May 4, 2012, 12:22 PM

  Index | Next | Previous | View Flat
 
 


Interested in having your list archived? Contact Gossamer Threads
 
  Web Applications & Managed Hosting Powered by Gossamer Threads Inc.