doc/book/en/tutorials/base/index.rst
branchstable
changeset 6835 87e2641d75f7
parent 5262 ebd90d2a5639
child 6837 7562418985ef
--- a/doc/book/en/tutorials/base/index.rst	Mon Jan 17 12:42:27 2011 +0100
+++ b/doc/book/en/tutorials/base/index.rst	Mon Jan 17 12:43:07 2011 +0100
@@ -1,30 +1,48 @@
 .. -*- coding: utf-8 -*-
 
-.. _Tutorial:
-
-.. _tuto_blog:
+.. _TutosBase:
 
-Building a simple blog
-======================
+Building a simple blog with |cubicweb|
+======================================
 
-*CubicWeb* is a semantic web application framework that favors reuse and
+|cubicweb| is a semantic web application framework that favors reuse and
 object-oriented design.
 
-A `cube` is a component that includes a model defining the data types and a set of
-views to display the data. A cube can be built by assembling other cubes.
+
+This tutorial is designed to help in your very first steps to start with
+|cubicweb|. We will glance through basic concepts such as:
 
-An `instance` is a specific installation of a cube and includes configuration
-files.
+* having an application running by using existing components
+* discovering the default user interface
+* basically extending and customizing the look and feel of that application
+
+More advanced concepts will covered in :ref:`advanced_tutorial`.
 
 
-This tutorial will show how to create a `cube` and how to use it as an
-application to run an `instance`.
+.. _TutosBaseVocab:
+
+Some vocabulary
+---------------
+
+|cubicweb| comes with a few words of vocabulary that you should know to
+understand what we're talking about. To follow this tutorial, you should at least
+know that:
+
+* a `cube` is a component that usually includes a model defining some data types
+  and a set of views to display them. A cube can be built by assembling other
+  cubes;
+
+* an `instance` is a specific installation of one more more cubes and includes
+  configuration files, a web server and a database.
+
+Reading :ref:`Concepts` for more vocabulary will be a must do at some point.
+
+Now, let's start the hot stuff!
 
 .. toctree::
    :maxdepth: 2
 
    blog-in-five-minutes
-   create-cube
-   components
-   maintemplate
+   discovering-the-ui
+   customizing-the-application
    conclusion