Pierangelo Masarati wrote:
Taymour A. El Erian wrote:
Pierangelo,
I don't want to get into a debate about the importance of
documentation, but documentation is really one of the most important
things about software.
Thanks for educating me on the importance of documentation. If you
could also instruct me about **how** it should be improved, not just
**why**, that would be a "giant leap for the mankind".
As I said below, why not mention the overlays in the administrator
guide, add some real life examples (lots of them available from the
mailing list questions). The man pages are good for quick reference but
not for installation (specially for new admins.).
If you as a developer understand the code, this doesn't mean the code
is usable since most of those who use it are not developers and do
not know how to read the code. Everybody appreciates the time and
effort given by the developers. The administrator guide has no
mention of the overlays (at least not chain) and the man pages do not
give enough description, also the administrator guide could add
examples for some configurations, maybe like those ones being asked
in the mailing list.
I really searched for my question a lot in the list but could not
find it.
Did you search the -software for "chain;referral"? I got 51 hits,
most of them pertinent.
p.
Ing. Pierangelo Masarati
OpenLDAP Core Team
SysNet s.r.l.
via Dossi, 8 - 27100 Pavia - ITALIA
http://www.sys-net.it
---------------------------------------
Office: +39 02 23998309
Mobile: +39 333 4963172
Email: [EMAIL PROTECTED]
---------------------------------------
--
Taymour A El Erian
System Division Manager
RHCE, LPIC, CCNA, MCSE, CNA
TE Data
E-mail: [EMAIL PROTECTED]
Web: www.tedata.net
Tel: +(202)-33320700
Fax: +(202)-33320800
Ext: 1101
