From owner-freebsd-doc@FreeBSD.ORG  Tue Jun  5 18:35:51 2007
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
X-Original-To: doc@FreeBSD.org
Delivered-To: freebsd-doc@FreeBSD.ORG
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id A0E1916A41F
	for <doc@FreeBSD.org>; Tue,  5 Jun 2007 18:35:51 +0000 (UTC)
	(envelope-from asmodai@in-nomine.org)
Received: from smtp-vbr2.xs4all.nl (smtp-vbr2.xs4all.nl [194.109.24.22])
	by mx1.freebsd.org (Postfix) with ESMTP id 3D0D113C44B
	for <doc@FreeBSD.org>; Tue,  5 Jun 2007 18:35:50 +0000 (UTC)
	(envelope-from asmodai@in-nomine.org)
Received: from nexus.in-nomine.org (chronias.xs4all.nl [82.92.216.8])
	by smtp-vbr2.xs4all.nl (8.13.8/8.13.8) with ESMTP id l55IZm9D072738;
	Tue, 5 Jun 2007 20:35:49 +0200 (CEST)
	(envelope-from asmodai@in-nomine.org)
Received: from localhost (localhost.domini.in-nomine.org [127.0.0.1])
	by nexus.in-nomine.org (Postfix) with ESMTP id CA909C667;
	Tue,  5 Jun 2007 20:34:30 +0200 (CEST)
X-Virus-Scanned: by XS4ALL Virus Scanner
Received: from nexus.in-nomine.org ([127.0.0.1])
	by localhost (nexus.domini.in-nomine.org [127.0.0.1]) (amavisd-new,
	port 10024)
	with ESMTP id DwmPkYf3CE82; Tue,  5 Jun 2007 20:34:27 +0200 (CEST)
Received: by nexus.in-nomine.org (Postfix, from userid 1000)
	id 972F0C666; Tue,  5 Jun 2007 20:34:27 +0200 (CEST)
Date: Tue, 5 Jun 2007 20:34:27 +0200
From: Jeroen Ruigrok van der Werven <asmodai@in-nomine.org>
To: Chris Borokowski <athloi@yahoo.com>
Message-ID: <20070605183427.GU1356@nexus.in-nomine.org>
References: <20070605181523.GT1356@nexus.in-nomine.org>
	<721177.36811.qm@web57803.mail.re3.yahoo.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <721177.36811.qm@web57803.mail.re3.yahoo.com>
Organisation: Ninth Circle Enterprises
User-Agent: Mutt/1.5.15 (2007-04-06)
Cc: doc@FreeBSD.org
Subject: Re: BSD
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 05 Jun 2007 18:35:51 -0000

-On [20070605 20:23], Chris Borokowski (athloi@yahoo.com) wrote:
>Suggested top of page text:

[snip suggestion]

Of which page? The link from "Get FreeBSD"?

>The user is clueless and frustrated, but our
>introductory docs are often obfuscated.

Too much technospeak, true. On the other hand, Unix is also not quite for the
faint at heart. So we do need to strike a balance somewhere. IIRC you are also
a technical writer, so I think when it comes to defining audience you and I
both agree we do expect a basic proficiency in both computer software and
computer hardware.

Then again (rant-mode on), despite the overhaul on the frontpage it is still
cluttered. It is nice to have beastie there, but:

1) I thought the new FreeBSD logo was supposed to totally replace it for
   various reasons,
2) it takes up valuable screen estate (which already is being wasted by
   centering the page and throwing away left and right margins (which we try
   to balance out by using a miniscule font-size setting).

-- 
Jeroen Ruigrok van der Werven <asmodai(-at-)in-nomine.org> / asmodai
イェルーン ラウフロック ヴァン デル ウェルヴェン
http://www.in-nomine.org/ | http://www.rangaku.org/
Life can only be understood backwards, but it must be lived forwards...