Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 31 Jan 2014 14:21:31 -0500
From:      John Baldwin <jhb@freebsd.org>
To:        doc@freebsd.org
Subject:   [PATCH] Use a bullet list for general policies
Message-ID:  <201401311421.31347.jhb@freebsd.org>

next in thread | raw e-mail | index | archive | help
Right now the internal policies page has a paragraph that lists the project's
policies inline in one big sentence.  I find this harder to work with as if
I'm looking for a particular policy I have to scan the entire sentence.  I
think in this case a bulleted list works better.  The patch below changes it
(note that I haven't reordered them, and it may be that there is a better
order, though I'm not sure what it would be).  Any objections?

Index: head/en_US.ISO8859-1/htdocs/internal/policies.xml
===================================================================
--- head/en_US.ISO8859-1/htdocs/internal/policies.xml   (revision 43698)
+++ head/en_US.ISO8859-1/htdocs/internal/policies.xml   (working copy)
@@ -34,25 +34,18 @@
 
 <h2><b>General Policies</b></h2>
 
-<p>Here you will find various things such as the
-<a href="new-account.html">New Account Creation Procedure</a>,
-the
-<a href="expire-bits.html">Commit Bit Expiration Policy</a>,
-the
-<a href="bylaws.html">Core Bylaws</a>,
-the
-<a href="resources.html">Commit Bit and Project Resources Policy</a>,
-<a href="core-vote.html">Core's Voting Procedures</a>,
-the
-<a href="fortunes.html">Fortune File Policy</a>,
-the
-<a href="i18n.html">Internationalization Policy</a>,
-the
-<a href="data.html">User Data Policy</a>,
-the
-<a href="hats.html">Hats Term Limits Policy</a>,
-and the
-<a href="../doc/en_US.ISO8859-1/articles/pr-guidelines/">Problem Report Handling Guidelines</a>.</p>
+<ul>
+  <li><a href="new-account.html">New Account Creation Procedure</a></li>
+  <li><a href="expire-bits.html">Commit Bit Expiration Policy</a></li>
+  <li><a href="bylaws.html">Core Bylaws</a></li>
+  <li><a href="resources.html">Commit Bit and Project Resources Policy</a></li>
+  <li><a href="core-vote.html">Core's Voting Procedures</a></li>
+  <li><a href="fortunes.html">Fortune File Policy</a></li>
+  <li><a href="i18n.html">Internationalization Policy</a></li>
+  <li><a href="data.html">User Data Policy</a></li>
+  <li><a href="hats.html">Hats Term Limits Policy</a></li>
+  <li><a href="../doc/en_US.ISO8859-1/articles/pr-guidelines/">Problem Report Handling Guidelines</a></li>
+</ul>
 
 <h2><b>The FreeBSD Documentation Project</b></h2>
 

-- 
John Baldwin



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201401311421.31347.jhb>