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

[Therese Godefroy]

CVSROOT:        /webcvs/www
Module name:    www
Changes by:     Therese Godefroy <th_g> 21/02/25 08:38:56

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

Log message:
        Rorganization: final stage
        - Separate 'Local links' and 'Page anchors'; move item on embedding to
          'Local links'.
        - Update table of contents and <style>.
        - Minor edits; validation fixes.

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

Patches:
Index: gnu-website-guidelines.html
===================================================================
RCS file: /webcvs/www/www/server/staging/standards/gnu-website-guidelines.html,v
retrieving revision 1.29
retrieving revision 1.30
diff -u -b -r1.29 -r1.30
--- gnu-website-guidelines.html 25 Feb 2021 12:32:38 -0000      1.29
+++ gnu-website-guidelines.html 25 Feb 2021 13:38:55 -0000      1.30
@@ -10,6 +10,7 @@
 @media (min-width: 55em) {
   .flex { display: flex; flex-direction: row; }
   .flex > * { width: 49%; }
+  .toc { width: 100%; }
 }
 --></style>
  <!--#include virtual="/server/standards/po/gnu-website-guidelines.translist" 
-->
@@ -28,30 +29,44 @@
 <hr class="no-display" />
 <h3 class="no-display">Table of Contents</h3>
 <ul class="columns">
-  <li><a href="#GeneralGuidelines">1. General Guidelines</a></li>
-  <li><a href="#CopyrightGuidelines">2. Copyright Guidelines</a></li>
-  <li><a href="#orthography">3. Spelling and Punctuation</a></li>
-  <li><a href="#filenames">4. Filenames</a></li>
-  <li><a href="#urls">5. URLs</a></li>
-  <li><a href="#HTMLGuidelines">6. HTML Guidelines</a>
+  <li><a href="#GeneralGuidelines"><b>1. General Guidelines</b></a>
     <ul>
-      <li><a href="#tables">Tables and menus</a></li>
+      <li><a href="#gnu-policies">GNU Policies</a></li>
+      <li><a href="#CopyrightGuidelines">Copyright</a></li>
+      <li><a href="#HTMLGuidelines">Web and Accessibility Standards</a></li>
+    </ul></li>
+  <li><a href="#new-page"><b>2. Creating a New Page</b></a>
+    <ul>
+      <li><a href="#filenames">Naming the file</a></li>
+      <li><a href="#html-required">Doctype and required HTML elements</a></li>
+      <li><a href="#page-footer">Footer</a></li>
       <li><a href="#templating">Using our page template</a></li>
     </ul></li>
-  <li><a href="#styling">7. Page Styling</a>
+  <li><a href="#writing"><b>3. Writing the Main Text</b></a>
+    <ul style="inline-block">
+      <li><a href="#page-contents">Page contents</a></li>
+      <li><a href="#orthography">Spelling and punctuation</a></li>
+      <li><a href="#urls">URLs - Local links and anchors</a></li>
+      <li><a href="#anchors">URLs - Page anchors</a></li>
+      <li><a href="#mailto">URLs - Email links</a></li>
+      <li><a href="#external-links">URLs - External links</a></li>
+      <li><a href="#abbr">Acronyms and abbreviations</a></li>
+      <li><a href="#tables">Tables and menus</a></li>
+    </ul></li>
+  <li><a href="#styling"><b>4. Page Styling</b></a>
     <ul>
       <li><a href="#styling-templated">Styling of templated pages</a></li>
       <li><a href="#other-stylesheets">Other stylesheets</a></li>
       <li><a href="#text-only">Text-only browsers</a></li>
     </ul></li>
-  <li><a href="#UseofGraphics">Use of Graphics</a>
+  <li><a href="#UseofGraphics"><b>5. Use of Graphics</b></a>
     <ul>
       <li><a href="#caveats">Caveats</a></li>
       <li><a href="#image-basics">Basic recommendations</a></li>
       <li><a href="#image-css">CSS classes for images</a></li>
     </ul></li>
-  <li><a href="#pollinking">Appendix 1 - Linking Policies</a></li>
-  <li><a href="#repo">Appendix 2 - Working with Web CVS Repositories</a>
+  <li><a href="#pollinking"><b>Appendix 1 - Linking Policies</b></a></li>
+  <li><a href="#repo"><b>Appendix 2 - Working with CVS Repositories</b></a>
     <ul>
       <li><a href="#cvs">Basic CVS commands</a></li>
       <li><a href="#symlinks">Symbolic links</a></li>
@@ -59,7 +74,7 @@
       <li><a href="#scripts">Scripts</a></li>
       <li><a href="#sysadmins">System administrators</a></li>
     </ul></li>
-  <li><a href="#UsefulResources">Appendix 3 - Useful Resources</a>
+  <li><a href="#UsefulResources"><b>Appendix 3 - Useful Resources</b></a>
     <ul>
       <li><a href="#external-resources">External resources</a></li>
       <li><a href="#internal-resources">Internal resources</a></li>
@@ -209,7 +224,7 @@
 
 <h4 id="html-required">Doctype and required HTML elements</h4> 
 
-<ul class="para"
+<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
@@ -318,7 +333,7 @@
 </ul>
 
 
-<h4 id="orthography">Spelling and Punctuation</h3>
+<h4 id="orthography">Spelling and Punctuation</h4>
 
 <ul class="para">
 <li>English pages should follow the standard American spelling,
@@ -342,7 +357,7 @@
 </ul>
 
 
-<h4 id="urls">URLs - Local links and anchors</h4>
+<h4 id="urls">URLs - Local links</h4>
 
 <ul class="para">
 <li>Hand-written URLs that refer to other files on www.gnu.org should be
@@ -370,6 +385,22 @@
 already seen, which is irritating.  Also, this eases maintenance of the site
 as things get moved around.</li>
 
+<li>When embedding static resources like videos that are not in
+the <code>www</code> CVS repository along with the rest of the
+www.gnu.org pages, it's important that the URL used to embed the asset
+be a subdomain of gnu.org, so that the Third-party Request Blocker
+add-on shipped with GNU IceCat would not consider it a third-party
+asset which it would prevent from being loaded.  For example, when
+embedding videos from FSF campaigns on www.gnu.org, use
+<code>static.gnu.org</code> rather than <code>static.fsf.org</code>.
+Both of these addresses have been set to point to the same machine, so
+they can be used interchangeably.</li>
+</ul>
+
+
+<h4 id="anchors">URLs - Page anchors</h4>
+
+<ul class="para">
 <li>Be sure to omit the filename entirely when linking to an anchor in
 the same file, and double-check that the anchor actually works.</li>
 
@@ -391,17 +422,6 @@
 
 Please avoid moving the old <code>id</code> to a translatable string.
 Translators will thank you!</li>
-
-<li>When embedding static resources like videos that are not in
-the <code>www</code> CVS repository along with the rest of the
-www.gnu.org pages, it's important that the URL used to embed the asset
-be a subdomain of gnu.org, so that the Third-party Request Blocker
-add-on shipped with GNU IceCat would not consider it a third-party
-asset which it would prevent from being loaded.  For example, when
-embedding videos from FSF campaigns on www.gnu.org, use
-<code>static.gnu.org</code> rather than <code>static.fsf.org</code>.
-Both of these addresses have been set to point to the same machine, so
-they can be used interchangeably.</li>
 </ul>
 
 
@@ -991,7 +1011,7 @@
 </dl>
 
 
-<h3 id="repo" class="subheader">Appendix 2 - Working with Web CVS 
Repositories</h3>
+<h3 id="repo" class="subheader">Appendix 2 - Working with CVS Repositories</h3>
 
 
 <h4 id="cvs">Basic CVS commands</h4>
@@ -1028,7 +1048,7 @@
 </li>
 
 <li>
-<p>Check out the web repository of the <var>fooproject</var>:</p>
+<p>Check out the <strong>web</strong> repository of the 
<var>fooproject</var>:</p>
 
 <pre class="emph-box">
 <kbd>cvs -z3 
-d:ext:<var>username</var>@cvs.savannah.gnu.org:/web/<var>fooproject</var> \
@@ -1336,7 +1356,7 @@
 
 <p class="unprintable">Updated:
 <!-- timestamp start -->
-$Date: 2021/02/25 12:32:38 $
+$Date: 2021/02/25 13:38:55 $
 <!-- timestamp end --></p>
 </div>
 </div><!-- for class="inner", starts in the banner include -->