Ticket #10559: 10559.diff

docs/ref/contrib/comments/custom.txt

@@ -63 +63 @@
 In the ``models.py`` we'll define a ``CommentWithTitle`` model::
 
     from django.db import models
-    from django.contrib.comments.models import BaseCommentAbstractModel
+    from django.contrib.comments.models import Comment
 
-    class CommentWithTitle(BaseCommentAbstractModel):
+    class CommentWithTitle(Comment):
         title = models.CharField(max_length=300)
-    
-All custom comment models must subclass :class:`BaseCommentAbstractModel`.
+
+Ideally, most custom comment models could subclass the :class:`Comment`
+model.
+
+If you want to substantially remove or change the fields available in the
+:class:`Comment` model but wouldn't want to rewrite the templates, you
+could try subclassing from :class:`BaseCommentAbstractModel`.
 
 Next, we'll define a custom comment form in ``forms.py``. This is a little more
 tricky: we have to both create a form and override
@@ -177 +182 @@
     Return the URL for the "approve this comment from moderation" view.
 
     The default implementation returns a reverse-resolved URL pointing
-    to the :func:`django.contrib.comments.views.moderation.approve` view.
- No newline at end of file
+    to the :func:`django.contrib.comments.views.moderation.approve` view.