Re: comprehensive documentation

From: Brian Capouch (brianc_at_palaver.net)
Date: 2002-08-28 20:43:03 UTC


Jason Boxman wrote:> On Wednesday 28 August 2002 04:25 pm, Brian Capouch wrote:
> 

>>Jason Boxman wrote:> On Wednesday 28 August 2002 06:18 am,
>>

>
> <snip>
>
> 
>>They are not experts in the subject domain, though; I can get them
>>started and give them pointers to existing documents.  But there will of
>>necessity need to be someone of some degree of authority who can work
>>with them to verify that their work is correct and helpful.

>
>
> I assume you've got a machine or two running HostAP there, then?
>

Yep. We're also playing around with NoCat, and to my mind right now the two of them together are synergistically more than the sum of their respective parts, and so if anyone on the list thinks that to be either advisable (!! or stupid!!) I am thinking that doing them in tandem, sort   of glancing at one while doing the other, might be a Good Thing.

> 

>>If anyone is interested in such an approach, please let me know.
>>DocBook is in fact a possibility for us; there is some knowledge and
>>experience in its use floating around here.

>
>
> That sounds excellent. I'm actually in need of some DocBook knowledge myself.
> Should I install LyX for that? I've heard of people simply doing it by hand
> as well.
>

I'm doing my stuff by hand. I played with LyX a bit a while ago, and am not certain that the GUI ease it offered overcame the lack of fine-grained control. It also may be radically better by now, or perhaps supplanted by something better.

DocBook is way cool, but it's a big boat to navigate into the slip, IMO.

I meet with this class Friday afternoon and will try to line up some volunteers at that time.

Thanks.

B.

This archive was generated by hypermail 2.1.4.