document list and item URIs containing unique IDs in them

diff --git a/doc/protocol.md b/doc/protocol.md
index e0cf516c6658b533acb312c1ec5aa69153fc7e58..d70f595f1e14301ad9723c3b1ca6ff0d7d16e1a0 100644 (file)
--- a/doc/protocol.md
+++ b/doc/protocol.md
@@ -15,7 +15,9 @@ GET /list
 Returns a JSON object with the following keys:
 
  - `lists`: a list of objects with the following keys:
-   - `uri`: tjhe list URIs. Referred to as `/list/$list_id` below.
+   - `uri`: the list URI. Referred to as `/list/$list_id` below. The part after
+     the last `/` (`$list_id`) is an integer that is unique among all shopping
+     lists
    - `name`: list name as entered by users
  - `lists_version`: a number that is incremented by 1 each time the list of
    shopping lists changes. Changes include adding, removing and renaming a
@@ -27,7 +29,9 @@ GET /list/$list_id
 Returns a JSON object with the following keys:
 
  - `items`: a list of shopping list item objects with keys:
-   - `uri`: the URI of the individual list item
+   - `uri`: the URI of the individual list item (refered to as
+     `/list/$list_id/$item_id` below. The part after the last `/` (`$list_id`)
+     is a positive integer that is unique amont the items in the shopping list.
    - `description`: item description
    - `done`: a boolean flag marking the item as done
  - `version`: a number that is incremented by 1 each time the list items