From owner-freebsd-www@FreeBSD.ORG Wed Jan 21 02:51:20 2004 Return-Path: Delivered-To: freebsd-www@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 28AC316A4CE; Wed, 21 Jan 2004 02:51:20 -0800 (PST) Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0CA4A43D2D; Wed, 21 Jan 2004 02:51:19 -0800 (PST) (envelope-from linimon@lonesome.com) Received: by mail.soaustin.net (Postfix, from userid 502) id 78F4B146FA; Wed, 21 Jan 2004 04:51:18 -0600 (CST) Date: Wed, 21 Jan 2004 04:51:18 -0600 (CST) From: Mark Linimon X-X-Sender: linimon@pancho To: freebsd-doc@FreeBSD.org, Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII cc: trhodes@FreeBSD.org cc: kensmith@cse.Buffalo.EDU Subject: Re: RFC: rework of the main web site's "internal" page X-BeenThere: freebsd-www@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: FreeBSD Project Webmasters List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 21 Jan 2004 10:51:20 -0000 Now that everyone's back from the new year, let's see if we can try to pick up this idea again. The general change that I'm suggesting is to rearrange the page on http://www.FreeBSD.org/internal to make it less ugly and more logically organized. There are two parts to this: 1) fixing that page itself (including removing redundant information that is on other pages already), and 2) attempting to split up the next-level "Resources For Developer's" page into "technical resources" versus "policies". The former is probably a better success than the latter at this point, but it's a start at trying to avoid introducing too many new concepts to fresh volunteers. (Why list the machine resources and commit bit policies before even talking about their responsibilities?) I've incorporated feedback from Ken Smith in terms of getting rid of contractions. The prototype pages can be loaded from http://www.lonesome.com/FreeBSD_www/en/internal/internal.html and going from there. In that directory, you can also find http://www.lonesome.com/FreeBSD_www/en/internal/diff.out. There you'll be able to see that there is not much new text, that's it mostly a rearrangement and style update. In some cases a little bit of text has been added to make it less "dry". I'm not really too attached to any of the specifics in the proposal (except one) but I already think it's better than what we have. The one specific? That's those huge blue links in the original; those just have to go :-) mcl