From owner-freebsd-doc@FreeBSD.ORG Mon Apr 1 09:24:59 2013 Return-Path: Delivered-To: docs@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 29CAFB78 for ; Mon, 1 Apr 2013 09:24:59 +0000 (UTC) (envelope-from utisoft@gmail.com) Received: from mail-ie0-x22e.google.com (mail-ie0-x22e.google.com [IPv6:2607:f8b0:4001:c03::22e]) by mx1.freebsd.org (Postfix) with ESMTP id 01174E36 for ; Mon, 1 Apr 2013 09:24:58 +0000 (UTC) Received: by mail-ie0-f174.google.com with SMTP id aq17so2102366iec.5 for ; Mon, 01 Apr 2013 02:24:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:x-received:in-reply-to:references:date:message-id :subject:from:to:cc:content-type; bh=yXBd5wAcF5p4OQMvhzes+HbfaT8eA9EEgGhFvXRYL7k=; b=Yf0V0RY8nht/mo+BtDm1SM1mdYI5LphyjNLu9Hk/H9ZeyYcWh811LKusB2P9wbZ92W UbHeGSiNhK0GSFgR3C2ePCm1ve5saQ4jYdEv/cSCeOG5CXTvfAAlfF1ztmm7iaRblfCl yGit6yy1xWQW58SynR7xWkWmh+CAVUTp9GhB2dO0FDZqyM2ru8nDpqKP9GuwiQt4KIFP W7MBIniFPETAyKaGPhX/52Us6hz31fz+iDrPfij7VAHx7xjqpFaBP29Heg/sAiBCOTu6 FcVK36HXYFV38JTuK0d0c8/jFzj/4KoGnvB8PsjlcqdGmIbYiBm89zZvjhVIx0oKYUTk kCRA== MIME-Version: 1.0 X-Received: by 10.50.13.175 with SMTP id i15mr3269008igc.75.1364808298693; Mon, 01 Apr 2013 02:24:58 -0700 (PDT) Received: by 10.64.58.52 with HTTP; Mon, 1 Apr 2013 02:24:58 -0700 (PDT) Received: by 10.64.58.52 with HTTP; Mon, 1 Apr 2013 02:24:58 -0700 (PDT) In-Reply-To: References: Date: Mon, 1 Apr 2013 10:24:58 +0100 Message-ID: Subject: Re: a proposal for the FAQ From: Chris Rees To: Eitan Adler Content-Type: text/plain; charset=ISO-8859-1 X-Content-Filtered-By: Mailman/MimeDel 2.1.14 Cc: docs@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 01 Apr 2013 09:24:59 -0000 On 1 Apr 2013 05:25, "Eitan Adler" wrote: > > Hi all, > > Over the past several months I have been working on a project called > ThwackAFAQ. For those who don't know this project has been to review, > edit, and rewrite the FAQ to be relevant to the modern day. > I've removed references to hardware that hasn't been sold in over 10 > years or to software features that reached their EoL in FreeBSD 2.x. > At this date I feel the project has reached a level of maturity such > that it makes sense to write this email: > > I propose that we merge the handbook into the FAQ. > > While they both cover the same material the handbook source is over > 83892 lines of XML while the FAQ is now at a measly 8242 lines. > Further the FAQ is in bite sized chunks while the FAQ requires lots of > tedious reading. Translators currently have issues keeping up with > the pace of changes in both books, and must translate the same basic > content twice. If only we could have one clear and canonical source > for translators to work with. > > Sure there are some topics not covered in the same depth in the FAQ > but many Linux distributions solve this in a very nice way: distribute > the details and extraneous items to bloggers and tip writers. This > releases us, the doc team, from all the extra work of writing and fact > checking things that will no longer be true in the next version of > FreeBSD. Not only that but it even generates more content for the > front page where we publish articles written about the operating > system. > > Over the next few weeks (as soon as the doc slush ends) I intend to > move the last few remaining portions of the handbook into the FAQ and > commit the removal of the handbook once and for all. I'm going to ruin the April Fool here because I'm worried you'll get lynched. Nice one :) Chris