--- a/doc/book/en/A02a-create-cube.en.txt	Wed Dec 24 12:36:57 2008 -0800
+++ b/doc/book/en/A02a-create-cube.en.txt	Fri Dec 26 11:37:56 2008 -0800
@@ -10,59 +10,7 @@
 
 This will create in the cubes directory (``/path/to/forest/cubes`` for Mercurial
 installation, ``/usr/share/cubicweb/cubes`` for debian packages installation) 
-a directory named ``blog`` containing::
-
-  blog/
-  |
-  |-- data/
-  |   |-- cubes.blog.css
-  |   |-- cubes.blog.js  
-  |   `-- external_resources
-  |
-  |-- debian/
-  |   |-- changelog
-  |   |-- compat
-  |   |-- control
-  |   |-- copyright
-  |   |-- cubicweb-blog.prerm
-  |   `-- rules
-  |
-  |-- entities.py
-  |
-  |-- i18n/
-  |   |-- en.po
-  |   `-- fr.po
-  |
-  |-- __init__.py
-  |
-  |-- MANIFEST.in
-  |
-  |-- migration/
-  |   |-- postcreate.py
-  |   `-- precreate.py
-  |
-  |-- __pkginfo__.py
-  |
-  |-- schema.py
-  |
-  |-- setup.py
-  |
-  |-- site_cubicweb.py
-  |
-  |-- sobjects.py
-  |
-  |-- test/
-  |   |-- data/
-  |   |   `-- bootstrap_cubes
-  |   |-- pytestconf.py
-  |   |-- realdb_test_blog.py
-  |   `-- test_blog.py
-  |
-  `-- views.py
-
-.. note::
-  You will find a more detailled description of the `cube` concept in
-  :ref:`cubesConcepts`.
+a directory named ``blog`` reflecting the structure described in :ref:`cubesConcepts`.
 
 .. _DefineDataModel:
 

--- a/doc/book/en/A03a-concepts.en.txt	Wed Dec 24 12:36:57 2008 -0800
+++ b/doc/book/en/A03a-concepts.en.txt	Fri Dec 26 11:37:56 2008 -0800
@@ -359,7 +359,7 @@
 
 .. _`CubicWeb Forge`: http://www.cubicweb.org/project/
 
-
+.. _foundationsCube:
 
 Standard structure for a cube
 `````````````````````````````
@@ -370,27 +370,52 @@
   
   mycube/
   |
-  |-- schema.py
-  |
-  |-- entities/
+  |-- data/
+  |   |-- cubes.mycube.css
+  |   |-- cubes.mycube.js  
+  |   `-- external_resources
   |
-  |-- sobjects/
+  |-- debian/
+  |   |-- changelog
+  |   |-- compat
+  |   |-- control
+  |   |-- copyright
+  |   |-- cubicweb-mycube.prerm
+  |   `-- rules
   |
-  |-- views/
-  |
-  |-- test/
+  |-- entities.py
   |
   |-- i18n/
+  |   |-- en.po
+  |   `-- fr.po
   |
-  |-- data/
+  |-- __init__.py
+  |
+  |-- MANIFEST.in
   |
   |-- migration/
-  | |- postcreate.py
-  | \- depends.map
+  |   |-- postcreate.py
+  |   `-- precreate.py
+  |
+  |-- __pkginfo__.py
+  |
+  |-- schema.py
+  |
+  |-- setup.py
+  |
+  |-- site_cubicweb.py
   |
-  |-- debian/
+  |-- sobjects.py
   |
-  \-- __pkginfo__.py
+  |-- test/
+  |   |-- data/
+  |   |   `-- bootstrap_cubes
+  |   |-- pytestconf.py
+  |   |-- realdb_test_mycube.py
+  |   `-- test_mycube.py
+  |
+  `-- views.py
+
     
 We can use simple Python module instead of packages, for example: 
 

--- a/doc/book/en/C012-create-instance.en.txt	Wed Dec 24 12:36:57 2008 -0800
+++ b/doc/book/en/C012-create-instance.en.txt	Fri Dec 26 11:37:56 2008 -0800
@@ -85,7 +85,7 @@
 It is important to distinguish here the user used to access the database and
 the user used to login to the cubicweb application. When a `CubicWeb` application
 starts, it uses the login/psswd for the database to get the schema and handle
-low transaction [FIXME - bas niveau]. But, when ``cubicweb-ctl create`` asks for
+low level transaction. But, when ``cubicweb-ctl create`` asks for
 a manager login/psswd of `CubicWeb`, it refers to an application user you will
 use during the development to administrate your web application. It will be 
 possible, later on, to create others users for your final web application.