From owner-freebsd-doc@FreeBSD.ORG Thu Jun 25 02:50:58 2009 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DEE24106567A for ; Thu, 25 Jun 2009 02:50:58 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from gloomweaver.pittgoth.com (gloomweaver.pittgoth.com [205.134.165.107]) by mx1.freebsd.org (Postfix) with ESMTP id 8891E8FC1C for ; Thu, 25 Jun 2009 02:50:58 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from localhost.fbsdsecure.org (net-ix.gw.ai.net [205.134.160.6]) (authenticated bits=0) by gloomweaver.pittgoth.com (8.14.3/8.14.3) with ESMTP id n5P2uUAm055596 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Wed, 24 Jun 2009 22:56:31 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Wed, 24 Jun 2009 22:50:43 -0400 From: Tom Rhodes To: Dan Naumov Message-Id: <20090624225043.3b15a2cc.trhodes@FreeBSD.org> In-Reply-To: <200906240820.n5O8K4g5097079@freefall.freebsd.org> References: <200906240820.n5O8K4g5097079@freefall.freebsd.org> X-Mailer: Sylpheed version 1.0.6 (GTK+ 1.2.10; amd64-portbld-freebsd8.0) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org Subject: Re: docs/135983: "The Z File System" - title is misleading and causes search issue X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 25 Jun 2009 02:50:59 -0000 On Wed, 24 Jun 2009 08:20:04 GMT Dan Naumov wrote: > The following reply was made to PR docs/135983; it has been noted by GNATS. > > From: Dan Naumov > To: bug-followup@FreeBSD.org, dan.naumov@gmail.com > Cc: > Subject: Re: docs/135983: "The Z File System" - title is misleading and causes > search issue > Date: Wed, 24 Jun 2009 11:14:12 +0300 > > Hopefully you didn't take an offense to my initial PR, the Handbook > guide was what actually had me started on getting into ZFS with > FreeBSD :) Not really - just wanted to note why I used that title. ;) > > Either way, I had some other changes in mind as well, for example the > RAID-Z example uses a pool made of 2 disks. While it will obviously > work, all SUN documentation indicates that the suggested amount of > vdevs for a RAIDZ or RAIDZ2 pool is between 3 and 9 devices and that > bigger pools should be broken up to be made of smaller groups of vdevs > (for example 2 x 7disk RAIDZ for a single pool 14 disk setup).. Using > RAIDZ with just 2 disks will result in slower performance than simply > using a ZFS mirror and using more than 9 disks is likely to cause > problems with parity computations (I have already heard stories of > people running into Bad Things (tm) while using a 24-disk RAIDZ-2 and > a 14-disk RAIDZ configurations during resilvering and scrubs). Things > like this definitely deserve a mention. > > If you don't have much time, I could see if I could find a few moments > over the next week or 2 to make a few changes. What's the proposed > format of change submissions? Are edited files ok or does one need to > submit patches and if it's the latter, whats the syntax for making > properly suited diffs? Well, I like `diff -ru` :) This URL: http://www.freebsd.org/docproj/ Has a great deal of information related to working up patches for the documentation set. Just in case you want to do more than just the ZFS chapter. :) Thanks, -- Tom Rhodes