Date: 01 Jul 2000 15:00:24 +0200 From: Rasmus Kaj <kaj@raditex.se> To: jim@FreeBSD.ORG Cc: Rasmus Kaj <kaj@raditex.se> Subject: Re: New User's Handbook Message-ID: <847lb6c8ev.fsf@frodo.sickla.raditex.se> In-Reply-To: Jim Mock's message of "Fri, 30 Jun 2000 12:54:32 -0700" References: <20000630120608.A5841@luna.osd.bsdi.com> <84d7kz55if.fsf@frodo.sickla.raditex.se> <20000630125432.A6144@luna.osd.bsdi.com>
index | next in thread | previous in thread | raw e-mail
>>>>> "JM" == Jim Mock <jim@FreeBSD.ORG> writes: JM> [ ... ] http://soupnazi.org/~jim/FreeBSD/newuser-handbook/ >> [ ... ] 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 [ ... ] JM> It's intended for people new to FreeBSD and who want to learn a bit JM> about it -- it's been pulled directly from the existing handbook. I JM> sort of get the feeling you haven't read any of the other messages about JM> splitting the handbook up. Ok, I've gone back and reread Nik Claytons message and http://people.freebsd.org/~nik/hb/(comments.txt,new-layout.txt) So, this content almost matches what Nik calls "Read This First". Your calling it "New User's Handbook" got me confused ... Maybe it just needs another title. Also, each book in the set of handbooks needs to have, _on_ _the_ _title-page_, a paragraph describing this individual book and a link to set of handbooks. Something like This is an introduction to FreeBSD. It contains what you need to know before reading the <link>other FreeBSD handbooks</link>. Of course, you might want to squeeze in some more there, and thats Ok, but dont make it longer than, say, six lines ... Maybe it should also contain a link to http://www.FreeBSD.org/ (especially in the print version). >> So, what would a new user, knowing some Unix, need? Here's a few items >> [ ... skipping my "other needed topics" ... ] JM> You're missing the point. You're right. It certainly seems I did. >> 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). JM> Yes, it does. Why? Because the handbook is being split up into JM> separate books. Each book can then be read (or published) separately JM> and won't have the copyright that's in the handbook now. Yes, every book need the copyright info. If I can be allowed to talk only about the HTML rendering a moment, I even agree that it should be on the first page (well, maybe a short version with a link to the "lawyer-speak"). But it can come at the end of the page ... All in all, the first page of a book could be more welcoming. Actually, I do have some knowledge of DocBook and the modular dsssl stylesheets, I'll take a look at this and mail a more specific suggestion to the list ... -- Rasmus Kaj -------------------- rasmus@kaj.se - http://Raditex.se/~kaj/ \ The more things change, the more they stay insane \------------------------------------------------- http://Raditex.se/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the messagehelp
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?847lb6c8ev.fsf>