Date: Thu, 20 Nov 2008 17:46:17 +0100 From: Gabor PALI <pgj@FreeBSD.org> To: Manolis Kiagias <sonic2000gr@gmail.com> Cc: doc@FreeBSD.org Subject: Re: Add a Splash Screen Section to the Handbook? Message-ID: <49259459.1000700@FreeBSD.org> In-Reply-To: <4925739E.4060208@gmail.com> References: <NBECLJEKGLBKHHFFANMBKELDCMAA.joeb@a1poweruser.com> <491E9A3E.2070201@a1poweruser.com> <492544FC.9090504@FreeBSD.org> <4925739E.4060208@gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?49259459.1000700>