You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs@httpd.apache.org by "William A. Rowe, Jr." <wr...@rowe-clan.net> on 2005/08/19 03:30:32 UTC

Re: Rolling 2.1.7 On Friday

docs@httpd'ers...

As Paul mentions below, on Friday (probably 1 a.m. ;-) he will
tag 2.1.7.  This is just a reminder to our most excellent doco
team that, once ack'ed - this becomes 2.1 beta, and then...
(drum roll please...) 2.2 GA(!)

So if you had changes to catch up with 2.1 that perhaps have
been sitting in your local checkouts, now is an excellent time
to commit the docs improvements.

Each release, we state "v x.x is the best available version
of Apache", and certainly the docs@ team has proven this!
When 2.2 final (not beta, not alpha) drops, we certainly all
want this to be true not only of the code, but also of the 
accompanying documentation!  And I trust you will make it so.

Yours,

Bill

p.s. it's been a while - have I told you all lately that 
you rock?!?

:)


At 12:43 AM 8/18/2005, Paul Querna wrote:
>Just a heads up, I am planning to RM and tag 2.1.7 (and re-branch from
>trunk the 2.2.x branch) on Friday or Saturday this week.  I intend to
>include APR and APR-Util 1.2.1 with this release.
>
>As long as 2.1.7 seems good, I would like to do a vote on making it a Beta.
>
>Thanks,
>
>-Paul



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


Re: Rolling 2.1.7 On Friday

Posted by Colm MacCarthaigh <co...@stdlib.net>.
On Sun, Aug 21, 2005 at 11:15:43AM -0400, Joshua Slive wrote:
> > http://people.heanet.ie/~colmmacc/manual/misc/cachingguide.html.en
> >
> >Which is about half done. Comments & contributions welcome.
> 
> Looks good.  A few comments:
> 
> See docs like env.html, sections.html, and logs.html for an example 
> structure.  We usually have "Related Directives" and "Related Modules" 
> sections at the top.  And we use "Examples" instead of "Case studies".

No problem.

> You can go ahead and commit it whenever you want.  But I'd put it in
> the root directory of the manual rather than "misc".  That directory
> (and, in general, every directory called "misc") just winds up being a
> dumping ground for things with no good place.  This doc belongs beside
> logs.html, urlmapping.html, sections.html, etc, in the main directory.

I'll commit it once an account is set up, most of the TBD's on that page
are just awaiting a copy and paste from my notes. 

Many thanks for the comments.

-- 
Colm MacCárthaigh                        Public Key: colm+pgp@stdlib.net

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


Re: Rolling 2.1.7 On Friday

Posted by Colm MacCarthaigh <co...@stdlib.net>.
On Sun, Aug 21, 2005 at 11:15:43AM -0400, Joshua Slive wrote:
> > http://people.heanet.ie/~colmmacc/manual/misc/cachingguide.html.en
> >
> >Which is about half done. Comments & contributions welcome.
> 
> Looks good.  A few comments:
> 
> See docs like env.html, sections.html, and logs.html for an example 
> structure.  We usually have "Related Directives" and "Related Modules" 
> sections at the top.  And we use "Examples" instead of "Case studies".

No problem.

> You can go ahead and commit it whenever you want.  But I'd put it in
> the root directory of the manual rather than "misc".  That directory
> (and, in general, every directory called "misc") just winds up being a
> dumping ground for things with no good place.  This doc belongs beside
> logs.html, urlmapping.html, sections.html, etc, in the main directory.

I'll commit it once an account is set up, most of the TBD's on that page
are just awaiting a copy and paste from my notes. 

Many thanks for the comments.

-- 
Colm MacCárthaigh                        Public Key: colm+pgp@stdlib.net

Re: Rolling 2.1.7 On Friday

Posted by Joshua Slive <jo...@slive.ca>.
On Fri, 19 Aug 2005, Colm MacCarthaigh wrote:

>
> In this spirit, a major new feature of httpd-2.2 will be reliably
> working Caching, but the documentation on Caching is a bit tough on
> users right now. I'm currently working on this;
>
>  http://people.heanet.ie/~colmmacc/manual/misc/cachingguide.html.en
>
> Which is about half done. Comments & contributions welcome.

Looks good.  A few comments:

See docs like env.html, sections.html, and logs.html for an example 
structure.  We usually have "Related Directives" and "Related Modules" 
sections at the top.  And we use "Examples" instead of "Case studies".

You can go ahead and commit it whenever you want.  But I'd put it in the 
root directory of the manual rather than "misc".  That directory (and, in 
general, every directory called "misc") just winds up being a dumping 
ground for things with no good place.  This doc belongs beside logs.html, 
urlmapping.html, sections.html, etc, in the main directory.

Joshua.

Re: Rolling 2.1.7 On Friday

Posted by Joshua Slive <jo...@slive.ca>.
On Fri, 19 Aug 2005, Colm MacCarthaigh wrote:

>
> In this spirit, a major new feature of httpd-2.2 will be reliably
> working Caching, but the documentation on Caching is a bit tough on
> users right now. I'm currently working on this;
>
>  http://people.heanet.ie/~colmmacc/manual/misc/cachingguide.html.en
>
> Which is about half done. Comments & contributions welcome.

Looks good.  A few comments:

See docs like env.html, sections.html, and logs.html for an example 
structure.  We usually have "Related Directives" and "Related Modules" 
sections at the top.  And we use "Examples" instead of "Case studies".

You can go ahead and commit it whenever you want.  But I'd put it in the 
root directory of the manual rather than "misc".  That directory (and, in 
general, every directory called "misc") just winds up being a dumping 
ground for things with no good place.  This doc belongs beside logs.html, 
urlmapping.html, sections.html, etc, in the main directory.

Joshua.

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


Re: Rolling 2.1.7 On Friday

Posted by Colm MacCarthaigh <co...@stdlib.net>.
In this spirit, a major new feature of httpd-2.2 will be reliably
working Caching, but the documentation on Caching is a bit tough on
users right now. I'm currently working on this;

  http://people.heanet.ie/~colmmacc/manual/misc/cachingguide.html.en

Which is about half done. Comments & contributions welcome.

On Thu, Aug 18, 2005 at 08:30:32PM -0500, William A. Rowe, Jr. wrote:
> docs@httpd'ers...
> 
> As Paul mentions below, on Friday (probably 1 a.m. ;-) he will
> tag 2.1.7.  This is just a reminder to our most excellent doco
> team that, once ack'ed - this becomes 2.1 beta, and then...
> (drum roll please...) 2.2 GA(!)
> 
> So if you had changes to catch up with 2.1 that perhaps have
> been sitting in your local checkouts, now is an excellent time
> to commit the docs improvements.
> 
> Each release, we state "v x.x is the best available version
> of Apache", and certainly the docs@ team has proven this!
> When 2.2 final (not beta, not alpha) drops, we certainly all
> want this to be true not only of the code, but also of the 
> accompanying documentation!  And I trust you will make it so.
> 
> Yours,
> 
> Bill
> 
> p.s. it's been a while - have I told you all lately that 
> you rock?!?
> 
> :)
> 
> 
> At 12:43 AM 8/18/2005, Paul Querna wrote:
> >Just a heads up, I am planning to RM and tag 2.1.7 (and re-branch from
> >trunk the 2.2.x branch) on Friday or Saturday this week.  I intend to
> >include APR and APR-Util 1.2.1 with this release.
> >
> >As long as 2.1.7 seems good, I would like to do a vote on making it a Beta.
> >
> >Thanks,
> >
> >-Paul
> 
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
> For additional commands, e-mail: docs-help@httpd.apache.org
> 
> 

-- 
Colm MacCárthaigh                        Public Key: colm+pgp@stdlib.net

Re: Rolling 2.1.7 On Friday

Posted by "William A. Rowe, Jr." <wr...@rowe-clan.net>.
At 08:30 PM 8/18/2005, William A. Rowe, Jr. wrote:
>docs@httpd'ers...
>
>As Paul mentions below, on Friday (probably 1 a.m. ;-) he will
>tag 2.1.7.  This is just a reminder to our most excellent doco
>team that, once ack'ed - this becomes 2.1 beta, and then...
>(drum roll please...) 2.2 GA(!)

Oh, if it sounded like -this- exact release would become GA,
I didn't necessarily mean to imply that.  But, it's getting
much closer.

Bill  


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


Re: Rolling 2.1.7 On Friday

Posted by Colm MacCarthaigh <co...@stdlib.net>.
In this spirit, a major new feature of httpd-2.2 will be reliably
working Caching, but the documentation on Caching is a bit tough on
users right now. I'm currently working on this;

  http://people.heanet.ie/~colmmacc/manual/misc/cachingguide.html.en

Which is about half done. Comments & contributions welcome.

On Thu, Aug 18, 2005 at 08:30:32PM -0500, William A. Rowe, Jr. wrote:
> docs@httpd'ers...
> 
> As Paul mentions below, on Friday (probably 1 a.m. ;-) he will
> tag 2.1.7.  This is just a reminder to our most excellent doco
> team that, once ack'ed - this becomes 2.1 beta, and then...
> (drum roll please...) 2.2 GA(!)
> 
> So if you had changes to catch up with 2.1 that perhaps have
> been sitting in your local checkouts, now is an excellent time
> to commit the docs improvements.
> 
> Each release, we state "v x.x is the best available version
> of Apache", and certainly the docs@ team has proven this!
> When 2.2 final (not beta, not alpha) drops, we certainly all
> want this to be true not only of the code, but also of the 
> accompanying documentation!  And I trust you will make it so.
> 
> Yours,
> 
> Bill
> 
> p.s. it's been a while - have I told you all lately that 
> you rock?!?
> 
> :)
> 
> 
> At 12:43 AM 8/18/2005, Paul Querna wrote:
> >Just a heads up, I am planning to RM and tag 2.1.7 (and re-branch from
> >trunk the 2.2.x branch) on Friday or Saturday this week.  I intend to
> >include APR and APR-Util 1.2.1 with this release.
> >
> >As long as 2.1.7 seems good, I would like to do a vote on making it a Beta.
> >
> >Thanks,
> >
> >-Paul
> 
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
> For additional commands, e-mail: docs-help@httpd.apache.org
> 
> 

-- 
Colm MacCárthaigh                        Public Key: colm+pgp@stdlib.net

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