[PATCH] Use a bullet list for general policies

[Benedict Reuschling]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

Am 31.01.14 20:21, schrieb John Baldwin:
> 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>
> 
> 

Hmm, maybe we should group "Commit Bit Expiration Policy" and "Commit
Bit and Project Resources Policy" together as well as the "Core
Bylaws" with "Core's Voting Procedures" as they are related topics.
The rest is pretty much standalone and I can't find any other better
order. I can also live with Eitan's suggestion of having them in
alphabetical order.

in general, I like the bullet list better than the original list of
links in a long setence.

Regards

Benedict
-----BEGIN PGP SIGNATURE-----
Version: GnuPG/MacGPG2 v2.0.22 (Darwin)
Comment: GPGTools - https://gpgtools.org
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/

iQEcBAEBCgAGBQJS9jhYAAoJEAQa31nbPD2LBFEIAMHEkvOMjr0hr4ImrRt+Gemm
MJf9jTzB3kqEWEe4ZfvHbg0B3/CGk8Ni86d50p3t5xDEQCzK/We7JHMDkOjS9iOr
xIT2KW4aaFgLKWkGUZdNTazhWKvBxDIA5JaBNGtG8073uF6JPJBfWnljsIiEKOAb
x2C5L2tpVb8Yd5W5Oav/sM7OxjwmFUMTBHjjaepwDB0wHiwqviyrA3pjLrGnGNba
YyqLXtRD43EomFb7jUD4b5ypCaTv50giCETkf/qwJ7ZlX/wgVbuG/r1VND70J2IH
m7j+zzf0pnAN6Fg5G7Vb+NxiMm54fsfm1QQtUh1eo6KHUPLgdXh1S2+EKyg+hVw=
=O8Ug
-----END PGP SIGNATURE-----