From: Victor Wagner Date: Mon, 24 Mar 2008 09:15:33 +0000 (+0000) Subject: Some clarifications from LJ discussion X-Git-Url: http://wagner.pp.ru/gitweb/?a=commitdiff_plain;h=72f28e20daf17094faf0ff40a35c0a458a94902e;p=oss%2Fstilllife.git Some clarifications from LJ discussion --- diff --git a/doc/distributed-comments.txt b/doc/distributed-comments.txt index 0d59c74..56ce9a0 100644 --- 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.