Date: Sat, 08 Feb 2014 14:59:52 +0100 From: Benedict Reuschling <bcr@FreeBSD.org> To: freebsd-doc@FreeBSD.org Subject: Re: [PATCH] Use a bullet list for general policies Message-ID: <52F63858.3010202@FreeBSD.org> In-Reply-To: <201401311421.31347.jhb@freebsd.org> References: <201401311421.31347.jhb@freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
-----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-----
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?52F63858.3010202>