some cube documentation

__pkginfo__.py

@@ -15,10 +15,28 @@ author = "Logilab"
 author_email = "contact@logilab.fr"
 web = 'http://www.cubicweb.org/project/%s' % distname
 
-short_desc = "basket component for the Cubicweb framework"
-long_desc = """This Cubicweb component provides baskets as a way to select content.
+short_desc = "shopping cart component for the CubicWeb framework"
+long_desc = """\
+Summary
+-------
+
+This cube provides a shopping cart functionality.
+
+Usage
+-----
+
+By default, any entity can be added to a basket (this uses the
+`in_basket` relation).
+
+There is a box that displays all items in the basket. By default, this
+box is hidden. To display it, add in a view this code:
+
+.. sourcecode:: python
+
+   from cubes.basket.views import BasketBox
+
+   BasketBox.visible = True
 
-CubicWeb is a semantic web application framework, see http://www.cubicweb.org
 """
 
 classifiers = [