svn commit: r1776939 - in /directory/site/trunk/content/api/user-guide: 2-basic-ldap-api-usage.mdtext 2.1-connection-disconnection.mdtext 5-ldap-security.mdtext

[sm...@apache.org]

Author: smckinney
Date: Mon Jan  2 14:31:02 2017
New Revision: 1776939

URL: http://svn.apache.org/viewvc?rev=1776939&view=rev
Log:
proofread

Modified:
    directory/site/trunk/content/api/user-guide/2-basic-ldap-api-usage.mdtext
    directory/site/trunk/content/api/user-guide/2.1-connection-disconnection.mdtext
    directory/site/trunk/content/api/user-guide/5-ldap-security.mdtext

Modified: directory/site/trunk/content/api/user-guide/2-basic-ldap-api-usage.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide/2-basic-ldap-api-usage.mdtext?rev=1776939&r1=1776938&r2=1776939&view=diff
==============================================================================
--- directory/site/trunk/content/api/user-guide/2-basic-ldap-api-usage.mdtext (original)
+++ directory/site/trunk/content/api/user-guide/2-basic-ldap-api-usage.mdtext Mon Jan  2 14:31:02 2017
@@ -24,16 +24,16 @@ Notice: Licensed to the Apache Software
 
 # 2 - Basic LDAP API usage (...)
 
-We provide three different set of methods to send requests to the **LDAP** server :
-* A first set which is the simplest, where the methods don't return a response, except the _search_ and _compare_ methods
-* A second set, for advanced users, giving full control to the user
-* A third set allowing the user to send asynchronous requests.
+We provide three different sets of methods to send requests to the **LDAP** server :
+* The first set is the simplest.  Its methods don't return a response, except for the _search_ and _compare_ methods
+* The second set is for advanced users and gives full control to the user
+* The third set allows users to send asynchronous requests.
 
 The first set of methods covers Bind, Add, Delete, Modify, Rename, Move, and Unbind operations
 
 The second set covers MoveAndRename, Compare, Extended, controls.
 
-the third set covers the same methods, but ran in asynchronous mode.
+the third set covers the same methods, but runs in asynchronous mode.
 
 ## Contents
 

Modified: directory/site/trunk/content/api/user-guide/2.1-connection-disconnection.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide/2.1-connection-disconnection.mdtext?rev=1776939&r1=1776938&r2=1776939&view=diff
==============================================================================
--- directory/site/trunk/content/api/user-guide/2.1-connection-disconnection.mdtext (original)
+++ directory/site/trunk/content/api/user-guide/2.1-connection-disconnection.mdtext Mon Jan  2 14:31:02 2017
@@ -24,7 +24,7 @@ Notice: Licensed to the Apache Software
 
 # 2.1 - Connection and disconnection
 
-**LDAP** is a protocol which requires users to be connected - and likely identified (authenticated) - before sending requests to the server. This connection can potentially be maintained forever. What makes the **LDAP** protocol different from, say, the **HTTP** protocol is that the connections are issued explicitly. Here's we'll see how that is done.
+The **LDAP** is a protocol requires users to be connected, and likely identified (authenticated), before sending requests to the server. This connection can potentially be maintained forever. What makes the **LDAP** protocol different from, say, the **HTTP** protocol is that the connections are issued explicitly. Here we'll see how it's done.
 
 ## Opening a connection
 

Modified: directory/site/trunk/content/api/user-guide/5-ldap-security.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide/5-ldap-security.mdtext?rev=1776939&r1=1776938&r2=1776939&view=diff
==============================================================================
--- directory/site/trunk/content/api/user-guide/5-ldap-security.mdtext (original)
+++ directory/site/trunk/content/api/user-guide/5-ldap-security.mdtext Mon Jan  2 14:31:02 2017
@@ -24,20 +24,20 @@ Notice: Licensed to the Apache Software
 
 # 5 - LDAP Security
 
-LDAP stores critical informations, and that needs to be secured. The Apache LDAP API provides a way to access those data, there is little we can do to protect the access to those data, but we can at least make it impossible for a third party to capture the transiting data.
+LDAP databases store critical information that must be kept secure and the Apache LDAP API can be used to access it a secure way while in flight.  It can't protect the data while at rest -- that's for the database system itself to do.
 
-Generally speaking when it comes to securing a system, we are addressing the three **A**s :
+Generally speaking when it comes to securing a system, we are addressing the three **A**s:
 * Authentication
 * Authorization
 * Auditing
 
-The only aspect we will focus on is the **Authentication** part, because the **LDAP** protocol does not address the two other aspects, when it comes to an **API**. We will shortly talk about authorization in the last chapter.
+The only aspect we will focus on is the **Authentication** part, because the **LDAP** protocol does not address the other two, when it comes to an **API**. We will talk about authorization a little bit in the last chapter.
 
-An additional aspect is encryption :
+Another aspect of security is encryption:
 - securing the communication between the client and the server
 - password hash
 
-Last, not least, we have seen that we can bind on a **LDAP** server using a name and a password, but there are other ways to bind, using **SASL**. We will also explain how to use certificates in SSL/StartTLS.
+Last, but not least, we have seen how to perform a simple bind to an **LDAP** server using a name and a password.  There are other ways to bind, using **SASL**. We will also explain how to use certificates in SSL/StartTLS.
 
 ## Contents