From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from <gentoo-doc+bounces-1317-garchives=archives.gentoo.org@lists.gentoo.org>) id 1R3FED-0001tB-NV for garchives@archives.gentoo.org; Mon, 12 Sep 2011 22:43:49 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id CBE5D21C0E6; Mon, 12 Sep 2011 22:43:36 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id CF5BB21C070 for <gentoo-doc@lists.gentoo.org>; Mon, 12 Sep 2011 22:43:20 +0000 (UTC) Received: from [10.13.135.101] (klon.ost.sgsnet.se [46.239.105.134]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) (Authenticated sender: klondike) by smtp.gentoo.org (Postfix) with ESMTPSA id 0B0FE1B400C for <gentoo-doc@lists.gentoo.org>; Mon, 12 Sep 2011 22:43:19 +0000 (UTC) Message-ID: <4E6E8ABB.5050909@gentoo.org> Date: Tue, 13 Sep 2011 00:42:03 +0200 From: "Francisco Blas Izquierdo Riera (klondike)" <klondike@gentoo.org> User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.2.20) Gecko/20110831 Lightning/1.0b3pre Thunderbird/3.1.12 Precedence: bulk List-Post: <mailto:gentoo-doc@lists.gentoo.org> List-Help: <mailto:gentoo-doc+help@lists.gentoo.org> List-Unsubscribe: <mailto:gentoo-doc+unsubscribe@lists.gentoo.org> List-Subscribe: <mailto:gentoo-doc+subscribe@lists.gentoo.org> List-Id: Gentoo Linux mail <gentoo-doc.gentoo.org> X-BeenThere: gentoo-doc@lists.gentoo.org Reply-to: gentoo-doc@lists.gentoo.org MIME-Version: 1.0 To: gentoo-doc@lists.gentoo.org Subject: Re: [gentoo-doc] /etc/conf.d/hwclock and /etc/conf.d/adjkerntz References: <4E6D35A3.5020005@gentoo.org> <CAPzO=NzUdghPsFW0wo5zbXWFfFf+3-zW7pcAHoKSmvhn_xKQog@mail.gmail.com> In-Reply-To: <CAPzO=NzUdghPsFW0wo5zbXWFfFf+3-zW7pcAHoKSmvhn_xKQog@mail.gmail.com> X-Enigmail-Version: 1.1.2 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="------------enig06F3E77A8B743FD00AB8D0E1" X-Archives-Salt: X-Archives-Hash: 06f136501235746681da00b298c2a8a1 This is an OpenPGP/MIME signed message (RFC 2440 and 3156) --------------enig06F3E77A8B743FD00AB8D0E1 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable El 12/09/11 16:29, Sven Vermeulen escribi=F3: > My main concern here is that there will be a place where the number of > choices is too big. When that happens we can always split the document and create new per choice ones, that's what is done with the handbooks for example, true? > Also, you'll risk getting a higher frequency on > bug reports on such paragraphs. Well I have to disagree with that, less more review documents will have less bug reports than many less reviewed ones. > Think for instance bootloaders, how > would we deal with guides there? I think the way we do is ok, I mean having different parts for different bootloaders. > I'm sure we do not want to generate > separate guides for just all this sort of stuff (and then use > keywords)... We don't. > What about making it generic (edit your clock management configuration > like, like /etc/conf.d/hwclock on ... )? Well this particular case offers the deal that the configuration to change is the same (just in different places), the problem with generic definitions is that they tend to confuse users, and if we specify a single alternative then users of the others will get even more confused. --------------enig06F3E77A8B743FD00AB8D0E1 Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.17 (GNU/Linux) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/ iEYEARECAAYFAk5uir8ACgkQcfrM1mX4BmC+0ACgt7fMcYMxc3Qsv0luWTL8KmdU /H4An2TESKBgYMraUcXkDWW9Ata8zibI =0HTx -----END PGP SIGNATURE----- --------------enig06F3E77A8B743FD00AB8D0E1--