Better docs for GenerateSlugMixin.

diff --git a/mediagoblin/db/mixin.py b/mediagoblin/db/mixin.py
index f2c2932c675aa22f7002e17df6b260a6ecf2002d..0dc3bc851fb8c3b14a36de7c55f9388321fda08a 100644 (file)
--- a/mediagoblin/db/mixin.py
+++ b/mediagoblin/db/mixin.py
@@ -53,9 +53,17 @@ class UserMixin(object):
 
 
 class GenerateSlugMixin(object):
+    """
+    Mixin to add a generate_slug method to objects.
+
+    Depends on:
+     - self.slug
+     - self.title
+     - self.check_slug_used(new_slug)
+    """
     def generate_slug(self):
         """
-        Generate a unique slug for this MediaEntry.
+        Generate a unique slug for this object.
 
         This one does not *force* slugs, but usually it will probably result
         in a niceish one.