On 04/12/2016 12:57 PM, Christophe JAILLET wrote:
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...)
The trouble is that "up to date" means very different things for
different people. Folks that are running a third-party distribution of
the server often think that they are up to date when they are not, by
some other definition.
Based on conversations on IRC, and the kinds of questions people ask, I
think this would be really useful information.
Maybe an entry on the main page (http://httpd.apache.org/docs/2.4/)
under "Release Notes" for a link to the changelog and another one under
"Other Topics" for reporting something to bugzilla?
More than that would display, IMHO, no that useful information.
Just my 2 cents.
CJ
Le 12/04/2016 11:38, Luca Toscano a écrit :
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
---------------------------------------------------------------------
To unsubscribe, e-mail:docs-unsubscr...@httpd.apache.org
For additional commands, e-mail:docs-h...@httpd.apache.org
--
Rich Bowen - rbo...@rcbowen.com - @rbowen
http://apachecon.com/ - @apachecon
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscr...@httpd.apache.org
For additional commands, e-mail: docs-h...@httpd.apache.org
