This document records known errors and clarifications in JSON Activity Streams 1.0.
Abstract Change [2012-02-14]
2. Incorrect Descriptions in Collection Serialization
2.1. totalItems Property
2.2. url Property
§ Author's Address
Clarify the scope of the specification by changing the abstract to read:
Social activity data is important in that it allows individuals to process the latest news of people and things they care about. This specification details the serialization of a stream of social activity data using the JSON format. As this specification only describes that serialization format, the methods used to transmit, receive, or process that data are outside the scope of this specification.
The descriptions for the fields on the Collection Serialization in Section 3.5 are incorrect.
The description for totalItems current says:
"Non-negative integer specifying the total number of activities within the stream. The Stream serialization MAY contain a count property."
It SHOULD say:
"Non-negative integer specifying the total number of objects within the collection. Note that the actual number of objects included within the value of the "items" property MAY be less than the total number of objects specified. The Collection serialization MAY contain a totalItems property"
The description for url currently states:
"An IRI [RFC3987] referencing a JSON document containing the full listing of objects in the collection."
This does not make it clear that the original intent was for the url property on the collection to point to a JSON document whose root object is itself a Collection object. Therefore, this description SHOULD read:
"An IRI [RFC3987] referencing a JSON Document whose root object is a Collection object providing access to the full listing of objects in the collection."
|Activity Streams Working Group