Apache docs wiki

This has come up before, so no doubt some folks have already
made up  
their minds, having seen the subject line.

Jorge Schrauwen, who has written a number of httpd
tutorials,  
articles, etc., was asking on #httpd-dev about the
possibility of a  
docs wiki, where people can provide configuration samples,
ideas,  
suggestions, mini-howtos, which would eventually feed into
the  
official docs. He's planning to do this anyways, but
wondered if  
there was a way that he could do it within the confines of
the  
existing docs project, rather than hosting it himself.
Scratch an  
itch, and give back to the community at the same time.

I'd like to propose that we create a portion of
wiki.apache.org for  
this purpose, and give it a test run for a while, see if it
works,  
and make a determination after a while on whether it is
indeed  
valuable. I would be glad to be the (moderator? overseer?
big  
brother?) whatever the term is, and check in on it for  
appropriateness and correctness of the contributions.

I created http://rewrite.drbacchu
s.com/ specifically for this purpose  
- as a scratchpad for myself - and it has developed into a
more  
useful resource than I planned, which is to say that folks
other than  
myself are using it for reference. And the goal there is
still to  
have this stuff feed back into the docs.

Having an official place to do this prevents (or reduces)
the  
proliferation of alternate doc sites with incorrect,
misleading, or  
outdated information. At least, that's my hope.

Thoughts?

--
rbowenrcbowen.com
Come to ApacheCon US 2006!
http://us.apachecon.com/




------------------------------------------------------------
---------
To unsubscribe, e-mail: docs-unsubscribehttpd.apache.org
For additional commands, e-mail: docs-helphttpd.apache.org

On 9/22/06, Rich Bowen <rbowenrcbowen.com> wrote:
> This has come up before, so no doubt some folks have
already made up
> their minds, having seen the subject line.

I don't have any problem with this, as long as there is one
other
person (in addition to you) who will actively follow the
wikidiffs.
(I trust you, Rich, but I don't think one person is ever
sufficient
overview.)

You'd also need to figure out where to send the wikidiffs. 
I'm sure
they won't be welcome at the main cvs commits list.  And
sending them
to this list would probably kill the list for good.  But at
the same
time, they need to be read by some group of people.

Joshua.

------------------------------------------------------------
---------
To unsubscribe, e-mail: docs-unsubscribehttpd.apache.org
For additional commands, e-mail: docs-helphttpd.apache.org

On 9/22/06, Rich Bowen <rbowenrcbowen.com> wrote:
> This has come up before, so no doubt some folks have
already made up
> their minds, having seen the subject line.

Yes please.
I'd like to see a home for the now-dead errors wiki you
started a while ago.

-- 
noodl

------------------------------------------------------------
---------
To unsubscribe, e-mail: docs-unsubscribehttpd.apache.org
For additional commands, e-mail: docs-helphttpd.apache.org

I think this is a good idea.  It will allow people the
opportunity of 
contributing small parts to the overall docs project.
Over the past few months, a small group of us in #apache
have been 
collecting such documents, and scraps of config's that
could be an ideal 
candidate for this such site.

Another way that the site could be used, is for peer review
of larger 
changes to the docs materials. 
I for one am a little hesitant about sending off lots emails
to the 
docs
group, for a few reasons, one major reason being that it is
rather 
daunting.

I have been working on the FAQ for 2.2 for some time, and
before sending 
it all off, it could/would be nice for some peers to review
my work 
before embarrassing myself any further.

Anyway, before I bleat on too much, I will end it here.



--
pctony


Rich Bowen wrote:
> This has come up before, so no doubt some folks have
already made up 
> their minds, having seen the subject line.
>
> Jorge Schrauwen, who has written a number of httpd
tutorials, 
> articles, etc., was asking on #httpd-dev about the
possibility of a 
> docs wiki, where people can provide configuration
samples, ideas, 
> suggestions, mini-howtos, which would eventually feed
into the 
> official docs. He's planning to do this anyways, but
wondered if there 
> was a way that he could do it within the confines of
the existing docs 
> project, rather than hosting it himself. Scratch an
itch, and give 
> back to the community at the same time.
>
> I'd like to propose that we create a portion of
wiki.apache.org for 
> this purpose, and give it a test run for a while, see
if it works, and 
> make a determination after a while on whether it is
indeed valuable. I 
> would be glad to be the (moderator? overseer? big
brother?) whatever 
> the term is, and check in on it for appropriateness and
correctness of 
> the contributions.
>
> I created http://rewrite.drbacchu
s.com/ specifically for this purpose 
> - as a scratchpad for myself - and it has developed
into a more useful 
> resource than I planned, which is to say that folks
other than myself 
> are using it for reference. And the goal there is still
to have this 
> stuff feed back into the docs.
>
> Having an official place to do this prevents (or
reduces) the 
> proliferation of alternate doc sites with incorrect,
misleading, or 
> outdated information. At least, that's my hope.
>
> Thoughts?
>
> -- 
> rbowenrcbowen.com
> Come to ApacheCon US 2006!
> http://us.apachecon.com/
>
>
>
>
>
------------------------------------------------------------
---------
> To unsubscribe, e-mail: docs-unsubscribehttpd.apache.org
> For additional commands, e-mail: docs-helphttpd.apache.org
>

------------------------------------------------------------
---------
To unsubscribe, e-mail: docs-unsubscribehttpd.apache.org
For additional commands, e-mail: docs-helphttpd.apache.org

On Fri, Sep 22, 2006 at 11:38:13AM -0400, Rich Bowen wrote:
> Having an official place to do this prevents (or
reduces) the  
> proliferation of alternate doc sites with incorrect,
misleading, or  
> outdated information. At least, that's my hope.
> 
> Thoughts?
> 
I think it is going to be a whole lot more trouble than it
is worth -
but as long as you don't get wiki diffs mailed to this
list, I suppose
it will be easy enough to ignore ;)

vh

Mads Toftum
-- 
`Darn it, who spiked my coffee with water?!' - lwall


------------------------------------------------------------
---------
To unsubscribe, e-mail: docs-unsubscribehttpd.apache.org
For additional commands, e-mail: docs-helphttpd.apache.org

On Friday 22 September 2006 17:46, Joshua Slive wrote:
> On 9/22/06, Rich Bowen <rbowenrcbowen.com> wrote:
> > This has come up before, so no doubt some folks
have already made up
> > their minds, having seen the subject line.
>
> I don't have any problem with this, as long as there
is one other
> person (in addition to you) who will actively follow
the wikidiffs.
> (I trust you, Rich, but I don't think one person is
ever sufficient
> overview.)
>
> You'd also need to figure out where to send the
wikidiffs.  I'm sure
> they won't be welcome at the main cvs commits list. 
And sending them
> to this list would probably kill the list for good. 
But at the same
> time, they need to be read by some group of people.
>
> Joshua.

I've the same opinion like Joshua. No problem with a wiki,
but it has to be 
monitored by some people. And the diffs should go to a
separate list.

Kess

------------------------------------------------------------
---------
To unsubscribe, e-mail: docs-unsubscribehttpd.apache.org
For additional commands, e-mail: docs-helphttpd.apache.org

On 09/22/2006 06:32 PM, Astrid 'Kess' Stolper wrote:
> On Friday 22 September 2006 17:46, Joshua Slive wrote:
> 
>>On 9/22/06, Rich Bowen <rbowenrcbowen.com> wrote:
>>
>>>This has come up before, so no doubt some folks
have already made up
>>>their minds, having seen the subject line.
>>
>>I don't have any problem with this, as long as
there is one other
>>person (in addition to you) who will actively follow
the wikidiffs.
>>(I trust you, Rich, but I don't think one person is
ever sufficient
>>overview.)
>>
>>You'd also need to figure out where to send the
wikidiffs.  I'm sure
>>they won't be welcome at the main cvs commits list.
 And sending them
>>to this list would probably kill the list for good. 
But at the same
>>time, they need to be read by some group of people.
>>
>>Joshua.
> 
> 
> I've the same opinion like Joshua. No problem with a
wiki, but it has to be 
> monitored by some people. And the diffs should go to a
separate list.

+1 for the idea provided that enough people care about it (I
guess at least 3
would be nice) and +1 to a new list for the diffs as I do
not think that they
are welcome on any existing list in httpd land.

Regards

Rüdiger

------------------------------------------------------------
---------
To unsubscribe, e-mail: docs-unsubscribehttpd.apache.org
For additional commands, e-mail: docs-helphttpd.apache.org

On Fri, Sep 22, 2006 at 06:20:25PM +0200, Mads Toftum wrote:
> On Fri, Sep 22, 2006 at 11:38:13AM -0400, Rich Bowen
wrote:
> > Having an official place to do this prevents (or
reduces) the  
> > proliferation of alternate doc sites with
incorrect, misleading, or  
> > outdated information. At least, that's my hope.
> > 
> > Thoughts?
> > 
> I think it is going to be a whole lot more trouble than
it is worth -
> but as long as you don't get wiki diffs mailed to this
list, I suppose
> it will be easy enough to ignore ;)

I reckon it's going to be worth a whole lot more than the
trouble it
causes =)

I'm happy to keep an eye on wikidiffs

N

> vh
> 
> Mads Toftum
> -- 
> `Darn it, who spiked my coffee with water?!' - lwall
> 
> 
>
------------------------------------------------------------
---------
> To unsubscribe, e-mail: docs-unsubscribehttpd.apache.org
> For additional commands, e-mail: docs-helphttpd.apache.org
> 
> 

------------------------------------------------------------
---------
To unsubscribe, e-mail: docs-unsubscribehttpd.apache.org
For additional commands, e-mail: docs-helphttpd.apache.org

On Sep 22, 2006, at 11:38, Rich Bowen wrote:

>
> I'd like to propose that we create a portion of
wiki.apache.org for  
> this purpose, and give it a test run for a while, see
if it works,  
> and make a determination after a while on whether it is
indeed  
> valuable. I would be glad to be the (moderator?
overseer? big  
> brother?) whatever the term is, and check in on it for 

> appropriateness and correctness of the contributions.

I've opened a ticket: https
://issues.apache.org/jira/browse/INFRA-956
I don't actually know if I've jumped through the correct
hoops, so I  
don't know if the desired result will actually happen.

--
rbowenrcbowen.com
Come to ApacheCon US 2006!
http://us.apachecon.com/




------------------------------------------------------------
---------
To unsubscribe, e-mail: docs-unsubscribehttpd.apache.org
For additional commands, e-mail: docs-helphttpd.apache.org