[Serveez web page] Proposed changes

Thérèse Godefroy <[email protected]> Mon, 21 Sep 2020 18:12:27 +0200
Newsgroups gmane.network.serveez.bugs
Message-ID <[email protected]>
This is a multi-part message in MIME format.
--------------C7F5EED70D12EABF97850559
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit

Hello Serveez maintainers,

GNU webmasters are planning to migrate all templated pages (those using
SSIs) to HTML5 in order to improve accessibility. But before doing this,
deprecated tags such as <tt>, <acronym> and <big> need to be removed.

The home page of Serveez contains <tt>. I got rid of it, and took this
opportunity to do some minor edits:

* Reformat with line breaks.
* Make the logo resizeable.
* Replace <tt> with <code>; use <kbd> for keyboard commands (prevent
  wrapping).
* /usr/doc/... > /usr/share/doc/...
* http > https
* List HTTPS and HTTP as preferred download protocols.
* Style the link to latest version as a button.
* Remove the subheadings in "Get involved" (they didn't make much sense
  in such a small section).
* Update to recent boilerplate.
* Reduce line width.

The diff wasn't made against the current version because it would have
been meaningless. I first wrapped the lines to a manageable length, then
modified the page.

If you agree with the changes but don't have time to commit them right
now, I will gladly do it.

Best regards,
Thérèse



--------------C7F5EED70D12EABF97850559
Content-Type: text/x-patch; charset=UTF-8;
 name="serveez.diff"
Content-Transfer-Encoding: 8bit
Content-Disposition: attachment;
 filename="serveez.diff"

--- serveez-wrapped.html	2020-09-21 17:56:40.051848899 +0200
+++ serveez.1.html	2020-09-21 17:56:38.887840142 +0200
@@ -1,9 +1,18 @@
-
 <!--#include virtual="/server/header.html" -->
+<!-- Parent-Version: 1.92 -->
+<!-- This page is derived from /server/standards/boilerplate.html -->
 <title>Serveez - GNU Project - Free Software Foundation</title>
+<style type="text/css"><!--
+img.svzlogo { width: 97%; border: double 5px; }
+@media (min-width:50em) {
+    .pict.medium { margin-right: .7em; }
+}
+--></style>
 <!--#include virtual="/server/gnun/initial-translations-list.html" -->
-
 <!--#include virtual="/server/banner.html" -->
+<div class="reduced-width">
+
 <h2>GNU Serveez</h2>
+<hr class="thin" />
 
 <p>Serveez is a server framework. It provides routines and help for
@@ -11,12 +20,11 @@
 possible to use named pipes for all connection oriented protocols.</p>
 
-<style type="text/css">img.svzlogo { float: right; border: double 5px;
-margin: 10px;}</style>
-<img class="svzlogo" src="logo.jpg" alt="[Serveez logo]" width="308"
-height="187" border="0"></img>
+<div class="pict medium">
+<img class="svzlogo" src="logo.jpg" alt=" [Serveez logo] " />
+</div>
 
 <p>We think it is worth the effort because many people need server
 functionality within their applications. However, many people experience
-problems with <tt>select()</tt>- or <tt>poll()</tt>-loops, and with
+problems with <code>select()</code>- or <code>poll()</code>-loops, and with
 non-blocking operations.</p>
 
@@ -38,20 +46,21 @@
 
 <p>Serveez needs the GNU <a
-href="http://www.gnu.org/software/guile/">Guile</a> (Ubiquitous Intelligent
+href="/software/guile/">Guile</a> (Ubiquitous Intelligent
 Language for Extensions) language core library for configuring purposes.
 Currently Serveez is known to work with Guile 1.4 and later. You can
 download this package from <a
-href="http://ftp.gnu.org/gnu/guile/">http://ftp.gnu.org/gnu/guile/</a>.
+href="https://ftp.gnu.org/gnu/guile/">ftp.gnu.org</a>.
 (A very old MinGW32 port is available at <a
-href="http://www.sourceforge.net/projects/mingwrep/">
-http://www.sourceforge.net/projects/mingwrep/</a>.)</p>
+href="https://sourceforge.net/projects/mingwrep/">SourceForge</a>.)</p>
 
 <h3 id="download">Download / News</h3>
 
-<p>(<a href="ftp://ftp.gnu.org/gnu/serveez">FTP</a>
+<p>(<a href="https://ftp.gnu.org/gnu/serveez">HTTPS</a>,&nbsp;
+<a href="http://ftp.gnu.org/gnu/serveez">HTTP</a>,&nbsp;
+<a href="ftp://ftp.gnu.org/gnu/serveez">FTP</a>,&nbsp;
 <a href="/prep/ftp.html">mirrors</a>)</p>
 
-<p>Latest release: <a
-href="http://ftpmirror.gnu.org/serveez/">0.2.2 (2013-12-02)</a></p>
+<p class="button">Latest release: <a
+href="https://ftpmirror.gnu.org/serveez/">0.2.2 (2013-12-02)</a></p>
 
 <ul>
@@ -123,5 +132,5 @@
       to update the
       validity of the C object wrt the outer object.  (This is what
-      the Guile server does, in fact -- see src/guile-server.c.)</p>
+      the Guile server does, in fact &ndash; see src/guile-server.c.)</p>
    </li>
    <li>
@@ -138,13 +147,13 @@
  </li>
  <li>
-  <p>new option: ‘<code>serveez --list-servers</code>’</p>
+  <p>new option: ‘<kbd>serveez&nbsp;--list-servers</kbd>’</p>
   <p>
-    (Short form: ‘<code>-L</code>’.)  This displays prefix and description for
+    (Short form: ‘<kbd>-L</kbd>’.)  This displays prefix and description for
     each builtin server, with a special case for the Guile server.</p>
  </li>
- <li>‘<code>serveez --help</code>’ shows home page /
+ <li>‘<kbd>serveez&nbsp;--help</kbd>’ shows home page /
     <code>"gethelp"</code> info</li>
  <li>
-  <p>‘<code>serveez --version</code>’ shows copyright / license</p>
+  <p>‘<kbd>serveez&nbsp;--version</kbd>’ shows copyright / license</p>
   <p>
     This is for compliance w/ the GNU coding standards.</p>
@@ -175,7 +184,7 @@
 <p><a href="manual/">Documentation for Serveez</a> is available online, as
 is <a href="/manual/">documentation for most GNU software</a>. You may also
-find more information about Serveez by running <em>info serveez</em> or by
-looking at <em>/usr/share/doc/serveez/</em>,
-<em>/usr/local/doc/serveez/</em>, or similar directories on your system.</p>
+find information about Serveez by running <kbd>info serveez</kbd> or by
+looking at <code>/usr/share/doc/serveez/</code>,
+<code>/usr/local/share/doc/serveez/</code>, or similar directories on your system.</p>
 
 <h3 id="mail">Mailing Lists</h3>
@@ -184,14 +193,14 @@
 <ul>
  <li><a href="https://lists.gnu.org/mailman/listinfo/bug-serveez">bug-serveez</a>
-  for reporting bugs</li>
+  for reporting bugs,</li>
  <li><a href="https://lists.gnu.org/mailman/listinfo/help-serveez">help-serveez</a>
-  for user support and help</li>
+  for user support and help,</li>
  <li><a href="https://lists.gnu.org/mailman/listinfo/dev-serveez">dev-serveez</a>
-  for development discussion</li>
+  for development discussion.</li>
 </ul>
 
-<p>Announcements about Serveez and most other GNU software are made on <a
-href="http://lists.gnu.org/mailman/listinfo/info-gnu">info-gnu</a> (<a
-href="http://lists.gnu.org/archive/html/info-gnu/">archive</a>).</p>
+<p>Announcements about Serveez and most other GNU software are made on the <a
+href="https://lists.gnu.org/mailman/listinfo/info-gnu">info-gnu</a> mailing
+list (<a href="https://lists.gnu.org/archive/html/info-gnu/">archive</a>).</p>
 
 <p>Security reports that should not be made immediately public can be sent
@@ -208,22 +217,16 @@
 discussion mailing list (see above).</p>
 
-<dl>
-<dt>Development</dt>
+<p>For development sources, issue trackers, and other information, please
+see the <a href="https://savannah.gnu.org/projects/serveez/">Serveez project
+page</a> at <a href="https://savannah.gnu.org">savannah.gnu.org</a>.</p>
 
-<dd>For development sources, issue trackers, and other information, please
-see the <a href="http://savannah.gnu.org/projects/serveez/">Serveez project
-page</a> at <a href="http://savannah.gnu.org">savannah.gnu.org</a>.</dd>
-
-<dt>Maintainer</dt>
-
-<dd>Serveez is currently being maintained by Thien-Thi Nguyen.  Past
+<p>Serveez is currently maintained by Thien-Thi Nguyen.  Past
 maintainers are: Stefan Jahn,  Raimund Jacob, Martin Grabmüller.  Please
-use the mailing lists for contact.</dd>
-</dl>
+use the mailing lists for contact.</p>
 
 <h3 id="license">Licensing</h3>
 
 <p>Serveez is free software; you can redistribute it and/or modify it under
-the terms of the <a href="http://www.gnu.org/licenses/gpl.html"
+the terms of the <a href="/licenses/gpl.html"
 rel="license">GNU General Public License</a> as published by the Free
 Software Foundation; either version 3 of the License, or (at your option)
@@ -231,6 +234,8 @@
 
 </div>
+</div>
 <!--#include virtual="/server/footer.html" -->
 <div id="footer">
+<div class="unprintable">
 
 <p>Please send general FSF &amp; GNU inquiries to <a
@@ -241,16 +246,17 @@
 
 <p>Please see the <a href="/server/standards/README.translations.html">
-Translations README</a> for information on coordinating and submitting
+Translations README</a> for information on coordinating and contributing
 translations of this article.</p>
+</div>
 
 <p>Copyright &copy; 2013 Free Software Foundation, Inc.</p>
 
 <p>This page is licensed under a <a rel="license"
-href="http://creativecommons.org/licenses/by-nd/3.0/us/">Creative Commons
-Attribution-NoDerivs 3.0 United States License</a>.</p>
+href="http://creativecommons.org/licenses/by-nd/4.0/">Creative Commons
+Attribution-NoDerivatives 4.0 International License</a>.</p>
 
 <!--#include virtual="/server/bottom-notes.html" -->
 
-<p>Updated: 2013-12-02 09:53 UTC (source: <a
+<p class="unprintable">Updated: 2013-12-02 09:53 UTC (source: <a
 href="NEWS-excerpt"><samp>NEWS-excerpt</samp></a>, <a
 href="GNUmakefile"><samp>GNUmakefile</samp></a>)</p>

--------------C7F5EED70D12EABF97850559
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: base64
Content-Disposition: inline

X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KYnVnLXNlcnZl
ZXogbWFpbGluZyBsaXN0CmJ1Zy1zZXJ2ZWV6QGdudS5vcmcKaHR0cHM6Ly9saXN0cy5nbnUub3Jn
L21haWxtYW4vbGlzdGluZm8vYnVnLXNlcnZlZXoK

--------------C7F5EED70D12EABF97850559--