Bug#952501: slapd: README.Debian does not note that databases are created

[Karl O. Pinc]

Hi Ryan,

On Tue, 25 Feb 2020 11:07:57 -0800
Ryan Tandy <ryan at nardis.ca> wrote:

> I made a few adjustments to your text, and noted a couple of other 
> things that tend to surprise new users.
> 
> I wonder if you have any feedback on this version (below).

I've attached a new patch, based on yours.

Mentioned that MDB is the default backend.

Tweaked various sentences, in various ways.  Tried to simplify
and shorten sentences.  This necessarily makes the document
a little longer, but friendlier.

Used the word "entry" and in general made more clear that
it's all about altering ldap entry/attributes in various
ldap databases.

Got rid of extra words.

Got rid of "will".  It is rarely useful in technical docs.

Made a practice of putting dn-s in double quotes, to set them
off from the other text.  What do you think?

Consistently use "configuration database" and "directory database" as
the identifiers for the 2 initial ldap dbs.  Use "directory
administrator" to identify the admin entry.

Tried to make a distinction between an administrator, a person,
and a the directory administrator LDAP entry in the DIT.
Let me know how well this worked.

Note that the dn of the entry in the configuration DIT
defaults to "olcDatabase={1}mdb,cn=config", but is not
_always_ this.  (It would be different if you chose a different
back-end.)  This is only mentioned and not elaborated on.

Made clear (hopefully) the options used by the Unix root user
to maintain the database.

Regards,

Karl <kop at karlpinc.com>
Free Software:  "You don't pay back, you pay forward."
                 -- Robert A. Heinlein
-------------- next part --------------
A non-text attachment was scrubbed...
Name: slapd.README.Debian.v2.patch
Type: text/x-patch
Size: 4267 bytes
Desc: not available
URL: <http://alioth-lists.debian.net/pipermail/pkg-openldap-devel/attachments/20200225/4cebf820/attachment.bin>