svn commit: r1776672 - /directory/site/trunk/content/api/user-guide.mdtext

[sm...@apache.org]

Author: smckinney
Date: Sat Dec 31 01:26:56 2016
New Revision: 1776672

URL: http://svn.apache.org/viewvc?rev=1776672&view=rev
Log:
intro

Modified:
    directory/site/trunk/content/api/user-guide.mdtext

Modified: directory/site/trunk/content/api/user-guide.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide.mdtext?rev=1776672&r1=1776671&r2=1776672&view=diff
==============================================================================
--- directory/site/trunk/content/api/user-guide.mdtext (original)
+++ directory/site/trunk/content/api/user-guide.mdtext Sat Dec 31 01:26:56 2016
@@ -21,26 +21,24 @@ Notice: Licensed to the Apache Software
 <DIV class="note" markdown="1">
 <strong>Work in progress</strong>
 
-This is a very preliminary version...
-
 Pages with a (e) at the end of the title are empty pages
 Pages with a (...) ate the end of the title are not completed yet
 Other pages are finished (but may be reviewed)
 </DIV>
 
-This documentation is about the newly LDAP API developped at the Apache Software Foundation. We expect this API will be a replacement for all the ancient API ([jLdap](http://www.openldap.org/jldap/), [Mozilla LDAP SDK](http://www.mozilla.org/directory/) and [JNDI](http://www.oracle.com/technetwork/java/jndi/index.html)).
+This document is about the LDAP API, developed at the Apache Software Foundation. It's a replacement for outdated Java/LDAP libraries like ([jLdap](http://www.openldap.org/jldap/), [Mozilla LDAP SDK](http://www.mozilla.org/directory/) and [JNDI](http://www.oracle.com/technetwork/java/jndi/index.html)).
 
 ## About this guide
 
-Getting started. Learn how to use the LDAP API, connect to various LDAP server, manipulate the data within your directory. 
+Getting started. Learn how to use the LDAP API, connect to various LDAP servers, manipulate the data within a directory. 
 
 ### Audience
 
-This guide is primarily for people new to the LDAP API. If you plan to use the API as is, maybe even for your first LDAP experience, you'll (hopefully) find all information necessary to do so. Only basic tasks are covered. Learn more about the options you have (and many other things) in the [Advanced User's Guide].
+This guide is for anyone wanting to learn how to use the LDAP API. If you plan to use the API, maybe even for your first LDAP experience, you'll find information here to help. Right now we've got pretty good coverage of the basic tasks.  Later, we'll add more advanced use cases so keep checking back.  To learan about advanced options (and many other things) go to the [Advanced User's Guide].
 
 ### Feedback welcome!
 
-We are quite interested to improve the content of this guide. Feel free to provide us feedback:
+We are interested in improving the content of this guide. Feel free to provide feedback:
 !email.png! [mailto:users@directory.apache.org](mailto:users@directory.apache.org)
 
 ### Table of contents
@@ -48,7 +46,7 @@ We are quite interested to improve the c
 * [1 - Introduction](user-guide/1-introduction.html)
     *  [1.1 - Java and LDAP](user-guide/1.1-java-and-ldap.html)
     *  [1.2 - LDAP in a few words](user-guide/1.2-ldap-in-a-few-words.html)
-    *  [1.3 - The Apache LDAP API rational](user-guide/1.3-apache-ldap-api-rational.html)
+    *  [1.3 - The Apache LDAP API rationale](user-guide/1.3-apache-ldap-api-rational.html)
     *  [1.4 - Preparation to code](user-guide/1.4-preparation-to-code.html)
 
 * [2 - Basic LDAP API usage (...)](user-guide/2-basic-ldap-api-usage.html)