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

[Therese Godefroy]

CVSROOT:        /webcvs/www
Module name:    www
Changes by:     Therese Godefroy <th_g> 21/02/25 06:29:19

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

Log message:
        [WIP] 'Writing the Main Text': new section, made of
        - 'Page contents' (new)
        - 'Spelling and punctuation'
        - 'URLs'
        - 'Acronyms and abbreviations'
        - 'Tables and menus'
        + missed changes from previous commits.

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

Patches:
Index: gnu-website-guidelines.html
===================================================================
RCS file: /webcvs/www/www/server/staging/standards/gnu-website-guidelines.html,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -b -r1.27 -r1.28
--- gnu-website-guidelines.html 25 Feb 2021 10:19:13 -0000      1.27
+++ gnu-website-guidelines.html 25 Feb 2021 11:29:18 -0000      1.28
@@ -98,11 +98,6 @@
 <a href="/licenses/lgpl-3.0.html">GNU Lesser General Public License</a>.</li>
 <!-- What does this mean exactly? -->
 
-<li>Offer a document in as many formats as the GNU Project has it.
-For an example, see <a href="/licenses/fdl.html">The GNU Free
-Documentation License</a>.  This lets users get the document in the
-format most useful to them.</li>
-
 <li>Before you take any graphics or text from another website,
 please ask for permission to use it.  It's polite to do so.  It is also
 essential for us to avoid copyright infringement.</li>
@@ -116,10 +111,6 @@
 to get bug reports and other messages from the relevant <a
 href="/prep/mailinglists.html">mailing lists</a>.</li>
 
-<li>On pages with dated entries (e.g., /philosophy/latest-articles.html),
-the newer entries should be first; in other words, preserve reverse
-chronological order.</li>
-
 <li>Pages should not load CSS from servers other than those run
 by the FSF.</li>
 
@@ -166,7 +157,7 @@
 </ul>
 
 
-<h4 id="HTMLGuidelines">HTML Guidelines</h4>
+<h4 id="HTMLGuidelines">Web and accessibility standards</h4>
 
 <ul class="para">
 <li>HTML 5 and CSS3 are preferred over older (X)HTML and CSS standards.</li>
@@ -183,31 +174,6 @@
 </ul>
 
 
-<h3 id="orthography" class="subheader">3. Spelling and Punctuation</h3>
-
-
-<ul class="para">
-<li>English pages should follow the standard American spelling,
-hyphenation and punctuation conventions.</li>
-
-<li>Since these conventions are not always very specific, especially as
-regards hyphenation and quotes, gnu.org adds its own rules for the sake of
-consistency:
-  <ul>
-  <li>The term &ldquo;nonfree&rdquo; is preferred over &ldquo;non-free&rdquo;;
-  likewise, &ldquo;noncommercial&rdquo; over &ldquo;non-commercial.&rdquo;</li>
-  <li>In ordinary text, HTML entities
-  &ldquo;<code>&amp;ldquo;</code>&hellip;<code>&amp;rdquo;</code>&rdquo; and
-  &ldquo;<code>&amp;lsquo;</code>&hellip;<code>&amp;rsquo;</code>&rdquo;
-  are preferred over straight quotes ("..." and '...').
-  This doesn't apply to script-generated documents.</li>
-  <li>Where they exist, the double spaces after sentence breaks should be
-  preserved.  They enable Emacs sentence commands to do the right thing.</li>
-  </ul>
-</li>
-</ul>
-
-
 <h3 id="new-page" class="subheader">2. Creating a New Page</h3>
 
 
@@ -282,13 +248,12 @@
 and <i>&ldquo;Free Software Foundation&rdquo;</i> so the pages can be better
 indexed by external search engines.  The default is to add this at the
 end: <code> - GNU Project - Free Software Foundation</code>.</li>
+</ul>
 
 
 <h4 id="page-footer">Page footer</h4>
 
 <ul class="para">
-
-<ul class="para">
 <li>All pages should have a footer. See the <a
 href="//web.cvs.savannah.gnu.org/viewvc/*checkout*/www/server/standards/
 boilerplate.html?root=www&amp;content-type=text%2Fplain">
@@ -312,6 +277,7 @@
 always finds this information at the same place on each page.</li>
 </ul>
 
+
 <h4 id="templating">Using our page template</h4>
 
 <ul class="para">
@@ -335,8 +301,48 @@
 </ul>
 
 
-<h3 id="urls" class="subheader">5. URLs</h3>
+<h3 id="main-text" class="subheader">3. Writing the Main Text</h3>
+
+
+<h4 id="page-contents">Page contents</h4>
+
+<ul class="para">
+<li>On pages with dated entries (e.g., /philosophy/latest-articles.html),
+the newer entries should be first; in other words, preserve reverse
+chronological order.</li>
+
+<li>Offer a document in as many formats as the GNU Project has it.
+For an example, see <a href="/licenses/fdl.html">The GNU Free
+Documentation License</a>.  This lets users get the document in the
+format most useful to them.</li>
+</ul>
+
+
+<h4 id="orthography">Spelling and Punctuation</h3>
+
+<ul class="para">
+<li>English pages should follow the standard American spelling,
+hyphenation and punctuation conventions.</li>
+
+<li>Since these conventions are not always very specific, especially as
+regards hyphenation and quotes, gnu.org adds its own rules for the sake of
+consistency:
+  <ul>
+  <li>The term &ldquo;nonfree&rdquo; is preferred over &ldquo;non-free&rdquo;;
+  likewise, &ldquo;noncommercial&rdquo; over &ldquo;non-commercial.&rdquo;</li>
+  <li>In ordinary text, HTML entities
+  &ldquo;<code>&amp;ldquo;</code>&hellip;<code>&amp;rdquo;</code>&rdquo; and
+  &ldquo;<code>&amp;lsquo;</code>&hellip;<code>&amp;rsquo;</code>&rdquo;
+  are preferred over straight quotes ("..." and '...').
+  This doesn't apply to script-generated documents.</li>
+  <li>Where they exist, the double spaces after sentence breaks should be
+  preserved.  They enable Emacs sentence commands to do the right thing.</li>
+  </ul>
+</li>
+</ul>
+
 
+<h4 id="urls">URLs</h4>
 
 <ul class="para">
 <li>Hand-written URLs that refer to other files on www.gnu.org should be
@@ -482,7 +488,7 @@
 </ul>
 
 
-<h3 id="styling" class="subheader">9. Page Styling</h3>
+<h3 id="styling" class="subheader">4. Page Styling</h3>
 
 
 <h4 id="styling-templated">Styling of templated pages</h4>
@@ -632,7 +638,7 @@
 you can use use <code>fold</code> from the GNU coreutils to ease the task.</p>
 
 
-<h3 id="UseofGraphics" class="subheader">Use of Graphics</h3>
+<h3 id="UseofGraphics" class="subheader">5. Use of Graphics</h3>
 
 
 <h4 id="caveats">Caveats</h4>
@@ -1320,7 +1326,7 @@
 
 <p class="unprintable">Updated:
 <!-- timestamp start -->
-$Date: 2021/02/25 10:19:13 $
+$Date: 2021/02/25 11:29:18 $
 <!-- timestamp end --></p>
 </div>
 </div><!-- for class="inner", starts in the banner include -->