httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Eric Covener <cove...@gmail.com>
Subject Re: Pre-retirement banner on all the 2.2.x documentation pages
Date Tue, 23 Feb 2016 16:39:16 GMT
On Tue, Feb 23, 2016 at 5:05 AM, Luca Toscano <toscano.luca@gmail.com> wrote:
> Hi Apache doc writers,
>
> I discussed in dev@ an idea to put the following banner on each
> documentation page of the 2.2 branch:
>
> --------------------
> Please note
> This document refers to the 2.2 version of Apache httpd that is still
> maintained but not actively developed. Please upgrade to the current version
> of Apache httpd to get performance improvements and new features. The
> migration of the configuration files will require a bit of effort but it
> will be definitely worth it in terms of performance and long term
> maintainability.
>
> Upgrading to the current version of Apache httpd (link to
> http://httpd.apache.org/docs/current/upgrading.html)
>
> You may follow this link to go to the current version of this document.
> --------------------
>
> The goal would be to inform and remember to 2.2 users that the migration to
> 2.4 is strongly suggested. I attached a patch to this email to give you an
> idea of what I have in mind.
>
> Main things to discuss since this is a big change:
>
> 1) Is the wording ok? Do we need a different banner?
> 2) I reused the "retirement" scheme that was present since 2.0 to avoid code
> repetition, but let me know if you want me to duplicate it.
> 3) I added the english banner to all the lang.* files, not sure if we need
> translations before proceeding.
>
> Let me know your thoughts and ideas :)

I think the wording a sensitive subject and we should keep it as brief
as possible

 This document refers to our legacy release (2.2)  The active release
(2.4) is documented <here>. If you haven't already upgraded, read more
<here>.

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


Mime
View raw message