diff --git a/doc/development-guide.rst b/doc/development-guide.rst
index b8970201140d4a6dc99caf829b4408d987d941ce..96518d57f2ea298af0a840246bd0f3d424ac3571 100644
--- a/doc/development-guide.rst
+++ b/doc/development-guide.rst
@@ -36,9 +36,9 @@ which are confusing and difficult to type and remember.
 
 Examples of good, catchy names:
 
-  * ``atnt``: for the AT&T faces database (see ``bob.db.atnt``)
-  * ``iris``: for Fisher's Iris flower dataset (see ``bob.db.iris``)
-  * ``mobio``: for the Mobio biometric database (see ``bob.db.mobio``)
+  * ``atnt``: for the AT&T faces database
+  * ``iris``: for Fisher's Iris flower dataset
+  * ``mobio``: for the Mobio biometric database
 
 Examples of more inappropriate names (avoid these):
 
diff --git a/doc/index.rst b/doc/index.rst
index d60540d6b05c7ab9c3551ed6e7d6480182b8e3d5..66790926f4a17e88fcceae62de210a8c1189b7d7 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -7,6 +7,8 @@
  |project| Database
 ====================
 
+This package is deprecated!!! Please use ``bob.pipelines`` for generic database interfaces instead.
+
 A |project| db package (or *database*) contains a set of interfaces (API) to
 programmatically query and access samples and metadata from raw data (usually)
 stored on disk. Because of the growing number of packages of this nature, we