Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-05-10 Thread Lucien Gentis
OK, I did'nt notice these directives enclosed other ones. No problem for me if current display stays unchanged. Lucien Le 10/05/2016 à 08:33, Luca Toscano a écrit : 2016-05-10 7:16 GMT+02:00 Christophe JAILLET >:

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-05-10 Thread Luca Toscano
2016-05-10 7:16 GMT+02:00 Christophe JAILLET : > > But (not directly related), in the same frame, under "Directives", some >> directive names are between < and > and some are not. >> See for example >> http://httpd.apache.org/docs/2.4/en/mod/mod_authz_core.html >>

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-05-09 Thread Christophe JAILLET
But (not directly related), in the same frame, under "Directives", some directive names are between < and > and some are not. See for example http://httpd.apache.org/docs/2.4/en/mod/mod_authz_core.html I looked at corresponding XML file, and saw that, for example, Require directive section

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-05-09 Thread Lucien Gentis
Hi to all, OK, Thanks Luca for this improvment and its port to 2.4 branch ; I find it very useful, particularly "Known bugs". But (not directly related), in the same frame, under "Directives", some directive names are between < and > and some are not. See for example

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-29 Thread Luca Toscano
2016-04-29 9:10 GMT+02:00 Lucien Gentis : > but perhaps "Doc Feedback" instead of "Comments" . . . > > (this could decrease the number of Q/A comments) > I would prefer to keep Comments since it is easier to read, plus we have a big warning about Q/A comments that

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-29 Thread Lucien Gentis
but perhaps "Doc Feedback" instead of "Comments" . . . (this could decrease the number of Q/A comments) Le 28/04/2016 à 20:52, Christophe JAILLET a écrit : Le 28/04/2016 à 09:44, Luca Toscano a écrit : 2016-04-27 14:49 GMT+02:00 Eric Covener >:

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-28 Thread Christophe JAILLET
Le 28/04/2016 à 09:44, Luca Toscano a écrit : 2016-04-27 14:49 GMT+02:00 Eric Covener >: On Wed, Apr 27, 2016 at 7:43 AM, Lucien Gentis > wrote: > I think of

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-27 Thread Eric Covener
On Wed, Apr 27, 2016 at 7:43 AM, Lucien Gentis wrote: > I think of something like "Comments about this doc", since these are only > comments about the doc. Doc Feedback? I think space is at a premium in that sidebar.

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-27 Thread Lucien Gentis
I think of something like "Comments about this doc", since these are only comments about the doc. Le 27/04/2016 à 12:30, Luca Toscano a écrit : 2016-04-26 10:08 GMT+02:00 Luca Toscano >: 2016-04-26 9:08 GMT+02:00 Lucien Gentis

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-27 Thread Luca Toscano
2016-04-26 10:08 GMT+02:00 Luca Toscano : > > > 2016-04-26 9:08 GMT+02:00 Lucien Gentis : > > >> --- In mod_lua, "Comments" appears as an item of "Bugfix checklist", but >> in event, it appears as an item of "See also" > > > Very good point,

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-26 Thread Rich Bowen
On 04/26/2016 03:08 AM, Luca Toscano wrote: > --- Why is HTTPD in capitals ? It's written httpd in whole doc ? > > > IIRC was asked on IRC as way to put the HTTPD name in evidence and to be > more consistent with naming across the docs, but I have to admit that I > haven't checked very

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-26 Thread Luca Toscano
2016-04-26 9:08 GMT+02:00 Lucien Gentis : > > > Le 25/04/2016 13:49, Rich Bowen a écrit : > >> This is great. And it'll have the side-effect that it's likely to help >> us identify issues that have been open for ages and are either already >> addressed, or could be

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-26 Thread Lucien Gentis
Le 25/04/2016 13:49, Rich Bowen a écrit : This is great. And it'll have the side-effect that it's likely to help us identify issues that have been open for ages and are either already addressed, or could be addressed. Thanks, On 04/24/2016 05:18 PM, Luca Toscano wrote: New version just

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-25 Thread Christophe JAILLET
Le 24/04/2016 à 23:18, Luca Toscano a écrit : New version just committed, examples: https://httpd.apache.org/docs/trunk/mod/mod_lua.html https://httpd.apache.org/docs/trunk/mod/event.html Luca You could help even more bug-report with something like:

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-25 Thread Rich Bowen
This is great. And it'll have the side-effect that it's likely to help us identify issues that have been open for ages and are either already addressed, or could be addressed. Thanks, On 04/24/2016 05:18 PM, Luca Toscano wrote: > > > New version just committed, examples: > >

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-24 Thread Luca Toscano
2016-04-22 8:19 GMT+02:00 Luca Toscano : > +docs@ > > 2016-04-20 23:25 GMT+02:00 Marion & Christophe JAILLET < > christophe.jail...@wanadoo.fr>: > >> Le 20/04/2016 19:37, Luca Toscano a écrit : >> >> >> >> 2016-04-18 21:46 GMT+02:00 Luca Toscano :

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-24 Thread Rich Bowen
Please forgive me, I'm not ignoring you, just leading up to a major conference tomorrow. I'll try to look at this in the airport today. On Apr 18, 2016 3:46 PM, "Luca Toscano" wrote: > > > 2016-04-12 11:38 GMT+02:00 Luca Toscano : > >> Hi docs@! >>

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-22 Thread Luca Toscano
+docs@ 2016-04-20 23:25 GMT+02:00 Marion & Christophe JAILLET < christophe.jail...@wanadoo.fr>: > Le 20/04/2016 19:37, Luca Toscano a écrit : > > > > 2016-04-18 21:46 GMT+02:00 Luca Toscano : > >> >> >> 2016-04-12 11:38 GMT+02:00 Luca Toscano < >>

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-20 Thread Luca Toscano
2016-04-18 21:46 GMT+02:00 Luca Toscano : > > > 2016-04-12 11:38 GMT+02:00 Luca Toscano : > >> Hi docs@! >> >> I have been thinking a way to inform users about our best practices when >> finding inconsistencies in the docs, namely checking CHANGES

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-18 Thread Luca Toscano
2016-04-12 11:38 GMT+02:00 Luca Toscano : > Hi docs@! > > I have been thinking a way to inform users about our best practices when > finding inconsistencies in the docs, namely checking CHANGES and Bugzilla > first. Most of the times occasional users (or even experienced

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-14 Thread Rich Bowen
On 04/12/2016 05:38 AM, Luca Toscano wrote: Hi docs@! I have been thinking a way to inform users about our best practices when finding inconsistencies in the docs, namely checking CHANGES and Bugzilla first. Most of the times occasional users (or even experienced ones) tend to forget where

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-13 Thread André Malo
* Luca Toscano wrote: > Hi André, > > Thanks for the feedback! > > 2016-04-12 14:53 GMT+02:00 André Malo : > > Hi Luca, > > > > * Luca Toscano wrote: > > > Hi docs@! > > > > > > I have been thinking a way to inform users about our best practices > > > when finding inconsistencies

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-13 Thread Luca Toscano
Hi Christophe, thanks for the feedback! 2016-04-12 18:57 GMT+02:00 Christophe JAILLET : > Hi, > > I don't think it would be the right place for that. > When I'm looking for some doc, I'm not looking for changelog or bug > reports. > I expect the doc to be

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-13 Thread Luca Toscano
Hi André, Thanks for the feedback! 2016-04-12 14:53 GMT+02:00 André Malo : > Hi Luca, > > * Luca Toscano wrote: > > > Hi docs@! > > > > I have been thinking a way to inform users about our best practices when > > finding inconsistencies in the docs, namely checking CHANGES and

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-12 Thread Christophe JAILLET
Hi, I don't think it would be the right place for that. When I'm looking for some doc, I'm not looking for changelog or bug reports. I expect the doc to be up-to-date and to have compatibility notes when needed (new functionality, changed behavior...) Maybe an entry on the main page

Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-12 Thread André Malo
Hi Luca, * Luca Toscano wrote: > Hi docs@! > > I have been thinking a way to inform users about our best practices when > finding inconsistencies in the docs, namely checking CHANGES and Bugzilla > first. Most of the times occasional users (or even experienced ones) tend > to forget where the

Proposal: add a permanent "Bugfix checklist" section to all manual pages

2016-04-12 Thread Luca Toscano
Hi docs@! I have been thinking a way to inform users about our best practices when finding inconsistencies in the docs, namely checking CHANGES and Bugzilla first. Most of the times occasional users (or even experienced ones) tend to forget where the changelog is, if httpd uses bugzilla or not,