[PATCH] Use a bullet list for general policies

John Baldwin jhb at freebsd.org
Fri Jan 31 19:21:35 UTC 2014


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


More information about the freebsd-doc mailing list