Jeroen Ruigrok van der Werven asmodai at
Tue Jun 5 18:35:51 UTC 2007

-On [20070605 20:23], Chris Borokowski (athloi at 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-)> / asmodai
イェルーン ラウフロック ヴァン デル ウェルヴェン |
Life can only be understood backwards, but it must be lived forwards...

More information about the freebsd-doc mailing list