httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Rich Bowen <rbo...@rcbowen.com>
Subject Re: Proposal: add a permanent "Bugfix checklist" section to all manual pages
Date Sun, 24 Apr 2016 13:33:56 GMT
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" <toscano.luca@gmail.com> wrote:

>
>
> 2016-04-12 11:38 GMT+02:00 Luca Toscano <toscano.luca@gmail.com>:
>
>> 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, etc.. so
>> it would be great in my opinion to add a "reminder" in our manual pages.
>> The attached patch will add a little section in the right column (right
>> below "See also") to provide the aforementioned links.
>>
>> Position, wording, etc.. can be changed of course, this email is only
>> meant to discuss the idea. If you don't like it, just state it out loud and
>> I'll drop it :)
>>
>> Let me know your thoughts!
>>
>> Luca
>>
>>
> Restarted from the first email to avoid a quoting mess. I attached the
> final patch that would basically add the "Bugfix checklist" section before
> "see also" on each module's page. I wanted to restrict the scope of this
> patch to the places in which occasional users will benefit more rather than
> adding it to the whole documentation.
>
> Christophe, André, Rich: if you want to review the patch it would be
> really great. If anybody feels very strong against it I'll drop it.
>
> Thanks!
>
> Luca
>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
> For additional commands, e-mail: docs-help@httpd.apache.org
>

Mime
View raw message