[Date Prev][Date Next] [Chronological] [Thread] [Top]

Re: Automatic referral chasing



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:   pierangelo.masarati@sys-net.it
---------------------------------------





--
Taymour A El Erian
System Division Manager
RHCE, LPIC, CCNA, MCSE, CNA
TE Data
E-mail: taymour.elerian@tedata.net
Web:     www.tedata.net
Tel:    +(202)-33320700
Fax:	+(202)-33320800
Ext:    1101