From owner-svn-doc-head@FreeBSD.ORG Fri Nov 2 14:25:42 2012 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id E9F348FA 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 52D1A8FC1C for ; Fri, 2 Nov 2012 14:25:42 +0000 (UTC) Received: by mail-lb0-f182.google.com with SMTP id b5so3367345lbd.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=Ktt3+XsWBWEoLmzZiq3ogV+kWssVUZkzdLtUNAB3KyLUnqlCv6QUUQO7dNyJhX4c4/ cavJBkcCK0nZR4LtOSPNXXAF4wwul3qG0KSnstZ2s1tIo+OjGeTrW+3cX0jW53JyJ7b7 kPxTR02Jt6v5LxfHDk5LPvO/kXuTwqg15m3HRQe47sgIrrsA/Uc77McZJqINp258LMk6 imKRtTgfIp3jIwx7+9jcJEEutA1NvR6CFdR6oyXBlSB4XrXGHmGIYPHra0VtHCZApuU8 7AqZQqOwNJV8cK0wutDXUvXrKoc6QoiqDtcJUuAwY/VDkcAgdWdeHyJFjJmO2QXirpjF m9CQ== 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: ALoCoQnkTtHlIjUC0M9D3dcKMzxQQUvsUeNx2MMS8m6qvDSj4qwinR+GA5L9h75jFyd0GL/KpNhq Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org, Warren Block X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for the doc tree for head 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