From owner-svn-doc-all@FreeBSD.ORG Fri Nov 2 14:25:42 2012 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id E97E38F9 for ; Fri, 2 Nov 2012 14:25:42 +0000 (UTC) (envelope-from lists@eitanadler.com) Received: from mail-lb0-f182.google.com (mail-lb0-f182.google.com [209.85.217.182]) by mx1.freebsd.org (Postfix) with ESMTP id 52D628FC1D for ; Fri, 2 Nov 2012 14:25:42 +0000 (UTC) Received: by mail-lb0-f182.google.com with SMTP id b5so3367343lbd.13 for ; Fri, 02 Nov 2012 07:25:41 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eitanadler.com; s=0xdeadbeef; h=mime-version:sender:in-reply-to:references:from:date :x-google-sender-auth:message-id:subject:to:cc:content-type; bh=9IXM8ZjGX4OG4oeMWxMSvjWYK0nPffzCBowEvW05Bu4=; b=TyiIVBEhnTYrYNfHTVlqdy5+HvPqC2XyEFtm/amkhRStQ/ZyoEAzgmZQKKBtZ0+lvR DBvW6bCezNnanEydy2/OtTZMEDVA8fh6ThvplMEin2DsdWJcI2F9Xi36vEFM/SlfgyHE o+Klt6x8uGg8cvwzo8vzsIkmo0H3EBoaPffRE= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=mime-version:sender:in-reply-to:references:from:date :x-google-sender-auth:message-id:subject:to:cc:content-type :x-gm-message-state; bh=9IXM8ZjGX4OG4oeMWxMSvjWYK0nPffzCBowEvW05Bu4=; b=k/NKzICR0xLo1DuyWSd4MXpYcmIYPoAS2SlnwZXsIN3C/ekYrZowmhM9Ph4agPk/e0 0wu3IPJOvtjREBgtUqr6VZCgBrGEXFS3pAbgsQRIKMzQkfJeOlYIJMtuPrsSwa317Qt8 +CnwzNdUX1oTKjtIdppboutZlyfyGqdemQOvWxcGse8Hdql3urAa0gfJANfBqZSDEwLt IQLgyscFLHOMz5XSEd4qN5hrjSJd1IyY0k8C+BN/h2ZaL8cQcZEjLS/uRMF4AS5zngYj YaIRD9KVnejvYPHZCx3xAJMV8IrzbSCJ4aJ3u8z2FB2sj4ZjkWrjjkN5fh1JtIo9PSVj koCg== Received: by 10.112.54.40 with SMTP id g8mr855074lbp.49.1351866341091; Fri, 02 Nov 2012 07:25:41 -0700 (PDT) MIME-Version: 1.0 Sender: lists@eitanadler.com Received: by 10.112.25.166 with HTTP; Fri, 2 Nov 2012 07:25:10 -0700 (PDT) In-Reply-To: <20121102133403.GA1352@glenbarber.us> References: <201211020413.qA24DfDZ040748@svn.freebsd.org> <20121102133403.GA1352@glenbarber.us> From: Eitan Adler Date: Fri, 2 Nov 2012 10:25:10 -0400 X-Google-Sender-Auth: wQjV-ArKV5br7cUZAr6wnKaLBGU Message-ID: Subject: Re: svn commit: r39908 - head/en_US.ISO8859-1/books/handbook/disks To: Glen Barber Content-Type: text/plain; charset=UTF-8 X-Gm-Message-State: ALoCoQkf4XM3wb3NLt+uDvWEr+cepxtJt87fFVJdQ6aXFwBuhMS7omagmhulblG/MoRgUVwYvi+v Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org, Warren Block X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 Nov 2012 14:25:43 -0000 On 2 November 2012 09:34, Glen Barber wrote: > My 2 cents on this is, and always has been, that people (new > contributors, in particular) tend to use the existing markup as a > template for reference on how the document should be formatted. As > such, correcting the existing, badly-formatted markup provides > consistency to new contributors wanting to provide patches, but unsure > of what the "proper style" for these documents is. Makes sense and I completely agree: in fact my mentors already have some giant-whitespace-cleanup patches from me. I was asking about our policy - and it seems I have a good answer. :) -- Eitan Adler Source, Ports, Doc committer Bugmeister, Ports Security teams