update api docs (omissions, wording, typos)

pandora/archive/views.py

@@ -341,7 +341,7 @@ def direct_upload(request):
 @login_required_json
 def taskStatus(request, data):
     '''
-    Gets the status for a task
+    Gets the status for a given task
     takes {
         taskId: string // taskId
     }

pandora/document/views.py

@@ -247,7 +247,7 @@ actions.register(removeDocument, cache=False)
 @login_required_json
 def sortDocuments(request, data):
     '''
-    Sets the sort order for the documents related to a given item
+    Sets the sort order for the documents associated with a given item
     takes {
         item: string, // item id
         ids: [string] // ordered list of document ids

pandora/edit/views.py

@@ -200,7 +200,7 @@ def _order_clips(edit, sort):
 
 def sortClips(request, data):
     '''
-    Updates sort order of clips within an edit
+    Updates the sort order of clips within an edit
     takes {
         edit: string, // edit id
         sort: object // sort
@@ -480,6 +480,7 @@ actions.register(unsubscribeFromEdit, cache=False)
 @login_required_json
 def sortEdits(request, data):
     '''
+    Sets the order of edits in a given section
     takes {
         section: string, // 'personal', 'favorite' or 'featured'
         ids: [string] // ordered list of edit ids

pandora/itemlist/views.py

@@ -192,7 +192,7 @@ actions.register(removeListItems, cache=False)
 @login_required_json
 def orderListItems(request, data):
     '''
-    Sets the manual orderings of items in a given list
+    Sets the manual ordering of items in a given list
     takes {
        list: string, // list id
        ids: [string] // ordered list of item ids

pandora/text/views.py

@@ -311,7 +311,7 @@ actions.register(unsubscribeFromText, cache=False)
 @login_required_json
 def sortTexts(request, data):
     '''
-    Sets manual ordering of texts in a given folder
+    Sets the order of texts in a given section
     takes {
         section: string, // 'personal', 'favorite' or 'featured'
         ids: [string] // ordered list of text ids

pandora/tv/views.py

@@ -11,7 +11,7 @@ from ox.django.api import actions
 
 def tv(request, data):
     '''
-    Gets TV program for a given list
+    Gets the current TV program for a given list
     takes {
         list: string // list name
     }

pandora/user/views.py

@@ -213,7 +213,7 @@ actions.register(signup, cache=False)
 
 def resetPassword(request, data):
     '''
-    Resets password for a given user
+    Resets the password for a given user
     takes {
         username: string, // username
         password: string, // password