2016-02-21 15:55 GMT+01:00 Luca Toscano <[email protected]>:
>
>
> Would it be worth to add a small banner on each documentation page for 2.2
> stating something like:
>

Patch attached with a very high level idea of what I would like to do. I
have modified the "retired" banner for 2.2 to suggest the readers a
migration to 2.4. Wording might not be correct but please let me know if
you like the idea!

Luca
Index: style/manual.en.xsl
===================================================================
--- style/manual.en.xsl (revision 1731196)
+++ style/manual.en.xsl (working copy)
@@ -29,7 +29,7 @@
 <xsl:variable name="output-encoding">ISO-8859-1</xsl:variable>
 <xsl:variable name="is-chm" select="false()"/>
 <xsl:variable name="is-zip" select="false()"/>
-<xsl:variable name="is-retired" select="false()"/>
+<xsl:variable name="is-retired" select="true()"/>
 
 <!-- Now get the real guts of the stylesheet -->
 <xsl:include href="xsl/common.xsl"/>
Index: style/xsl/common.xsl
===================================================================
--- style/xsl/common.xsl        (revision 1731196)
+++ style/xsl/common.xsl        (working copy)
@@ -317,11 +317,8 @@
     <div class="retired">
         <h4><xsl:value-of select="$message[@id='retired.headline']" /></h4>
         <xsl:apply-templates select="$message[@id='retired.description']" />
-        <ul>
-            <li><a href="http://httpd.apache.org/docs/current/";>
-                <xsl:value-of select="$message[@id='retired.current']" /></a>
-            </li>
-        </ul>
+        <a href="http://httpd.apache.org/docs/current/upgrading.html";>
+                <xsl:value-of select="$message[@id='retired.upgrading']" /></a>
         <xsl:if test="not($future = '')">
             <p><xsl:apply-templates select="$message[@id='retired.document']" 
mode="retired" /></p>
         </xsl:if>
Index: style/lang/en.xml
===================================================================
--- style/lang/en.xml   (revision 1731196)
+++ style/lang/en.xml   (working copy)
@@ -151,10 +151,11 @@
         <!-- retirement -->
         <message id="retired.headline">Please note</message>
         <message id="retired.description">
-            <p>This document refers to the <strong>2.0</strong> version of 
Apache httpd, which <strong>is no longer maintained</strong>. Upgrade, and 
refer to the current version of httpd instead, documented at:</p>
+            <p>This document refers to the <strong>2.2</strong> version of 
Apache httpd that is still maintained but not actively developed. Please 
upgrade to the latest 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 definitely worth it in term of performances and long term 
maintainability.
+            </p>
         </message>
-        <message id="retired.current">Current release version of Apache HTTP 
Server documentation</message>
-        <message id="retired.document">You may follow <link>this link</link> 
to go to the current version of this document.</message>
+        <message id="retired.upgrading">Upgrading to the latest version of 
Apache httpd</message>
+        <message id="retired.document">You may follow <link>this link</link> 
to go to the latest version of this document.</message>
 
     </messages>
 </language>

Reply via email to