From owner-freebsd-doc@FreeBSD.ORG Thu Nov 20 16:46:41 2008 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 903921065670 for ; Thu, 20 Nov 2008 16:46:41 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: from ey-out-2122.google.com (ey-out-2122.google.com [74.125.78.26]) by mx1.freebsd.org (Postfix) with ESMTP id 1615A8FC0C for ; Thu, 20 Nov 2008 16:46:40 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: by ey-out-2122.google.com with SMTP id 6so223753eyi.7 for ; Thu, 20 Nov 2008 08:46:39 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :organization:user-agent:mime-version:to:cc:subject:references :in-reply-to:x-enigmail-version:content-type :content-transfer-encoding:sender; bh=EmOTRCcauJdQqtOPe7VNls7C1zrPvunXu7NuoIsIhB4=; b=tsMO31qzbdow+B6yPkMBsEuA6gG4g3Zz5HcluY4DuLmX5rtuBDgkwSB0Es9rpBFzKg bARYR+IWN0+EqyiD/0g9qeYDlNQnXfQ2DIMVTxq5sJE4wcwe0Cd6AomKISnKaBYYyQUx bheLhA+WUBkcosKa9AlADZNNSQk1Ak5Ylaq+Y= DomainKey-Signature: a=rsa-sha1; c=nofws; d=googlemail.com; s=gamma; h=message-id:date:from:organization:user-agent:mime-version:to:cc :subject:references:in-reply-to:x-enigmail-version:content-type :content-transfer-encoding:sender; b=qc47dGTj4mP+/fDu2SRIMdcsZd/4IJtQHj9de7EHcIKIFtmBmwPfSf9/QseNwshBVm TIY5vILuUPv39b/+47fHL0WWsNBd1aZevgy3RXRVYMfPiwpEOkQVJAiPmf0gw54kD6qp qBsea+V+qGt9ASrlPjCxuebJ77iy/q1OGVL+Y= Received: by 10.210.51.10 with SMTP id y10mr2115759eby.87.1227199599580; Thu, 20 Nov 2008 08:46:39 -0800 (PST) Received: from ?192.168.1.30? (oktnb24.inf.elte.hu [157.181.167.24]) by mx.google.com with ESMTPS id 7sm1574163eyg.32.2008.11.20.08.46.38 (version=TLSv1/SSLv3 cipher=RC4-MD5); Thu, 20 Nov 2008 08:46:38 -0800 (PST) Message-ID: <49259459.1000700@FreeBSD.org> Date: Thu, 20 Nov 2008 17:46:17 +0100 From: Gabor PALI Organization: The FreeBSD Project User-Agent: Thunderbird 2.0.0.17 (X11/20081023) MIME-Version: 1.0 To: Manolis Kiagias References: <491E9A3E.2070201@a1poweruser.com> <492544FC.9090504@FreeBSD.org> <4925739E.4060208@gmail.com> In-Reply-To: <4925739E.4060208@gmail.com> X-Enigmail-Version: 0.95.7 Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 7bit Sender: =?UTF-8?B?UMOBTEkgR8OhYm9yIErDoW5vcw==?= Cc: doc@FreeBSD.org Subject: Re: Add a Splash Screen Section to the Handbook? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 20 Nov 2008 16:46:41 -0000 Manolis Kiagias wrote: > I followed the discussion and I think this is useful info that should > be part of the documentation. Thanks for the support. > The submitted text looks ok more or less (and I am quite sure you > will it touch it up anyway ;) ). Yep, it is very probable :) > I am more concerned about the placement of this info though. Initially, I had the very same concern about this contribution, but when I looked through Chapter 3, I found a lot of FreeBSD-specific information in it. > Supposedly the first part of the Handbook is more or less > introductory and designed to teach fundamental UNIX concepts. [..] But I have to agree with you. > Would you rather find the discussion of a splash screen useful? I > doubt it. What's more, you would not be able to fully understand what > is going on. There is another possible section for this info: Chapter > 12 (boot). Hm, I think it is a great idea! What do you think of appending it to section ``12.3 The Boot Manager and Boot Stages'' (as a sub-section)? > There are could also be other places, but this is the only that comes > to mind at the moment. One could also argue we need something of a > "Misc settings" chapter, where all this useful but maybe hard to > categorize stuff would go. But then again, this maybe the role of the > FAQ. I recommended to not to include the entire text in the FAQ itself for Joe because I think the FAQ should be "compact and quick". Joe wrote a complete and precise description on the topic, so it should be placed in the Handbook and referenced (only) from the FAQ. I am trying to defer the introduction of a potential "Misc Settings" chapter until we really encounter things that do not fit in the actual contents or outgrew their limits. > By the way, the above is just a suggestion, if the general consensus > is to merge it into the Basics chapter, I won't object :) At the moment, I would prefer to inject it into Section 12.3. If there is no explicit objection in the next few days, I will try start to work on its SGML version and send a patch to the list for review. Comments are still welcome. Cheers, :g