You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs@httpd.apache.org by Luca Toscano <to...@gmail.com> on 2016/02/23 11:05:20 UTC
Pre-retirement banner on all the 2.2.x documentation pages
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 :)
Thanks!
Luca
Re: Pre-retirement banner on all the 2.2.x documentation pages
Posted by Luis Gil <lj...@googlemail.com>.
I see that is a good point for the 2. 2 Docs.
El mar., 23 de febrero de 2016 11:05, Luca Toscano <to...@gmail.com>
escribió:
> 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 :)
>
> Thanks!
>
> Luca
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
> For additional commands, e-mail: docs-help@httpd.apache.org
--
Luis J.G
Re: Pre-retirement banner on all the 2.2.x documentation pages
Posted by Luca Toscano <to...@gmail.com>.
Hi Eric!
2016-02-23 17:39 GMT+01:00 Eric Covener <co...@gmail.com>:
>
> 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>.
>
>
Thanks for the suggestion, I will modify the banner with your wording.
My understanding is that nobody is really against it (till now at least),
so I'll wait a bit more to gather all the feedbacks and in case everybody
is happy I'll add the banner to the 2.2 doc pages.
Luca
Re: Pre-retirement banner on all the 2.2.x documentation pages
Posted by Eric Covener <co...@gmail.com>.
On Tue, Feb 23, 2016 at 5:05 AM, Luca Toscano <to...@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