--- a/doc/book/en/development/vreg.rst	Fri Apr 16 11:13:46 2010 +0200
+++ b/doc/book/en/development/vreg.rst	Fri Apr 16 12:32:52 2010 +0200
@@ -1,16 +1,16 @@
 The VRegistry, selectors and application objects
 ================================================
 
-This chapter talk about core concepts of the |cubicweb| framework, that make it
-different from other framework (and probably not easy to grasp at a first
-glance). You won't be able to do advanced development with |cubicweb| without
-a good understanding of what's explain below.
+This chapter talks about core concepts of the |cubicweb| framework,
+that make it different from other frameworks (and maybe not easy to
+grasp at a first glance). To be able to do advanced development with
+|cubicweb| you need a good understanding of what is explained below.
 
-This chapter goes deep into details. You don't have to remember them all but keep
-it in mind so you can go back there later...
+This chapter goes deep into details. You don't have to remember them
+all but keep it in mind so you can go back there later.
 
-.. toctree::
-   :maxdepth: 1
+An overview of AppObjects, the VRegistry and Selectors is given in the
+:ref:`VRegistryIntro` chapter.
 
 .. autodocstring:: cubicweb.cwvreg
 .. autodocstring:: cubicweb.selectors
@@ -105,6 +105,3 @@
 
 You'll also find some other (very) specific selectors hidden in other modules
 than :mod:`cubicweb.selectors`.
-
-
-.. |cubicweb| replace:: *CubicWeb*