From owner-freebsd-doc Fri Jun 30 12:32:47 2000 Delivered-To: freebsd-doc@freebsd.org Received: from raditex.se (gandalf.raditex.se [192.5.36.18]) by hub.freebsd.org (Postfix) with ESMTP id AC17E37B568; Fri, 30 Jun 2000 12:32:42 -0700 (PDT) (envelope-from kaj@raditex.se) Received: (from kaj@localhost) by raditex.se (8.9.3/8.9.3) id VAA17616; Fri, 30 Jun 2000 21:32:40 +0200 (CEST) (envelope-from kaj@raditex.se) X-Authentication-Warning: frodo.sickla.raditex.se: kaj set sender to kaj@raditex.se using -f To: jim@FreeBSD.ORG Cc: doc@FreeBSD.ORG Subject: Re: New User's Handbook References: <20000630120608.A5841@luna.osd.bsdi.com> From: Rasmus Kaj Cc: Rasmus Kaj Organization: Raditex AB - http://Raditex.se/ X-Face: M9cR~WYav<"fu%MaslX0`43PAYY?uIsM8[#E(0\Xuy9rj>4gE\h3jm.7DD?]R8*^7T\o&vT U@[53Dwkuup4[0@gw#~kyu>`unH?kVj9CJa02(h>Ki\+i=%rn%sDf^KC.!?IHkKjMAbkd\jgmphp^' d|Q;OeXEAhq?ybGqOs1CHb6TJT42'C`Krnk61//AOfXtNjj/t'`5>Vw0QX!dKfOL$.f+S"LIuwR<;I Z0Qnnx(F^F]o@*V%TUtEV'1Z[TkOl^FFV9Z~A[b19%}uP*,huCU Date: 30 Jun 2000 21:32:40 +0200 In-Reply-To: Jim Mock's message of "Fri, 30 Jun 2000 12:06:08 -0700" Message-ID: <84d7kz55if.fsf@frodo.sickla.raditex.se> Lines: 57 User-Agent: Gnus/5.0806 (Gnus v5.8.6) XEmacs/20.4 (Emerald) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >>>>> "JM" == Jim Mock writes: JM> Howdy folks, JM> Since sending the last message on the New User's Handbook, I haven't JM> gotten *any* replies.. has anyone looked at it? It's available at JM> http://soupnazi.org/~jim/FreeBSD/newuser-handbook/ Ok, here come's a little comment ... I don't really see who the intended reader is here. Anoyone interested in the history and goals of the project probably already know so much that he don't need the "Unix basics" chapter. So, you should either focus on the "Unix basics" part and make a one-page introduction of chapters one to four, or assume the reader knows some unix, but is new to FreeBSD. I would make an appendix of chapter six, and assume most readers know it anyway ... So, what would a new user, knowing some Unix, need? Here's a few items * An introduction to the ports and packages system. * Some words about /etc/rc.conf, other startup scripts etc, and about /stand/sysinstall. * A firm voice telling them not to run -current, and probably some introduction to the mailing lists. And one other thing; Do every document _have_ _to_ start with a full page of copyright information? Why not have a paragraph of introducing text, supposed to make people want to read the document, not scare them away (the handbook has such a paragraph, but it's squeezed in between the copyright line and the page of legal terms). How about putting things like this instead:

Document title

Author (or "FreeBSD doc project")

A paragraph of text, telling how nice and usefull it would be to read this document. ------------------- (dividing hr) ------------------------------ Table Of Contents. ... ------------------- (dividing hr) ------------------------------

Legal terms

Redistribution and use in source (SGML DocBook) ... and all that If we do this, people might even start to read the documentation. :-) -- Rasmus Kaj -------------------- rasmus@kaj.se - http://Raditex.se/~kaj/ \ Where ever I place my .emacs, is my ${HOME}. -LysLysKom \------------------------------------------------- http://Raditex.se/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message