--- a/doc/book/en/intro/tutorial/blog-in-five-minutes.rst	Fri Dec 18 15:06:55 2009 +0100
+++ b/doc/book/en/intro/tutorial/blog-in-five-minutes.rst	Fri Dec 18 15:07:26 2009 +0100
@@ -17,9 +17,24 @@
 
     cubicweb-ctl start -D myblog
 
-This is it. Your blog is running. Visit http://localhost:8080 and enjoy it!
+The -D option is the debugging mode of cubicweb, removing it will lauch the instance in the background.
+
+Permission
+~~~~~~~~~~
+
+This command assumes that you have root access to the /etc/ path. In order to initialize your instance as a `user` (from scratch), please check your current PYTHONPATH then create the ~/etc/cubicweb.d directory.
+
+Instance parameters
+~~~~~~~~~~~~~~~~~~~
 
-As a developer, you'll want to know more about developing new cubes and
-customizing the look of your instance. This is what the next section is about.
+If the database installation failed, you'd like to change some instance parameters, for example, the database host or the user name. These informations can be edited in the `source` file located in the /etc/cubicweb.d/myblog directory.
+
+Then relaunch the database creation:
+
+     cubicweb-ctl db-create myblog
+
+Other paramaters, like web server or emails parameters, can be modified in the `all-in-one.conf` file.
+
+This is it. Your blog is running. Visit http://localhost:8080 and enjoy it! This blog is fully functionnal. The next section section will present the way to develop new cubes and customizing the look of your instance.
 
 

--- a/doc/book/en/intro/tutorial/create-cube.rst	Fri Dec 18 15:06:55 2009 +0100
+++ b/doc/book/en/intro/tutorial/create-cube.rst	Fri Dec 18 15:07:26 2009 +0100
@@ -28,6 +28,8 @@
 
 ::
 
+  from yams.buildobjs import EntityType, String, SubjectRelation, Date
+
   class Blog(EntityType):
     title = String(maxsize=50, required=True)
     description = String()
@@ -38,6 +40,8 @@
     content = String(required=True, fulltextindexed=True)
     entry_of = SubjectRelation('Blog', cardinality='?*')
 
+The first step is the import of the EntityType (generic class for entityà and 
+attributes that will be used in both Blog and BlogEntry entities. 
 
 A Blog has a title and a description. The title is a string that is
 required and must be less than 50 characters.  The
@@ -64,8 +68,8 @@
 
   cubicweb-ctl create blog blogdemo
 
+This command will create the corresponding database and initialize it.
 
-This command will create the corresponding database and initialize it.
 
 Welcome to your web instance
 -------------------------------