www/server/staging/standards gnu-website-guidel...

[Therese Godefroy]

CVSROOT:        /webcvs/www
Module name:    www
Changes by:     Therese Godefroy <th_g> 21/02/25 04:26:45

Modified files:
        server/staging/standards: gnu-website-guidelines.html 

Log message:
        [WIP] Start reorganizing to clearly separate principles from actual
        tasks (creating a page, writing, styling):
        - Split 'HTML guidelines' into theory (Web and accessibility standards)
          & practice ('Doctype and required HTML elements' + 'Acronyms and
          abbreviations').
        - Move 'Copyright' and 'Standards' to 'General Guidelines'; add 'GNU
          Policies' heading.
        - Remove obsolete paragraph about FTP sites.
        - Rename #main-text to #intro.

CVSWeb URLs:
http://web.cvs.savannah.gnu.org/viewcvs/www/server/staging/standards/gnu-website-guidelines.html?cvsroot=www&r1=1.24&r2=1.25

Patches:
Index: gnu-website-guidelines.html
===================================================================
RCS file: /webcvs/www/www/server/staging/standards/gnu-website-guidelines.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -b -r1.24 -r1.25
--- gnu-website-guidelines.html 24 Feb 2021 22:02:07 -0000      1.24
+++ gnu-website-guidelines.html 25 Feb 2021 09:26:45 -0000      1.25
@@ -24,7 +24,7 @@
 
 <div class="toc">
 <p class="skiptoc">
-<small><a href="#main-text">[Skip the table of contents]</a></small></p>
+<small><a href="#intro">[Skip the table of contents]</a></small></p>
 <hr class="no-display" />
 <h3 class="no-display">Table of Contents</h3>
 <ul class="columns">
@@ -68,7 +68,7 @@
 <hr class="no-display" />
 </div>
 
-<p id="main-text">
+<p id="intro">
 Please be considerate of all who access our web pages, and accommodate
 them, including those who use low-end hardware, as well as those with slow
 Internet connections. We wish to prevent web designs that look
@@ -80,6 +80,8 @@
 <h3 id="GeneralGuidelines" class="subheader">1. General Guidelines</h3>
 
 
+<h4 id="policies">GNU Policies</h4>
+
 <ul class="para">
 <li>The GNU web server has only <a href="/philosophy/free-sw.html">free
 software</a> available.  We prefer that only free software be used to
@@ -135,8 +137,7 @@
 </ul>
 
 
-<h3 id="CopyrightGuidelines" class="subheader">2. Copyright Guidelines</h3>
-
+<h4 id="CopyrightGuidelines">Copyright Guidelines</h4>
 
 <ul class="para">
 <li>Every page should have a copyright notice.  See the <a
@@ -180,6 +181,23 @@
 </ul>
 
 
+<h4 id="HTMLGuidelines">HTML Guidelines</h4>
+
+<ul class="para">
+<li>HTML 5 and CSS3 are preferred over older (X)HTML and CSS standards.</li>
+
+<li>Regardless of the web standards used, all pages should meet the latest
+<abbr title="Web Content Accessibility Guidelines">WCAG</abbr> published by the
+<abbr title="Web Accessibility Initiative">WAI</abbr>.</li>
+
+<li>All public pages of the GNU website should be strictly compliant with the
+<a href="https://www.w3.org/standards/";>W3C standards</a> and the subsets
+of HTML and CSS used must be composed only by official
+<abbr title="W3C Recommendation">REC</abbr>s supported by the most used web
+browsers.</li>
+</ul>
+
+
 <h3 id="orthography" class="subheader">3. Spelling and Punctuation</h3>
 
 
@@ -294,13 +312,6 @@
 Please avoid moving the old <code>id</code> to a translatable string.
 Translators will thank you!</li>
 
-<li>We encourage FTP sites to use one directory for each package. This
-directory should contain all versions of the package as well as all
-related information (<code>README</code> file, list of available
-versions, documentation, fonts, etc.) This will ensure that the package
-URL does not need updating, on this and other sites, as new
-versions are released into that directory.</li>
-
 <li>Place angle brackets around <code>mailto:</code> anchors (which will
 bring up a mail form to fill out and send, if this is supported by the
 client) to clearly distinguish them from hypertext links.  See
@@ -338,22 +349,9 @@
 </ul>
 
 
-<h3 id="HTMLGuidelines" class="subheader">6. HTML Guidelines</h3>
-
-
-<ul class="para">
-<li>HTML 5 and CSS3 are preferred over older (X)HTML and CSS standards.</li>
-
-<li>Regardless of the web standards used, all pages should meet the latest
-<abbr title="Web Content Accessibility Guidelines">WCAG</abbr> published by the
-<abbr title="Web Accessibility Initiative">WAI</abbr>.</li>
-
-<li>All public pages of the GNU website should be strictly compliant with the
-<a href="https://www.w3.org/standards/";>W3C standards</a> and the subsets
-of HTML and CSS used must be composed only by official
-<abbr title="W3C Recommendation">REC</abbr>s supported by the most used web
-browsers.</li>
+<h4 id="html-required">Doctype and required HTML elements</h4> 
 
+<ul class="para"
 <li>Please follow the above mentioned web standards strictly, even when you are
 forced to follow superseded W3C recommendations: don't neglect
 <a href="https://www.w3.org/TR/html401/struct/global.html#h-7.1";>required
@@ -393,8 +391,10 @@
 indexed by external search engines.  The default is to add this at the
 end: <code> - GNU Project - Free Software Foundation</code>.</li>
 
-<li>Acronyms/abbreviations:
-  <ul>
+
+<h4 id="abbreviations">Acronyms and abbreviations</h4>
+
+<ul class="para">
       <li>Never use <code>&lt;acronym&gt;</code>: HTML&nbsp;5 obsoletes it in
       favor of <code>&lt;abbr&gt;</code>. The latter must be expanded in a
       <code>title</code> attribute.</li>
@@ -412,14 +412,11 @@
       <li>For common-enough initialisms, such as GNU, FSF, BSD, RAM, HTML,
       DVD, and so on, no markup is needed at all.
       Use your judgment.</li>
-  </ul>
-</li>
 </ul>
 
 
 <h4 id="tables">Tables and menus</h4>
 
-
 <ul class="para">
 <li>Please use tables to organize data
 (<i>data</i> tables, see
@@ -1308,7 +1305,7 @@
 
 <p class="unprintable">Updated:
 <!-- timestamp start -->
-$Date: 2021/02/24 22:02:07 $
+$Date: 2021/02/25 09:26:45 $
 <!-- timestamp end --></p>
 </div>
 </div><!-- for class="inner", starts in the banner include -->