# HG changeset patch
# User Jeff Hammel <jhammel@mozilla.com>
# Date 1274711319 25200
# Node ID 5f492a6fbdd15cbfc5ee4aff48c9b8decce57231
# Parent  1701e5b0b0ebf1d2b1ee75d570357557c46ab449
add note about URL structure

diff -r 1701e5b0b0eb -r 5f492a6fbdd1 taginthemiddle/handlers.py
--- a/taginthemiddle/handlers.py	Wed May 05 22:47:46 2010 -0700
+++ b/taginthemiddle/handlers.py	Mon May 24 07:28:39 2010 -0700
@@ -85,7 +85,21 @@
 
 
 class ViewTags(GenshiHandler):
-    # TODO: RSS
+    """
+    View for tags on a resource;  for app.tags_url == 'tags':
+
+    /<resource>/tags/mozilla :
+    all paths under /<resource> tagged with 'mozilla'
+
+    /<resource>/tags/mozilla+workflow :
+    all paths under /<resource> tagged with 'mozilla' and 'workflow'
+    (or should it be /<resource>/tags/mozilla/workflow , which would be
+    identical to /<resource>/tags/workflow/mozilla ?)
+
+    Also handles RSS:
+    /<resource>/tags/mozilla?format=rss
+    """
+    
     template = 'tags.html'
     methods = set(['GET'])
 
@@ -103,6 +117,7 @@
 
     @classmethod
     def match(cls, app, request):
+
         # check the method
         if request.method not in cls.methods:
             return None