From owner-svn-doc-all@freebsd.org  Thu Jan 16 07:42:25 2020
Return-Path: <owner-svn-doc-all@freebsd.org>
Delivered-To: svn-doc-all@mailman.nyi.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1])
 by mailman.nyi.freebsd.org (Postfix) with ESMTP id 4278B22C7DA;
 Thu, 16 Jan 2020 07:42:25 +0000 (UTC) (envelope-from bcr@FreeBSD.org)
Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org
 [IPv6:2610:1c1:1:606c::19:3])
 (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
 server-signature RSA-PSS (4096 bits)
 client-signature RSA-PSS (4096 bits) client-digest SHA256)
 (Client CN "mxrelay.nyi.freebsd.org",
 Issuer "Let's Encrypt Authority X3" (verified OK))
 by mx1.freebsd.org (Postfix) with ESMTPS id 47yx41162cz4b8x;
 Thu, 16 Jan 2020 07:42:25 +0000 (UTC) (envelope-from bcr@FreeBSD.org)
Received: from repo.freebsd.org (repo.freebsd.org
 [IPv6:2610:1c1:1:6068::e6a:0])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client did not present a certificate)
 by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 215151C0BA;
 Thu, 16 Jan 2020 07:42:25 +0000 (UTC) (envelope-from bcr@FreeBSD.org)
Received: from repo.freebsd.org ([127.0.1.37])
 by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id 00G7gO4e042687;
 Thu, 16 Jan 2020 07:42:24 GMT (envelope-from bcr@FreeBSD.org)
Received: (from bcr@localhost)
 by repo.freebsd.org (8.15.2/8.15.2/Submit) id 00G7gOM4042686;
 Thu, 16 Jan 2020 07:42:24 GMT (envelope-from bcr@FreeBSD.org)
Message-Id: <202001160742.00G7gOM4042686@repo.freebsd.org>
X-Authentication-Warning: repo.freebsd.org: bcr set sender to bcr@FreeBSD.org
 using -f
From: Benedict Reuschling <bcr@FreeBSD.org>
Date: Thu, 16 Jan 2020 07:42:24 +0000 (UTC)
To: doc-committers@freebsd.org, svn-doc-all@freebsd.org,
 svn-doc-head@freebsd.org
Subject: svn commit: r53785 - head/en_US.ISO8859-1/htdocs/news/status
X-SVN-Group: doc-head
X-SVN-Commit-Author: bcr
X-SVN-Commit-Paths: head/en_US.ISO8859-1/htdocs/news/status
X-SVN-Commit-Revision: 53785
X-SVN-Commit-Repository: doc
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-BeenThere: svn-doc-all@freebsd.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "SVN commit messages for the entire doc trees \(except for &quot;
 user&quot; , &quot; projects&quot; , and &quot; translations&quot;
 \)" <svn-doc-all.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/svn-doc-all>,
 <mailto:svn-doc-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-all/>
List-Post: <mailto:svn-doc-all@freebsd.org>
List-Help: <mailto:svn-doc-all-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/svn-doc-all>,
 <mailto:svn-doc-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 16 Jan 2020 07:42:25 -0000

Author: bcr
Date: Thu Jan 16 07:42:24 2020
New Revision: 53785
URL: https://svnweb.freebsd.org/changeset/doc/53785

Log:
  Disable automatic sorting for new quarterly status reports.
  
  While preparing the last quarterly status report (2019Q4), Makefiles were
  added in the git repository that make it very easy to sort the project
  reports. However, our report.xsl file enforces automatic alphabetical
  sorting in each category, which destroys our manual sorting.
  
  This patch disables automatic sorting starting with this quarter (2019Q4).
  Automatic sorting is kept for older reports: we avoid to change them since
  they have no designed and reviewed manual sort.
  
  Submitted by:	    salvadore@
  Approved by:	    bcr@
  Differential Revision:	https://reviews.freebsd.org/D23175

Modified:
  head/en_US.ISO8859-1/htdocs/news/status/report.xsl

Modified: head/en_US.ISO8859-1/htdocs/news/status/report.xsl
==============================================================================
--- head/en_US.ISO8859-1/htdocs/news/status/report.xsl	Thu Jan 16 06:06:35 2020	(r53784)
+++ head/en_US.ISO8859-1/htdocs/news/status/report.xsl	Thu Jan 16 07:42:24 2020	(r53785)
@@ -16,6 +16,9 @@
 
   <xsl:variable name="title">&title;</xsl:variable>
 
+  <!-- Sort only reports strictly older than 2019q4 -->
+  <xsl:variable name="manual-sorting-condition" select="/report/date/year &gt; 2020 or (/report/date/year = 2019 and /report/date/month = '10-12')"/>
+
   <xsl:template name="process.sidewrap">
     &nav.about;
   </xsl:template>
@@ -26,7 +29,7 @@
 
 	<hr/>
 
-	<!-- Generate a table of contents, sorted -->
+	<!-- Generate a table of contents, sorted if needed -->
 	<xsl:for-each select="report/category">
 	  <!-- category title and link -->
 	  <h3><a><xsl:attribute name="href">#<xsl:value-of
@@ -34,38 +37,74 @@
 	    <xsl:value-of select="description"/></a></h3>
 	  <xsl:variable name="cat-short" select="name"/>
 	  <ul>
-	    <xsl:for-each select="//project[@cat=$cat-short and @summary]">
-  	      <xsl:sort select="translate(title, $lowercase, $uppercase)"/>
-	      <li><a><xsl:attribute name="href">#<xsl:value-of
-	      select="translate(normalize-space(title), ' ',
-	      '-')"/></xsl:attribute><xsl:value-of select="title"/></a>
-	      </li>
-	    </xsl:for-each>
+	    <xsl:choose>
+	      <xsl:when test="$manual-sorting-condition">
+	        <xsl:for-each select="//project[@cat=$cat-short and @summary]">
+	          <li><a><xsl:attribute name="href">#<xsl:value-of
+	          select="translate(normalize-space(title), ' ',
+	          '-')"/></xsl:attribute><xsl:value-of select="title"/></a>
+	          </li>
+	        </xsl:for-each>
+	      </xsl:when>
+	      <xsl:otherwise>
+	        <xsl:for-each select="//project[@cat=$cat-short and @summary]">
+  	          <xsl:sort select="translate(title, $lowercase, $uppercase)"/>
+	          <li><a><xsl:attribute name="href">#<xsl:value-of
+	          select="translate(normalize-space(title), ' ',
+	          '-')"/></xsl:attribute><xsl:value-of select="title"/></a>
+	           </li>
+	        </xsl:for-each>
+	      </xsl:otherwise>
+	    </xsl:choose>
 
-	    <xsl:for-each select="//project[@cat=$cat-short and not(@summary)]">
-  	      <xsl:sort select="translate(title, $lowercase, $uppercase)"/>
-	      <li><a><xsl:attribute name="href">#<xsl:value-of
-	      select="translate(normalize-space(title), ' ',
-	      '-')"/></xsl:attribute><xsl:value-of select="title"/></a>
-	      </li>
-	    </xsl:for-each>
+	    <xsl:choose>
+	      <xsl:when test="$manual-sorting-condition">
+	        <xsl:for-each select="//project[@cat=$cat-short and not(@summary)]">
+	          <li><a><xsl:attribute name="href">#<xsl:value-of
+	          select="translate(normalize-space(title), ' ',
+	          '-')"/></xsl:attribute><xsl:value-of select="title"/></a>
+	          </li>
+	        </xsl:for-each>
+	      </xsl:when>
+	      <xsl:otherwise>
+	        <xsl:for-each select="//project[@cat=$cat-short and not(@summary)]">
+  	          <xsl:sort select="translate(title, $lowercase, $uppercase)"/>
+	          <li><a><xsl:attribute name="href">#<xsl:value-of
+    	          select="translate(normalize-space(title), ' ',
+	          '-')"/></xsl:attribute><xsl:value-of select="title"/></a>
+	          </li>
+	        </xsl:for-each>
+	      </xsl:otherwise>
+	    </xsl:choose>
 	  </ul>
 	</xsl:for-each>
 	<ul>
-	  <xsl:for-each select="//project[not(@cat)]">
-  	    <xsl:sort select="translate(title, $lowercase, $uppercase)"/>
-	    <li><a><xsl:attribute name="href">#<xsl:value-of
-	    select="translate(normalize-space(title), ' ',
-	    '-')"/></xsl:attribute><xsl:value-of select="title"/></a>
-	    </li>
-	  </xsl:for-each>
+	    <xsl:choose>
+	      <xsl:when test="$manual-sorting-condition">
+	        <xsl:for-each select="//project[not(@cat)]">
+	          <li><a><xsl:attribute name="href">#<xsl:value-of
+	          select="translate(normalize-space(title), ' ',
+	          '-')"/></xsl:attribute><xsl:value-of select="title"/></a>
+	          </li>
+	        </xsl:for-each>
+	      </xsl:when>
+	      <xsl:otherwise>
+   	        <xsl:for-each select="//project[not(@cat)]">
+  	          <xsl:sort select="translate(title, $lowercase, $uppercase)"/>
+	          <li><a><xsl:attribute name="href">#<xsl:value-of
+	          select="translate(normalize-space(title), ' ',
+	          '-')"/></xsl:attribute><xsl:value-of select="title"/></a>
+	          </li>
+	        </xsl:for-each>
+	      </xsl:otherwise>
+	    </xsl:choose>
 	</ul>
 
 	<hr/>
 
 	<!-- For each category, process the corresponding projects and sort
-	     them by title, so they will be listed in the same order as
-	     they are in the table of contents -->
+	     them by title if needed, so they will be listed in the same
+	     order as they are in the table of contents -->
 	<xsl:choose>
 	    <xsl:when test="report/category">
 		<xsl:for-each select="report/category">
@@ -79,15 +118,32 @@
 		  <xsl:apply-templates select="p" mode="copy.html"/><br/>
 
 		<xsl:variable name="cat-short" select="name"/>
-		<xsl:apply-templates select="//project[@cat=$cat-short]">
+  	        <xsl:choose>
+	          <xsl:when test="$manual-sorting-condition">
+	    	    <xsl:apply-templates select="//project[@cat=$cat-short]"/>
+ 	          </xsl:when>
+	          <xsl:otherwise>
+	  	    <xsl:apply-templates select="//project[@cat=$cat-short]">
 		    <xsl:sort select="translate(title, $lowercase, $uppercase)"/>
-		</xsl:apply-templates>
+		    </xsl:apply-templates>
+ 	          </xsl:otherwise>
+	        </xsl:choose>
 		</xsl:for-each>
+
 	    </xsl:when>
 	    <xsl:otherwise>
-		<xsl:apply-templates select="report/project">
-		    <xsl:sort select="translate(title, $lowercase, $uppercase)"/>
-		</xsl:apply-templates>
+
+	      <xsl:choose>
+ 	        <xsl:when test="$manual-sorting-condition">
+		  <xsl:apply-templates select="report/project"/>
+	        </xsl:when>
+	        <xsl:otherwise>
+		  <xsl:apply-templates select="report/project">
+		  <xsl:sort select="translate(title, $lowercase, $uppercase)"/>
+		  </xsl:apply-templates>
+	        </xsl:otherwise>
+	      </xsl:choose>
+
 	    </xsl:otherwise>
 	</xsl:choose>