--- a/README.txt	Wed Nov 03 15:21:59 2010 -0400
+++ b/README.txt	Wed Nov 03 15:36:16 2010 -0400
@@ -1,4 +1,12 @@
-== description of the projects ==
+== what is FeDeRate? ==
+
+FeDeRate provides a SPARQL endpoint over the Direct Graph derived from a particular Relational Database.
+
+The SPARQL query is compiled on the fly to a SQL query targetting the RDB schema (so it's as fast as SQL itself).
+
+Please read http://www.w3.org/2001/sw/rdb2rdf/directGraph/ to understand the Direct Graph (this is a work in progress).
+
+== description of the sub-projects ==
 
 FeDeRate is the main project, ruling several sub-projects. The dependencies between them can be found in `project/build/FeDeRate.scala`. Each project has its own directory. Here is a short description of each of them:
 
@@ -7,7 +15,7 @@
 |-- rdb                → the Relational Database model, used to describe the schema and the data (no SQL request at that point)
 |-- sql                → a SQL parser, restricted to CREATE and INSERT statements
 |-- sparql             → the SPARQL 1.0 model + its (almost) complete parser
-|-- directmapping      → the Direct Mapping, as defined in http://www.w3.org/2001/sw/rdb2rdf/directGraph/_
+|-- directmapping      → the Direct Mapping, as defined in http://www.w3.org/2001/sw/rdb2rdf/directGraph/
 |-- sparql2sparql      → SPARQL to SPARQL rewriting, based on SPIN (aka. SPARQL CONSTRUCT)
 |-- sparql2sparql2sql  → SPARQL to SPARQL to SQL rewriting, composing sparql2sparql and sparql2sql
 |-- sparql2sql         → SPARQL to SQL rewriting, targetting the Direct Mapping of a Relational Database