I would actually argue that the documentation is very good *for UNIX heads*, but
for the great unwashed, it is too vague and 'techie' (at least this is the
feedback *I* get from a few folks helping me, who are *not* UNIX-literate.
For those that understand UNIX, it's pretty clear, but for those who don't, it
could use a fair amount of clarification -- or dumbing-down. ;-)
Just my $0.02, worth about that much right now (though, if the market continues
to rise...;-)
David
>
> -----BEGIN PGP SIGNED MESSAGE-----
>
> >>>>> "PB" == Peter Bowyer <pbowyer@verity.com> writes:
>
> PB> This must be the most common source of confusion at the present time -
> PB> I wonder if the docs and/or FAQ maintainers might consider reworking
> PB> the relevant sections ?
>
> The confusion is not due to a failure on the documentation. Read through
> majordomo.ora and you will see that it presents clear and concise step by
> step instructions for installing Majordomo and setting up mailing lists,
> including a variety of tests to ensure that everything works correctly and
> what to do if they fail. No, the "confusion" is due to people trying to
> install Majordomo without reading the instructions first. No FAQ or
> rewording of the documentation will help those who need it because they are
> not reading them in the first place.
>
> -----BEGIN PGP SIGNATURE-----
> Version: 4.0 Business Edition
> Charset: noconv
>
> iQCVAwUBM7PTxZ6VRH7BJMxHAQHtJgP5AcQ/iZotZCJ5bfIEkInJsHbf7v94FnvW
> +h5uQMmBJ84QkczW/hQZrSBB8BoxTlS5pVfJqJRV1wHsY3oUCKAAMyMGgsY3zV7w
> 7Cy/YasEGvky0W0UNkbXJpIvVVy4EZVRkGDKrmlavyf80GZB3hjXx7QNof/svhin
> a1+Hqhgnn1M=
> =GI9+
> -----END PGP SIGNATURE-----
>
> --
> Rich Pieri <rich.pieri@prescienttech.com> | When not in use, Happy Fun Ball
> Prescient Technologies, Inc. | should be returned to its special
> A Stone & Webster Company | container and kept under
> I speak for myself, not PTI or SWEC | refrigeration.
--
David G. Simmons, Java Technologist Voice: (919) 460-2966
125 Edinburgh South, Suite 105 FAX: (919) 481-1698
Cary, NC 27511 SunWeb: http://kibble.East/
Pager: (919) 271-6983 (Numeric, Text, or voicemail)
Dave? Who's Dave? I'm not Dave!
"I'm off to Wall Street. Don't wait up."
-Susie Derkins
Follow-Ups:
|
|
