Date: Wed, 11 Mar 1998 17:08:23 +0200 From: Jeremy Lea <reg@shale.csir.co.za> To: nik@iii.co.uk, alexandr@hawk.pearson.udel.edu Cc: Annelise Anderson <andrsn@andrsn.stanford.edu>, freebsd-doc@FreeBSD.ORG Subject: Re: ps2pdf (was: newbies mailing list) Message-ID: <19980311170823.64512@shale.csir.co.za> In-Reply-To: <19980305215748.36179@iii.co.uk>; from nik@iii.co.uk on Thu, Mar 05, 1998 at 09:57:48PM %2B0000 References: <199803052049.PAA00460@hawk.pearson.udel.edu.> <19980305215748.36179@iii.co.uk>
next in thread | previous in thread | raw e-mail | index | archive | help
Hi... On Thu, Mar 05, 1998 at 09:57:48PM +0000, nik@iii.co.uk wrote: > In the pipeline. When we've got the translation to DocBook sorted out > (which hopefully won't be too far away) it's a (relatively) trivial > matter to turn the documentation into a multitude of formats. > > Watch this space. Is there going to be any reorganisation of the FAQ and Handbook while this transition is in progress? It would seem like the right time to me to start messing with the ordering while your changing all the codes and making big diffs. I printed out the FAQ a while back in the hope of getting down to doing a technical/language edit of it (because its smaller than the handbook :), but I found that I kept wanting to move chapters around. Is there any published statement of purpose for the two documents? What makes them different, what should they cover, etc. I would think that the handbook would be a fairly static document (excepting big changes in the system :), and the FAQ would cover the day to day issues like which hardware is supported/recommended, and such things, but it almost seems to be the other way around. I remember something from Jordan a while back saying that the handbook was the place for activity? Also, both the FAQ and handbook have statements to the effect that they are only for the latest release version and then volumes of text which applies to all releases and to current. I personally would think that any question which lasts over 6 months in the FAQ is stale and should be properly documented somewhere else. In a month or so I should have enough time to get back into the editing process. Do you think that the docbook transition will be done by then? because I'd rather not do the work twice... Regards, -Jeremy -- | "In this world of temptation, I will stand for what is right. --+-- With a heart of salvation, I will hold up the light. | If I live or if I die, if I laugh or if I cry, | in this world of temptation, I will stand." -Pam Thum To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19980311170823.64512>