Update to-do and interface documentation

svn path=/plone.app.discussion/trunk/; revision=27013

plone/app/discussion/TODO.txt

@@ -7,11 +7,6 @@ plone.app.discussion to-do
 
  [ ] ++comments++ namespace traversal adapter
 
- [ ] Acquisition wrapping - should it happen on:
- 
-    - Conversation retrieval methods (get, __getitem__, values etc)?
-    - IConversation adapter lookup?
-
  [ ] Implement plone.indexer indexers for comments, filling standard metadata
     
     - Note discrepancy between Python datetime and indexing expecting a Zope 2
@@ -23,11 +18,25 @@ plone.app.discussion to-do
     - Number of comments
     - Date/time of most recent comment
     
-    Needs to reindex when comment is added/removed (IContainerModifiedEvent)
+    These have to be reindexed when comment is added/removed 
+    (IContainerModifiedEvent). They also need to be set up in catalog.xml.
  
  [ ] Add tests for conversation dict API
  [ ] Add tests for IReplies adapters
 
+ [ ] Add UI
+ 
+    - comment display should be a viewlet overriding the standard comments
+        viewlet
+        
+    - comment forms should use z3c.form subforms and plone.z3cform's
+        ExtensibleForm support
+ 
+ [ ] Add control panel
+ 
+    - install plone.registry records using registry.xml
+    - create control panel using helper class in plone.app.registry
+ 
  [ ] Make sure a catalog Clear & Rebuild doesn't lose all comments
 
  [ ] Add BBB support for the existing portal_discussion interface

plone/app/discussion/interfaces.py

@@ -15,13 +15,6 @@ class IDiscussionSettings(Interface):
                                    description=_(u"Use this setting to enable or disable comments globally"),
                                    default=True)
     
-    index_comments = schema.Bool(title=_(u"Index comments"),
-                                 description=_(u"Enable this option to ensure that comments are searchable. "
-                                                "Turning this off may improve performance for sites with large "
-                                                "volumes of comments that do not wish to make them searcahble using "
-                                                "the standard search tools."),
-                                 default=True)
-
 class IConversation(IIterableMapping):
     """A conversation about a content object.
     
@@ -49,16 +42,16 @@ class IConversation(IIterableMapping):
     last_comment_date = schema.Date(title=_(u"Date of the most recent comment"), readonly=True)
     commentators = schema.Set(title=_(u"The set of unique commentators (usernames)"), readonly=True)
     
-    def __delitem__(key):
-        """Delete the comment with the given key. The key is a long id.
-        """
-    
     def addComment(comment):
         """Adds a new comment to the list of comments, and returns the 
         comment id that was assigned. The comment_id property on the comment
         will be set accordingly.
         """
     
+    def __delitem__(key):
+        """Delete the comment with the given key. The key is a long id.
+        """
+    
     def getComments(start=0, size=None):
         """Return a batch of comment objects for rendering. The 'start'
         parameter is the id of the comment from which to start the batch.