In message <199608221721.LAA22317@llama.swcp.com>, "Lazlo Nibble" writes:
>>> I don't know what the rest of you think, but Managing Internet
>>> Information Services by O'Reilly is an invaluable resource when working
>>> with Majordomo, but most of the people I've helped don't know about
>>> it.
>>
>> I find this statement quite amazing, considering that the pertinent
>> chapter is included in Doc/majordomo.ora.
>
>I think we might be able to improve matters some by condolidating all this
>documentation in a *single* *publicly-available* location.
As one who was part of the technical review of said O'Reilly chapter,
(and current FAQ maintainer) I completely agree with Lazlo. For
one thing the O'Reilly chapter is now very out of date. It covers
version 1.62(!). It only covers a few basic changes in 1.90.
For one reason or another, Majordomo's documentation has always been
scant. That's fine for when the program is still new and evolving,
but I can't count the number of times people have come to me
saying "oh, I'd like to install Majordomo but it seems so hard
to install, and too complex".
I see there's been a lot of work in 1.94 to improve things.
INSTALL, README, NEWLIST and Doc/list-owner-info are much better now
than with 1.93.
However we need to get rid of all the old ghosts lying around in
the documentation. remove resend.README, Description, sample.aliases.
Merge Changelog and Changes.
I'd be nice to have the documentation in some good printable and
viewable format, such as PDF. (perhaps doing what the Perl doc
guys are doing?)
Alas I better check out the majordomo-users archive, cause I'm not
on that list anymore and I missed this thread.
--Dave
References:
|
|
