From owner-freebsd-doc@FreeBSD.ORG Wed Jun 24 08:10:04 2009 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 854581065670 for ; Wed, 24 Jun 2009 08:10:04 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 689C48FC17 for ; Wed, 24 Jun 2009 08:10:04 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id n5O8A4fE088057 for ; Wed, 24 Jun 2009 08:10:04 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id n5O8A4cC088056; Wed, 24 Jun 2009 08:10:04 GMT (envelope-from gnats) Date: Wed, 24 Jun 2009 08:10:04 GMT Message-Id: <200906240810.n5O8A4cC088056@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Manolis Kiagias Cc: 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 Reply-To: Manolis Kiagias List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 24 Jun 2009 08:10:04 -0000 The following reply was made to PR docs/135983; it has been noted by GNATS. From: Manolis Kiagias To: Tom Rhodes Cc: freebsd-doc@FreeBSD.org, bug-followup@FreeBSD.org Subject: Re: docs/135983: "The Z File System" - title is misleading and causes search issue Date: Wed, 24 Jun 2009 10:37:29 +0300 Tom Rhodes wrote: > The following reply was made to PR docs/135983; it has been noted by GNATS. > > From: Tom Rhodes > To: Dan Naumov > Cc: bug-followup@FreeBSD.org > Subject: Re: docs/135983: "The Z File System" - title is misleading and > causes search issue > Date: Wed, 24 Jun 2009 02:58:47 -0400 > > On Tue, 23 Jun 2009 21:53:27 GMT > Dan Naumov wrote: > > > > > >Number: 135983 > > >Category: docs > > >Synopsis: "The Z File System" - title is misleading and causes search issue > > >Confidential: no > > >Severity: non-critical > > >Priority: medium > > >Responsible: freebsd-doc > > >State: open > > >Quarter: > > >Keywords: > > >Date-Required: > > >Class: doc-bug > > >Submitter-Id: current-users > > >Arrival-Date: Tue Jun 23 22:00:13 UTC 2009 > > >Closed-Date: > > >Last-Modified: > > >Originator: Dan Naumov > > >Release: 7.2-RELEASE > > >Organization: > > >Environment: > > FreeBSD atom.localdomain 7.2-RELEASE-p1 FreeBSD 7.2-RELEASE-p1 #0: Tue Jun 9 18:02:21 UTC 2009 root@amd64-builder.daemonology.net:/usr/obj/usr/src/sys/GENERIC amd64 > > >Description: > > People looking for information regarding ZFS support in FreeBSD are very likely to start by opening the handbook table of contents in their web browser, initiate their browser search function and search for "ZFS". This will result in 0 matches and the user will be left confused, thinking the handbook has no articles on the subject. > > > > Proposal: edit the following files: > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/filesystems-zfs.html > > > > and change any instances of "The Z File System" (a name which has no basis on reality) to "ZFS - Zettabyte File System". This will make the term searchable using web browser (or any other viewer) search functions allowing easier access for the user. Additionally this would decipher the ZFS acronym in a proper way with actual basis on the origin of the name. > > Actually, the term "Zettabyte" is out dated too. As for the "Z > file system" - I read that somewhere. I just can't remember, > perhaps it was the source code or a link on Sun's site or a > developer blog; trust me, I wouldn't have used it otherwise. > Searching around it appears that it's an orphan acronym > (according to: > http://opensolaris.org/os/community/zfs/faq/#whatstandfor) > > I have no issue with the changes, and may even make them > myself if I find the time; however, I just wanted to > explain where the "basis of reality" part. Thanks, > > --- > Tom Rhodes > The chapter still appears when using the "search the Handbook" link, so I feel this is not much of an issue. As a compromise though, we could probably change the title to: "The Z File System (ZFS)"