Bug 219142

Summary: Update of "28.5. Lightweight Directory Access Protocol (LDAP)" section of handbook
Product: Documentation Reporter: Rocky Hotas <rockyhotas>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Many People CC: bcr
Priority: --- Keywords: patch
Version: Latest   
Hardware: Any   
OS: Any   
URL: https://www.freebsd.org/doc/handbook/network-ldap.html
Attachments:
Description Flags
Diff file for the section "28.5. Lightweight Directory Access Protocol (LDAP)" of the handbook none

Description Rocky Hotas 2017-05-08 10:38:38 UTC 
Created attachment 182399 [details]
Diff file for the section "28.5. Lightweight Directory Access Protocol (LDAP)" of the handbook

Section "28.5. Lightweight Directory Access Protocol (LDAP)" of the handbook contains several errors (typos, wrong steps) and needs also to be updated: the use of a file slapd.ldif is recommended now, replacing the deprecated slapd.conf. 

1) The first part of the guide has been expanded, corrected and improved; 
2) the second part of the guide has been completely rewritten, providing a working example of the slapd.ldif file and all the necessary steps for the server configuration.

The text has been improved after the useful suggestions in:
https://reviews.freebsd.org/D10600

Then, for the composition, formatting and further improvements, the primer has been followed:
https://www.freebsd.org/doc/en/books/fdp-primer/index.html

A diff file generated as

$ svn diff --diff-cmd=diff -x -U999999 network-servers/chapter.xml > 28-5_LDAP.diff

is attached.
Comment 1 commit-hook freebsd_committer freebsd_triage 2018-12-20 21:54:15 UTC 
A commit references this bug:

Author: bcr
Date: Thu Dec 20 21:54:05 UTC 2018
New revision: 52704
URL: https://svnweb.freebsd.org/changeset/doc/52704

Log:
  Rewrite the LDAP server section of the handbook.

  The Lightweight Directory Access Protocol (LDAP) section of the handbook
  contains several errors (typos, wrong steps) and was in need of updates
  to reflect current versions of the software. Rocky Hotas provided a patch
  for review that fixes many of those bugs and extends the instructions in
  the first part. The second part received a complete rewrite, providing
  working example configuration files and steps to get the server running.

  I made only a few cleanups and corrections to the patch to fit our
  documentation guidelines. Most of the work was done by the submitter, big
  thanks for his work and patience!

  PR:		219142
  Submitted by:	rockyhotas@post.com
  Reviewed by:	remko, wollman, wblock, myself, others
  Approved by:	bcr
  Differential Revision:	https://reviews.freebsd.org/D10600

Changes:
  head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml
Comment 2 Benedict Reuschling freebsd_committer freebsd_triage 2018-12-20 21:55:45 UTC 
A patch was committed, based on the work in https://reviews.freebsd.org/D10600. Thanks for your submission, which has landed in the FreeBSD handbook now. PR closed!