From acee02f3685d0d80dbfe281fed06728662af6b76 Mon Sep 17 00:00:00 2001
From: rolux <rolux@rolux.org>
Date: Tue, 18 Nov 2014 15:45:41 +0000
Subject: [PATCH] update api docs

---
 pandora/annotation/views.py | 22 +++++++++++-----------
 pandora/item/views.py       |  2 +-
 2 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/pandora/annotation/views.py b/pandora/annotation/views.py
index a9b20974d..8f47c290c 100644
--- a/pandora/annotation/views.py
+++ b/pandora/annotation/views.py
@@ -138,14 +138,14 @@ def addAnnotation(request, data):
     '''
     Adds a single annotation
     takes {
-        item: string, (item id)
-        layer: string, (annotation layer id)
-        in: float,
-        out: float,
-        value: string
+        item: string, // item id
+        layer: string, // annotation layer id
+        in: float, // in point in seconds
+        out: float, // out point in seconds
+        value: string // annotation value
     }
     returns {
-        id: string, (annotation id)
+        id: string, // annotation id
         ...
     }
     '''
@@ -179,13 +179,13 @@ def addAnnotations(request, data):
     '''
     Adds multiple annotations
     takes {
-        item: string (item id),
-        layer: string (annotation layer id), 
+        item: string, // item id
+        layer: string, // annotation layer id
         annotations: [
             {
-                in: float,
-                out: float,
-                value: string
+                in: float, // in point in seconds
+                out: float, // out point in seconds
+                value: string // annotation value
             },
             ...
         ]
diff --git a/pandora/item/views.py b/pandora/item/views.py
index e6a8173d0..3275b433f 100644
--- a/pandora/item/views.py
+++ b/pandora/item/views.py
@@ -499,7 +499,7 @@ def add(request, data):
     '''
     Adds a new item (without video)
     takes {
-        title: string (optional)
+        title: string, // optional
     }
     returns {
         id: string,