www/server fsf-html-style-sheet.html

[Pavel Kharitonov]

CVSROOT:        /web/www
Module name:    www
Changes by:     Pavel Kharitonov <ineiev>       13/02/26 12:47:15

Modified files:
        server         : fsf-html-style-sheet.html 

Log message:
        Further deprecate marked up abbreviations.
        Update the text for titles (no "(FSF)" these days).
        Fix a few typos.
        Explain why the links should be absolute, starting from the root.

CVSWeb URLs:
http://web.cvs.savannah.gnu.org/viewcvs/www/server/fsf-html-style-sheet.html?cvsroot=www&r1=1.55&r2=1.56

Patches:
Index: fsf-html-style-sheet.html
===================================================================
RCS file: /web/www/www/server/fsf-html-style-sheet.html,v
retrieving revision 1.55
retrieving revision 1.56
diff -u -b -r1.55 -r1.56
--- fsf-html-style-sheet.html   7 Feb 2013 09:59:31 -0000       1.55
+++ fsf-html-style-sheet.html   26 Feb 2013 12:47:14 -0000      1.56
@@ -90,24 +90,24 @@
 
 <li>Acronyms/abbreviations:
   <ul>
-  <li>When an initialism may be unfamiliar to a reader, give its
-  expansion the first time it is used in a document, like this:
-  <tt>&lt;acronym title="Expanded Acronym"&gt;EA&lt;/acronym&gt;</tt>.</li>
+  <li>Never use <code>&lt;acronym&gt;</code>: HTML5 obsoletes it in
+  favor of <code>&lt;abbr&gt;</code>.</li>
+
+  <li>Don't use <code>&lt;abbr&gt;</code> unless for a really
+  compelling reason.  Browsers render it in an ugly way.</li>
   
-  <li>For such a first occurrence, use <tt>&lt;acronym&gt;</tt> when the
-  initialism is pronounced as a word, e.g., &ldquo;NATO&rdquo;.  Use
-  <tt>&lt;abbr&gt;</tt> when each letter of the initialism is
-  pronounced, e.g., &ldquo;FBI&rdquo;.</li>
+  <li>When an abbreviation may be unfamiliar to a reader, give its
+  expansion the first time it is used in a document, like this:
+  <code>&lt;abbr title="Expanded
+  Abbreviation"&gt;EA&lt;/abbr&gt;</code> or <code>EA
+  (Expanded Abbreviation)</code>.</li>
   
-  <li>Further occurrences, in either case, should be written without any
-  markup: just &ldquo;<tt>EA</tt>&rdquo;.</li>
+  <li>Further occurrences, in any case, should be written without any
+  markup: just <code>EA</code>.</li>
 
   <li>For common-enough initialisms, such as GNU, FSF, BSD, RAM, HTML,
-  DVD, and so on and so on, it is not necessary to provide the expansion
-  at all.  Use your judgement.</li>
-  
-  <li>There is much conflicting information about this in the standards
-  and on the web.  Again, use your judgement.</li>
+  DVD, and so on and so on, no markup is needed at all.
+  Use your judgement.</li>
   </ul>
 </li>
 
@@ -146,7 +146,7 @@
 document.</li>
 
 <li>The &lt;TITLE&gt; tag should include the phrases "GNU Project"
-and "Free Software Foundation (FSF)" so the pages will be found
+and "Free Software Foundation" so the pages will be found
 when WWW search engines are used. The default is to add this at the
 end: <code> - GNU Project - Free Software Foundation</code>.</li>
 
@@ -219,10 +219,7 @@
 purpose as well.</li>
 
 <li>Consider others linking to your page when removing page
-anchors. Also, though ID is prefered, include name, so as to be
-backwards compatible with older browsers. Please use /gnu.css for
-your stylesheet, unless you have a specific reason to do otherwise.
-Please do not break the style of other pages that use gnu.css.</li>
+anchors.</li>
 
 <li>Screen reader software used by most blind people reads the text
 from left to right, ignoring any tables that you make. If you use
@@ -248,9 +245,10 @@
 <li>Hand-written URLs which refer to other files should be
 absolute, starting from the root page. That is, file names should start
 with <code>/</code> (e.g., <code>/order/order.html</code>, <em>not</em>
-<code></code>http://www.gnu.org/<code></code>). This makes it easier to
-copy and paste links from other pages, and also makes it easier to set
-up mirror servers.</li>
+<code>http://www.gnu.org/</code>).  This makes it easier to
+copy and paste links from other pages.  Links like
+<code>http://www.gnu.org/</code> will be wrong when the visitor uses
+HTTPS.</li>
 
 <li>Be sure to omit the file name entirely when referring to a tag
 in the same file.</li>
@@ -332,7 +330,7 @@
 <li>Tag all images like this:<br />
 <a href="/graphics/agnuhead.html"><img src=
 "/graphics/gnu-head-sm.jpg" alt=
-" [image of the Head of a GNU] " /></a><br />
+" [Image of the Head of a GNU] " /></a><br />
 This will allow the user to quickly go to a page related to the
 picture if he or she is interested.</li>
 
@@ -446,7 +444,7 @@
 
 <p>Updated:
 <!-- timestamp start -->
-$Date: 2013/02/07 09:59:31 $
+$Date: 2013/02/26 12:47:14 $
 <!-- timestamp end --></p>
 </div>
 </div>