--- a/doc/book/en/B0010-define-schema.en.txt	Wed Apr 01 17:27:15 2009 +0200
+++ b/doc/book/en/B0010-define-schema.en.txt	Wed Apr 01 17:31:20 2009 +0200
@@ -1,10 +1,10 @@
 .. -*- coding: utf-8 -*-
 
-Data model definition (*schema*)
-================================
+Data model definition: the *schema*
+===================================
 
-The schema is the core piece of a `CubicWeb` application as it defines
-the data model handled. It is based on entity types that are either already
+The **schema** is the core piece of a `CubicWeb` application as it defines
+the handled data model. It is based on entity types that are either already
 defined in the `CubicWeb` standard library; or more specific types, that 
 `CubicWeb` expects to find in one or more Python files under the directory 
 `schema`.

--- a/doc/book/en/B0011-schema-stdlib.en.txt	Wed Apr 01 17:27:15 2009 +0200
+++ b/doc/book/en/B0011-schema-stdlib.en.txt	Wed Apr 01 17:31:20 2009 +0200
@@ -10,7 +10,7 @@
 
 System schemas
 ``````````````
-The system entities available are:
+The available system entities are:
 
 * `EUser`, system users
 * `EGroup`, users groups
@@ -34,7 +34,7 @@
 (The first 'E' in some of the names is the first letter of 'Erudi', 
 `CubicWeb`'s old name; it might be changed/removed some day.)
 
-Cubes available
+Available cubes
 ```````````````
 
 An application is based on several basic cubes. In the set of available

--- a/doc/book/en/B0012-schema-definition.en.txt	Wed Apr 01 17:27:15 2009 +0200
+++ b/doc/book/en/B0012-schema-definition.en.txt	Wed Apr 01 17:31:20 2009 +0200
@@ -148,8 +148,8 @@
   not prevent another entity to be selected.
 
 
-Relation definition
--------------------
+Definition of relations
+-----------------------
 
 XXX add note about defining relation type / definition
 
@@ -221,8 +221,8 @@
 Permissions definition
 ``````````````````````
 
-Define permissions is set through to the attribute `permissions` of entities and
-relations types. It defines a dictionnary where the keys are the access types
+Setting permissions is done with the attribute `permissions` of entities and
+relation types. It defines a dictionnary where the keys are the access types
 (action), and the values are the authorized groups or expressions.
 
 For an entity type, the possible actions are `read`, `add`, `update` and
@@ -377,9 +377,9 @@
 Updating your application with your new schema
 ``````````````````````````````````````````````
 
-If you modified your schema, the update is not automatic; this is 
-indeed in general not a good idea.
-Instead, we call a shell on  your application, which is a 
+If you modified your schema, the update is not automatic; indeed, this is 
+in general not a good idea.
+Instead, you call a shell on your application, which is a 
 an interactive python shell, with an appropriate
 cubicweb environment ::