From owner-svn-doc-all@FreeBSD.ORG Tue Mar 25 00:00:19 2014 Return-Path: Delivered-To: svn-doc-all@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 B5D5E318; Tue, 25 Mar 2014 00:00:19 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id A347CBB3; Tue, 25 Mar 2014 00:00:19 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s2P00Jl9067881; Tue, 25 Mar 2014 00:00:19 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s2P00JGr067880; Tue, 25 Mar 2014 00:00:19 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201403250000.s2P00JGr067880@svn.freebsd.org> From: Gabor Pali Date: Tue, 25 Mar 2014 00:00:19 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44349 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.17 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: Tue, 25 Mar 2014 00:00:19 -0000 Author: pgj Date: Tue Mar 25 00:00:19 2014 New Revision: 44349 URL: http://svnweb.freebsd.org/changeset/doc/44349 Log: - Add 2014Q1 report on the Handbook ZFS chapter Submitted by: Allan Jude Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2014-01-2014-03.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2014-01-2014-03.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2014-01-2014-03.xml Mon Mar 24 22:25:11 2014 (r44348) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2014-01-2014-03.xml Tue Mar 25 00:00:19 2014 (r44349) @@ -18,7 +18,7 @@

Thanks to all the reporters for the excellent work! This report - contains 1 entry and we hope you enjoy reading it.

+ contains 2 entries and we hope you enjoy reading it.

The deadline for submissions covering between April and June 2014 is July 7th, 2014.

@@ -30,6 +30,12 @@ Ports + + doc + + Documentation + + Chromium @@ -89,4 +95,86 @@ you can join testing and submitting patches upstream. + + + ZFS Chapter of the Handbook + + + + + Allan + Jude + + freebsd@allanjude.com + + + + + Benedict + Reuschling + + bcr@FreeBSD.org + + + + + Warren + Block + + wblock@FreeBSD.org + + + + + Preview ZFS Handbook + Slides from AsiaBSDCon 2014 + + + +

ZFS is one of the premier features of &os;. The current + documentation in the Handbook and elsewhere online is severely + lacking. Much of the original documentation from Sun and Oracle + has disappeared, moved, or is about the proprietary version of + ZFS.

+ +

New users have many questions about ZFS and yet there exists a + great deal more bad advice about ZFS than proper documentation. + The current ZFS chapter of the &os; Handbook starts off with the + required steps to configure an i386 machine to run ZFS. This is + more likely to scare off a new user than to educate them about + how to properly use ZFS.

+ +

At BSDCan 2013, the process of writing an entirely new + chapter of the Handbook on ZFS was started. Currently this + chapter consists of approximately 16,000 words covering all + subcommands of the zpool(8) and zfs(8) + utilities, delegation, tuning and a section devoted to + defintions and explainations of the terms and features of + ZFS.

+ +

The remaining section is the FAQ. To help users address the + most common problems they might run into with ZFS. It would be + useful to hear experiences, questions, misconceptions, gotchas, + stumbling blocks and suggestions for the FAQ section from other + users. Also, a use cases section that highlights some of the + cases where ZFS provides advantages over traditional file + systems.

+ +

Please send suggestions to the freebsd-doc mailing + list.

+ + + ScaleEngine, Inc + + + Technical review by Matt Ahrens (co-creator of ZFS). + Improve delegation section. + Improve tuning section, add new sysctls added in + head. + Add section on jails and the jailed property. + Add FAQ section. + Add Use Cases section. + General editing and review. + +