From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 21647 invoked from network); 29 Dec 2003 19:29:07 +0000 Received: from smtp.gentoo.org (128.193.0.39) by eagle.gentoo.oregonstate.edu with DES-CBC3-SHA encrypted SMTP; 29 Dec 2003 19:29:07 +0000 Received: from lists.gentoo.org ([128.193.0.34] helo=eagle.gentoo.org) by smtp.gentoo.org with esmtp (Exim 4.24) id 1Ab34c-0006Wa-0l for arch-gentoo-portage-dev@lists.gentoo.org; Mon, 29 Dec 2003 19:29:06 +0000 Received: (qmail 5770 invoked by uid 50004); 29 Dec 2003 19:22:35 +0000 Mailing-List: contact gentoo-portage-dev-help@gentoo.org; run by ezmlm Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail Reply-To: gentoo-portage-dev@lists.gentoo.org X-BeenThere: gentoo-portage-dev@gentoo.org Received: (qmail 6817 invoked from network); 29 Dec 2003 19:22:35 +0000 Date: Mon, 29 Dec 2003 20:22:18 +0100 From: Sven Vermeulen To: gentoo-portage-dev@lists.gentoo.org Cc: gentoo-doc@lists.gentoo.org Message-ID: <20031229192218.GA3152@gentoo.org> Mail-Followup-To: gentoo-portage-dev@lists.gentoo.org, gentoo-doc@gentoo.org References: <200312271631.45947.blauwers@gentoo.org> <1072652564.4194.132.camel@music.gentoo.org> <200312291855.50854.blauwers@gentoo.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="pWyiEgJYm5f9v55/" Content-Disposition: inline In-Reply-To: <200312291855.50854.blauwers@gentoo.org> X-Operating-System: Linux 2.4.20 X-Telephone: +32 486 460306 User-Agent: Mutt/1.5.4i Subject: [gentoo-portage-dev] Re: [gentoo-doc] Re: [gentoo-portage-dev] coveted features X-Archives-Salt: 9b049580-0ad9-4c44-b229-1f617a48a856 X-Archives-Hash: 28be7d51bd52a7c19a6f363c86c86e38 --pWyiEgJYm5f9v55/ Content-Type: text/plain; charset=iso-8859-15 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Dec 29, 2003 at 06:55:50PM +0100, Bart Lauwers wrote: [...] > Anyway we've got lots of docs but were lacking a good taxonomy for them, > do we have any librarians helping the docs team? (cc'ing doc to get a rep= ly > about this) Librarians? Not that I know off... What do you mean with taxonomy? > So let me rephrase that portage docs need to be complete and up to date at > all times (at least an english version, devs should know enough english). > Linking the documentation to the code is the only way I can see this happ= en. Creating documentation automatically always reduces the readability of the documentation. It all depends on who's the intended reader. If it is a developer (and *only* a developer) then creating documentation automatically might be suggesteable (although not official as there is no QA on it - don't dare send me bugreports on automatically created documentation :) If it also involves users, then sorry, I don't think this is a good idea.= =20 Wkr, Sven Vermeulen --=20 ^__^ And Larry saw that it was Good. (oo) Sven Vermeulen (__) http://www.gentoo.org Documentation & PR --pWyiEgJYm5f9v55/ Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (GNU/Linux) iD8DBQE/8H7qXfqz7M26L9sRAl08AJ96ubnoqmpsYWUbU5aD9eCFJ70azgCfWyjn RVSlq6eC1ktdgegdsXx5Pmg= =XY4Z -----END PGP SIGNATURE----- --pWyiEgJYm5f9v55/--