Date: Tue, 23 Sep 1997 16:16:00 -0400 (EDT) From: "Luke H." <pascale@cockatoo.aus.org> To: John Fieber <jfieber@indiana.edu> Cc: doc@FreeBSD.ORG, nik@iii.co.uk Subject: RE: Doc projects Message-ID: <XFMail.970923161600.pascale@cerebellar.corrosion-rust.com> In-Reply-To: <Pine.BSF.3.96.970923115530.17661K-100000@fallout.campusview.indiana.edu>
next in thread | previous in thread | raw e-mail | index | archive | help
On 23-Sep-97 John Fieber wrote: > On Mon, 15 Sep 1997 nik@iii.co.uk wrote: > >> my own machine at home. At which point I'd like to get more involved with >> the documentation project. What tasks are up for grabs at the moment? > > What REALLY needs to happen is for someone to do a cover-to-cover > reading of the handbook and flag things that are out of date, > flat out wrong, or generally incomprehensible. I've stumbled > into things in all categories, and I know there are more. Some > things are trivial to fix, otherwise just compile notes like > "sect 8.3.2: yada yada yada is correct for 2.1, but the > procedure was changed for 2.2. Note the change." > > THEN, we will no what needs to be done. :) > > Although it would be easy to divide up the reading among a number > of people, having one person do it has the distinct advantage of > being better able to spot larger scale structural glitches, > however at ~300 pages printed, that is no tiny task. (I recently > finished tech editing a ~370 page book...but I got paid for it :) > > As far as new docs, I think we could really use a "FreeBSD > performance tuning" guide. This should cover (a) what > performance information exists, (b) how to get it, (c) how to > interpret it, and (d) what to do about it. > > Why is this an important document? Because the applications that > separate FreeBSD from the alternatives (read: Linux) are server > applications where small performance tweaks can have a big > effect. > > (c) in particular can be quite complex as I discovered when I > started drafting a little blub about looking at memory > usage...what *exactly* do things like vss and rss reveal? Things > like this have been at the root of a number of Linux/BSD debates > when, in fact, the numbers being compared between the systems > were not really comparable because of differences in reporting. > > A lot of the answers are diffused in the archives of the hackers > mailing lists, and can be picked from the brains of core team > members. > > -john > I am willing to work on this, except in cases where a particular piece of hardwa re is neccessary to do the writing/checking of the handbook. E-Mail: Luke H. <pascale@cerebellar.corrosion-rust.com> This message was sent by XFMail1.2a
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?XFMail.970923161600.pascale>