biscuit/apps/exlibris/models.py

@@ -7,6 +7,8 @@ from biscuit.core.mixins import SchoolRelated
 
 
 class Book(SchoolRelated):
+    """A book that is available for borrowing by persons."""
+
     title = models.CharField(verbose_name=_('Book title'), max_length=50)
     author = models.CharField(verbose_name=_(
         'Author name'), max_length=50, blank=True)
@@ -38,6 +40,10 @@ class Book(SchoolRelated):
 
 
 class BookCopy(models.Model):
+    """A single copy of a book. This is the item that will be associated with
+    a person who borrowed it.
+    """
+
     CONDITION_CHOICES = [
         ('U', _('New, unused')),
         ('N', _('New, used')),

docs/ref/01_models.rst

+Models of the Exlibris app
+==========================
+
+.. automodule:: biscuit.app.exlibris.models
+   :members: