Some clarifications from LJ discussion

diff --git a/doc/distributed-comments.txt b/doc/distributed-comments.txt
index 0d59c7441b859c2266796bd6f6a4c498ddd8b635..56ce9a0542ccde5fe643fd94204606bd346cb8f9 100644 (file)
--- a/doc/distributed-comments.txt
+++ b/doc/distributed-comments.txt
@@ -76,10 +76,10 @@ Abstract
        Piece of textual information associated with some post in the
        particular blog and, may be with another comment to the same post.
 
-2.2 Required comment proprieties
+2.2 Required comment properties
 
        Each comment in the system which support  this protocol MUST  have
-       following proprieties:
+       following proprerties:
 
 2.2.1 Comment text
 
@@ -120,7 +120,7 @@ Abstract
        of this user to other sites.  
 
        Sites participating in this protocol MAY allow anonymous comments.
-       If comment is anonymous, Author propriety MUST be omitted from
+       If comment is anonymous, Author property MUST be omitted from
        this comment.
 
 2.2.7 Modification time
@@ -129,7 +129,8 @@ Abstract
        additional timestamp specifying last change date. Servers conforming
        to this  protocol SHOULD allow comment author to change comments.
 
-       There is one special case - deletion of comments. Owner of blog,
+       There is one special case - deletion of comments. Either comment
+       author or owner of blog,
        i.e. user with same identity as blog url SHOULD be able to delete
        any comments in his blog.   
         
@@ -137,7 +138,7 @@ Abstract
 
        If site allows to comment on another comment in the blog entry, not
        only blog entry itself, unique identificator of parent comment
-       SHOULD be recorded as comment propriety. If this propriety is
+       SHOULD be recorded as comment property. If this proprerty is
        absent, any server, recieving this comment, SHOULD assume that it is
        made on blog entry itself.
 
@@ -150,7 +151,10 @@ Abstract
 
 3.1.1. Blog list
 
-       Page which lists blogs, which can be commented on this site
+       Page which lists blogs, which can be commented on this site.
+       This page lists all blogs either originated on this site or
+       retrieved and cached from other sites.
+
        This page should have content type text/plain and list blog URLs
        one per line
 
@@ -162,7 +166,8 @@ Abstract
        
                timestamp whitespace comment-id
 
-       one per line.
+       one per line, where timestamp is an integer number of seconds since
+       Unix epoch (1-1-1970 00:00 GMT).
        If this URL is requested with skip=number parameter (i.e. appended
        with question mark, workd skip equal sign and number), it should
        return list of more earlier comments. 
@@ -170,7 +175,8 @@ Abstract
 3.1.3 Comments itself     
        
        If URL described in 3.1.2 is requested via POST method and POST
-       request body consists of list of comment identifiers, separated by
+       request body has content type text/plain and consists of list of 
+       comment identifiers, separated by
        newlines, it should return text/xml data containing specified
        comments using XML schema described in the section 4 of this
        document.