From owner-freebsd-doc@FreeBSD.ORG Fri Jan 31 19:21:35 2014 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id E0F6965E for ; Fri, 31 Jan 2014 19:21:35 +0000 (UTC) Received: from bigwig.baldwin.cx (bigwig.baldwin.cx [IPv6:2001:470:1f11:75::1]) (using TLSv1 with cipher ADH-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id BA5D610FE for ; Fri, 31 Jan 2014 19:21:35 +0000 (UTC) Received: from jhbbsd.localnet (unknown [209.249.190.124]) by bigwig.baldwin.cx (Postfix) with ESMTPSA id A19F0B946 for ; Fri, 31 Jan 2014 14:21:34 -0500 (EST) From: John Baldwin To: doc@freebsd.org Subject: [PATCH] Use a bullet list for general policies Date: Fri, 31 Jan 2014 14:21:31 -0500 User-Agent: KMail/1.13.5 (FreeBSD/8.4-CBSD-20130906; KDE/4.5.5; amd64; ; ) MIME-Version: 1.0 Content-Type: Text/Plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Message-Id: <201401311421.31347.jhb@freebsd.org> X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.2.7 (bigwig.baldwin.cx); Fri, 31 Jan 2014 14:21:34 -0500 (EST) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 31 Jan 2014 19:21:35 -0000 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 @@

General Policies

-

Here you will find various things such as the -New Account Creation Procedure, -the -Commit Bit Expiration Policy, -the -Core Bylaws, -the -Commit Bit and Project Resources Policy, -Core's Voting Procedures, -the -Fortune File Policy, -the -Internationalization Policy, -the -User Data Policy, -the -Hats Term Limits Policy, -and the -Problem Report Handling Guidelines.

+

The FreeBSD Documentation Project

-- John Baldwin