Date: Fri, 24 Feb 2006 04:02:55 +0900 (JST) From: Hiroki Sato <hrs@FreeBSD.org> To: joel@FreeBSD.org Cc: doc@FreeBSD.org, murray@freebsdmall.com Subject: Re: cvs commit: www/share/sgml includes.navdevelopers.sgml Message-ID: <20060224.040255.106684002.hrs@allbsd.org> 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>
next in thread | previous in thread | raw e-mail | index | archive | help
----Security_Multipart(Fri_Feb_24_04_02_55_2006_961)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Joel Dahl <joel@freebsd.org> 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)----
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20060224.040255.106684002.hrs>