From owner-freebsd-doc@FreeBSD.ORG Thu Feb 23 19:05:04 2006 Return-Path: X-Original-To: doc@FreeBSD.org Delivered-To: freebsd-doc@FreeBSD.ORG Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id D5C3916A420; Thu, 23 Feb 2006 19:05:04 +0000 (GMT) (envelope-from hrs@FreeBSD.org) Received: from mail.allbsd.org (vlsi00.si.noda.tus.ac.jp [133.31.130.32]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2A71043D49; Thu, 23 Feb 2006 19:05:03 +0000 (GMT) (envelope-from hrs@FreeBSD.org) Received: from delta.allbsd.org (p27088-adsau15honb8-acca.tokyo.ocn.ne.jp [221.187.113.88]) (authenticated bits=128) by mail.allbsd.org (8.13.4/8.13.4) with ESMTP id k1NJ4oPi036910; Fri, 24 Feb 2006 04:05:02 +0900 (JST) (envelope-from hrs@FreeBSD.org) Received: from localhost (alph.allbsd.org [192.168.0.10]) by delta.allbsd.org (8.13.4/8.13.4) with ESMTP id k1NJ4Lwc017427; Fri, 24 Feb 2006 04:04:22 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Fri, 24 Feb 2006 04:02:55 +0900 (JST) Message-Id: <20060224.040255.106684002.hrs@allbsd.org> To: joel@FreeBSD.org From: Hiroki Sato In-Reply-To: <1140717189.681.22.camel@dude.automatvapen.se> References: <1140617051.681.35.camel@dude.automatvapen.se> <20060222174523.GB64282@freebsdmall.com> <1140717189.681.22.camel@dude.automatvapen.se> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 4.2.52 on Emacs 21.3 / Mule 5.0 (SAKAKI) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Fri_Feb_24_04_02_55_2006_961)--" Content-Transfer-Encoding: 7bit X-Virus-Scanned: ClamAV version 0.86.2, clamav-milter version 0.86 on gatekeeper.allbsd.org X-Virus-Status: Clean Cc: doc@FreeBSD.org, murray@freebsdmall.com Subject: Re: cvs commit: www/share/sgml includes.navdevelopers.sgml 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, 23 Feb 2006 19:05:05 -0000 ----Security_Multipart(Fri_Feb_24_04_02_55_2006_961)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Joel Dahl wrote in <1140717189.681.22.camel@dude.automatvapen.se>: jo> Please answer this question: Why should we hide this information? I think murray does not say all of the information in the internal/* pages should be hidden. Some are useful, but some are not maintained well and misleading for the wider audience. So, blindly making all of them more visible does not sound reasonable to me. Although they are already accessible, but it does not always mean they need more visibility. If there is useful information, it is better to reorganize and put them to areas outside the internal/ directory. At least, making a link to the pages and marking them as "internal" in more public areas like the side navigation menu is very confusing (what is "internal"?) and the current contents under the internal/ directory are not ready for non-developer audience (outdated and/or not well structured). If you have a plan to improve the contents, could you please show us your thoughts first before making them more accessible? I personally think such useful materials should be integrated into Committer's Guide or so, though... -- | Hiroki SATO ----Security_Multipart(Fri_Feb_24_04_02_55_2006_961)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.2 (FreeBSD) iD8DBQBD/gbfTyzT2CeTzy0RAsi7AKDUo9sEpUeAKAK+9B2aeg8ITLwuaQCgs7j4 wfJJkvoe3knFXRTLP87NsAA= =5IM7 -----END PGP SIGNATURE----- ----Security_Multipart(Fri_Feb_24_04_02_55_2006_961)----