From owner-freebsd-doc@FreeBSD.ORG Mon May 8 00:33:50 2006 Return-Path: X-Original-To: doc@FreeBSD.org Delivered-To: freebsd-doc@FreeBSD.ORG Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id CC6AD16A406; Mon, 8 May 2006 00:33:50 +0000 (UTC) (envelope-from danger@rulez.sk) Received: from mail.rulez.sk (DaEmoN.RuLeZ.sK [84.16.32.226]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1BDF843D49; Mon, 8 May 2006 00:33:49 +0000 (GMT) (envelope-from danger@rulez.sk) Received: from localhost (localhost [127.0.0.1]) by mail.rulez.sk (Postfix) with ESMTP id 15C7E1CC6C; Mon, 8 May 2006 02:33:48 +0200 (CEST) Received: from DANGER (unknown [217.73.23.230]) by mail.rulez.sk (Postfix) with ESMTP id A67531CC33; Mon, 8 May 2006 02:33:36 +0200 (CEST) Date: Mon, 8 May 2006 02:32:56 +0200 From: Daniel Gerzo X-Mailer: The Bat! (v3.62.14) Professional X-Priority: 3 (Normal) Message-ID: <168248421.20060508023256@rulez.sk> To: Hiroki Sato In-Reply-To: <20060508.083506.59684188.hrs@allbsd.org> References: <20060507144535.GB42180@gothmog.pc> <1545851395.20060507170205@rulez.sk> <20060507163758.GA51229@gothmog.pc> <20060508.083506.59684188.hrs@allbsd.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Virus-Scanned: by amavisd-new at mail.rulez.sk X-Spam-Status: No, score=-2.599 tagged_above=-999 required=5 tests=[BAYES_00=-2.599] X-Spam-Score: -2.599 X-Spam-Level: Cc: doc-committers@FreeBSD.org, doc@FreeBSD.org, cvs-doc@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re[2]: cvs commit: doc/en_US.ISO8859-1/books/handbook Makefile book.sgml chapters.ent doc/en_US.ISO8859-1/books/handbook/nanobsd Makefile chapter.sgml X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Daniel Gerzo List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 08 May 2006 00:33:51 -0000 Hello Hiroki, Monday, May 8, 2006, 1:35:06 AM, you answered: > Giorgos Keramidas wrote > in <20060507163758.GA51229@gothmog.pc>: ke>> I would probably like seeing something like an ``Embedded FreeBSD'' ke>> chapter in the Handbook, where all available options would be listed, ke>> including NanoBSD, FreeSBIE, and the upcoming TinyBSD too. > I think it is good for us to have a document for such variants of > installation method, but I disagree with adding a chapter to Handbook > for them. This is because NanoBSD and so on are nothing but special > methods of build/installation and IMHO they are beyond the scope > of Handbook. We have even more advanced topics in Handbook than NanoBSD is. See next paragraph. > As you know, Handbook introduces a basic installation procedure > and explains several common tasks for system administrators basically > on the assumption that they are using a normally-installed FreeBSD box. > So, we include advanced topics beyond the scope such as articles/multi-os > or article/fbsd-from-scratch (both explain some special methods of > build/installation) as articles so far. In short, I think Handbook > should be organized for average sysadmins, not as an encyclopedia, > and topics like NanoBSD are too advanced. Then we can tell the same about the whole MAC and Audit chapters, since they seem a lot more advanced and tricky to me than NanoBSD. > Daniel Gerzo wrote > in <198819470.20060508002924@rulez.sk>: da>> What I dislike on articles is that they are not under such view as a da>> Handbook chapters are, so they are getting outdated easier as well as da>> people often dig only in Handbook for information. > How likely sentences are getting outdated is nothing to do with > whether it is in Handbook or not, and if people often look for information > only in Handbook we should encourage them to look at the other materials > by adding pointers, for example, instead of adding all of information into > Handbook. The FreeBSD project is known as a very well documented Operating System. As far as I've been working with FreeBSD and seeking for documentation and more information about things I wanted to try out, the first place I've looked at was our great Handbok. I feel that having documentation at one place is more comfortable than googling it for XY minutes. Also if I was an avarage system administrator and I would notice a NanoBSD chapter in Handbook, I would say: "Wow, what is this? Let's see...". So there's a higher chance that more people can notice it and play with it. At least, we have some discussion about it here, the doc@ list seemed to me as it has been already dead :-) -- Sincerely, Daniel Gerzo