--- 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