From owner-freebsd-doc@FreeBSD.ORG Mon Apr 1 11:13:26 2013 Return-Path: Delivered-To: docs@freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id B7C4D4F2 for ; Mon, 1 Apr 2013 11:13:26 +0000 (UTC) (envelope-from m.e.sanliturk@gmail.com) Received: from mail-ve0-f179.google.com (mail-ve0-f179.google.com [209.85.128.179]) by mx1.freebsd.org (Postfix) with ESMTP id 7C9FD756 for ; Mon, 1 Apr 2013 11:13:26 +0000 (UTC) Received: by mail-ve0-f179.google.com with SMTP id cz11so2326013veb.24 for ; Mon, 01 Apr 2013 04:13:20 -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=ceoHN9v607CAqXbQHiwLSh+WCT8GcYRFeTvlq1/a/X8=; b=Zqf72xra08NEHr66QVJgdOzaVLRxktaPpBXM71xQySpisb/thc5bXP2h28iZIecb21 42Yt9CuHVkEulpjtaV6EPyOuBiUv/cxQfveZ525JFwF4SZ60IigUN06FwwfCOhWWhBoN iwIluFQYBygfzc2gfU6dnaFYAW2inOlAc36ocWxfsU4k/UCfgBSJ9qxHsmyqI0Lf5ymJ /ZqV1nNiTPBOGHzYx/VDMTPeEG7ZwZl5kAYEy80C4VAmYbhQwpLSxNq9RtDuSQehhfwd 2c80ugDhhCceDPnOyM8gdZXHr7qb2VxViQXKT4p2tz/uFhBEa3Q0pWTrbH3aeODcAURR mIqg== MIME-Version: 1.0 X-Received: by 10.52.68.116 with SMTP id v20mr7317658vdt.126.1364814800755; Mon, 01 Apr 2013 04:13:20 -0700 (PDT) Received: by 10.58.132.203 with HTTP; Mon, 1 Apr 2013 04:13:20 -0700 (PDT) In-Reply-To: References: Date: Mon, 1 Apr 2013 04:13:20 -0700 Message-ID: Subject: Re: a proposal for the FAQ From: Mehmet Erol Sanliturk To: Chris Rees Content-Type: text/plain; charset=UTF-8 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 11:13:26 -0000 On Mon, Apr 1, 2013 at 2:24 AM, Chris Rees wrote: > 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 > Actually a more useful step is to move answers to questions into the Handbook . The FreeBSD Handbook with its present structure is a very nice work . Some documentation solely based on questions and answers are not appealing like the FreeBSD Handbook , and in reality , they are difficult to use , because there are no regular structure in them . Thank you very much . Mehmet Erol Sanliturk