Date: Sun, 16 Oct 2005 01:27:37 +0900 (JST) From: Hiroki Sato <hrs@FreeBSD.org> To: doc@FreeBSD.org Subject: Re: docs/87445: comments for improvement of handbook/kernelconfig-config.html Message-ID: <20051016.012737.111131088.hrs@allbsd.org> In-Reply-To: <20051015153207.GF1202@gothic.blackend.org> References: <4350FA82.4050201@FreeBSD.org> <20051015130248.GV99170@submonkey.net> <20051015153207.GF1202@gothic.blackend.org>
next in thread | previous in thread | raw e-mail | index | archive | help
----Security_Multipart(Sun_Oct_16_01_27_37_2005_824)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Marc Fonvieille <blackend@freebsd.org> wrote in <20051015153207.GF1202@gothic.blackend.org>: bl> Our current problem is that supporting 6.X, 5.X and 4.X at the same time bl> in our docs is a nightmare. It is not really possible to maintain many bl> versions of the same large doc (book) without headaches, especially for I do not think splitting the existing handbook into ones for each version helps for the maintenance. Although the handbook is very large as you pointed out, many parts of it are version-neutral. Parts where supporting multiple versions is important and the maintenance is difficult, should be split off into an article, I think. The kernconfig section is a good candidate for that because 1) this section is less important for average users now since they do not need to create their own custom kernel, and 2) the information is version-specific. Splitting the whole handbook duplicates the version-neutral parts and it makes the maintenance difficult, I guess. Which part is difficult to maintain now? If there is such a part, probably it should not be in the handbook. -- | Hiroki SATO ----Security_Multipart(Sun_Oct_16_01_27_37_2005_824)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.2 (FreeBSD) iD8DBQBDUS35TyzT2CeTzy0RAqP6AJ45q5FTKVqCLwNOOZhliqiMDUErCQCeIW6L YzlJMBUOkK0494bFQnBiAW4= =gbrD -----END PGP SIGNATURE----- ----Security_Multipart(Sun_Oct_16_01_27_37_2005_824)----
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20051016.012737.111131088.hrs>