From owner-freebsd-doc@FreeBSD.ORG Fri Jan 31 23:14:58 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 552D3BD5 for ; Fri, 31 Jan 2014 23:14:58 +0000 (UTC) Received: from mail-qc0-x231.google.com (mail-qc0-x231.google.com [IPv6:2607:f8b0:400d:c01::231]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 0FB3D134E for ; Fri, 31 Jan 2014 23:14:57 +0000 (UTC) Received: by mail-qc0-f177.google.com with SMTP id i8so7958157qcq.8 for ; Fri, 31 Jan 2014 15:14:57 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eitanadler.com; s=0xdeadbeef; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type; bh=lYarsAv4ejNzicsKU3VyKI321dikbAzmtro7eqCRLp4=; b=NWLt447PXCPtXIz4J0C2X4WSRrPRx+k85zwSqC4FPb7htTxYMH7D7kyL4W9kFsoE6c Zou5ZJizahcSnx2BtVf/91HD2BrSncsBiablBvT8Zz/gPFKjfWBxaSKEzRVlc4/6MwwI 6cPJL6qPxJgkfCs+nWVqUlSwvNVIb08EmMvsU= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc:content-type; bh=lYarsAv4ejNzicsKU3VyKI321dikbAzmtro7eqCRLp4=; b=a2HZ8lgFqBlC2R9y3A+InEuSV3PGxFwdlKHnInRemLVUMZnHsEJ5Zcrc9uJUR0pToK X45x8fFE3iOYF6QKAiLZMI8/Rku6UcjoF3QbFDrOU0Kos/RfPkRj0Lnu5SBuH1jHE7WR pNKPBGpk+dUVSe7lht2rEAoKB7FQ2a6F+/a/mLnITwt2VYUsOvm/Ky7xt/k8rXKd4avI fYZJFkOVfFsFHo2dcrSWQtOcGPzbJVMWVL/SzpaSiMHAecGBgVpB7Lrnz9SfIajk5o8w 9BEZz0o9lSohk7a7IXRdm6tKeUofn6FqC5FV1y+B+PSGmxK5EbqKY2p7v8Cm/9tcr5qv 1Q5Q== X-Gm-Message-State: ALoCoQnndDChbsUtFT/m629rkCUd1CJXh9yVIDdjc9K3dPKahMidcLo7cRPyGqP256YQSryXKrqd X-Received: by 10.140.47.101 with SMTP id l92mr34647140qga.9.1391210097240; Fri, 31 Jan 2014 15:14:57 -0800 (PST) MIME-Version: 1.0 Received: by 10.96.30.229 with HTTP; Fri, 31 Jan 2014 15:14:27 -0800 (PST) In-Reply-To: <201401311421.31347.jhb@freebsd.org> References: <201401311421.31347.jhb@freebsd.org> From: Eitan Adler Date: Fri, 31 Jan 2014 18:14:27 -0500 Message-ID: Subject: Re: [PATCH] Use a bullet list for general policies To: John Baldwin Content-Type: text/plain; charset=UTF-8 Cc: FBSD Doc project 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 23:14:58 -0000 On Fri, Jan 31, 2014 at 2:21 PM, John Baldwin wrote: > 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). Alphabetical? > Any objections? LGTM -- Eitan Adler