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.
 
        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
 
        Each comment in the system which support  this protocol MUST  have

-       following proprieties:
+       following proprerties:

 
 2.2.1 Comment text
 
 
 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.
        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
        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.
 
        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.   
         
        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
 
        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.
 
        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
 
 
 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
 
        This page should have content type text/plain and list blog URLs
        one per line
 


@@ -162,7 +166,8 @@ Abstract
        
                timestamp whitespace comment-id
 
        
                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. 
        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
 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. 
        newlines, it should return text/xml data containing specified
        comments using XML schema described in the section 4 of this
        document.