Re: Index problems: search results returning no responses

[Graham Leggett <minfrin@sharp.fm>]

Howard Chu wrote:

> The slapd-bdb(5) manpage already says "Note: changing index settings 
> requires rebuilding indices, see slapindex(8)." The default slapd.conf 
> is not intended to be a substitute for reading the actual documentation.

For what reason would an end user consider consulting the slapd-bdb 
manpage before adding an additional directive to slapd.conf? What a 
completely non obvious and counter-intuitive course of action to take.

Documenting something "somewhere" is no substitute for documenting 
something in a meaningful and relevant location. If you store your 
coffee and sugar in the bathroom medicine cabinet it is no surprise that 
your guest cannot make themselves a cup of coffee.

The Principle of Least Astonishment 101.

Regards,
Graham
--