diff --git a/docs/db-api.txt b/docs/db-api.txt
index 8a02437aaa..b80d4e8647 100644
--- a/docs/db-api.txt
+++ b/docs/db-api.txt
@@ -449,8 +449,7 @@ Related objects (e.g. ``Choices``) are created using convenience functions::
     >>> p.get_choice_count()
     4
 
-Each of those ``add_choice`` methods is equivalent to (except obviously much
-simpler than)::
+Each of those ``add_choice`` methods is equivalent to (but much simpler than)::
 
     >>> c = polls.Choice(poll_id=p.id, choice="Over easy", votes=0)
     >>> c.save()
@@ -459,6 +458,8 @@ Note that when using the `add_foo()`` methods, you do not give any value
 for the ``id`` field, nor do you give a value for the field that stores
 the relation (``poll_id`` in this case).
 
+The ``add_FOO()`` method always returns the newly created object.
+
 Deleting objects
 ================