Opened 7 years ago

Closed 6 years ago

Last modified 5 years ago

#9819 closed (fixed)

Comments Framework needs better documentation

Reported by: kegan Owned by: nobody
Component: contrib.comments Version: master
Severity: Keywords:
Cc: hanne.moa@… Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: UI/UX:

Description

Comments Framework needs better documentation.

A lot of the features in the code that are not reflected in the documentation. This ticket should provide documentation for:

  • settings.py configuration
  • deletion
  • flagging
  • moderation/approval
  • feeds
  • customizing forms
  • using comments
  • using views
  • comment custom manager

Attachments (2)

comment-settings.diff (853 bytes) - added by kegan 7 years ago.
Tiny patch for comments settings
9819.diff (7.5 KB) - added by thejaswi_puthraya 6 years ago.
git-patch against the latest checkout

Download all attachments as: .zip

Change History (10)

Changed 7 years ago by kegan

Tiny patch for comments settings

comment:1 Changed 7 years ago by kegan

  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset

More patches to come.

comment:2 Changed 6 years ago by jacob

  • Triage Stage changed from Unreviewed to Accepted

comment:3 Changed 6 years ago by martin.hviid.andersen@…

It doesn't either state in the documentation, that it depends on 'django.contrib.sites', which I think is rather important for new users of Django.

comment:4 Changed 6 years ago by HM

  • Cc hanne.moa@… added

We could use this ticket to collect other tickets about missing docs for comments, here's my current pet peeve: #11870

comment:5 Changed 6 years ago by thejaswi_puthraya

See also #9604 which is a subset of this ticket.

Changed 6 years ago by thejaswi_puthraya

git-patch against the latest checkout

comment:6 Changed 6 years ago by thejaswi_puthraya

  • Has patch set

The patch covers usage of comments and through this highlights certain
undocumented functionality. It intentionally leaves out certain features
like profanity filtering, group moderation because these are scheduled
to be removed in future versions.

comment:7 Changed 6 years ago by jezdez

  • Resolution set to fixed
  • Status changed from new to closed

(In [12079]) Fixed #9819 - Added exemplary documentation for comments app. Thanks for the initial patch, Thejaswi Puthraya.

comment:8 Changed 5 years ago by jezdez

(In [12245]) [1.1.X] Fixed #9819 - Added exemplary documentation for comments app. Thanks for the initial patch, Thejaswi Puthraya.

Note: See TracTickets for help on using tickets.
Back to Top