Abstract
Make list-template optional in order to support POST-only collections.
The pace also seeks to address apparent spec errors in the existing description of how members of a collection are listed.
Status
Withdrawn. Replaced by PaceReworkProtocolModel, PaceReworkCollectionMembership and PaceReworkCollectionListing
Rationale
There is no obvious reason to require that ALL Collections provide an Atom Feed listing collection membership
Proposal
Section 5.4
-
Change: "To enumerate the members of a collection the client sends a GET to its IRI. This IRI is constructed from information in the introspection document."
To: "To enumerate the members of a collection, the client sends a GET to an IRI constructed from information provided by the introspection document."
Section 7.3.3
-
Change: appCollection =
-
element app:collection {
-
appCommonAttributes,
attribute title { text }, attribute href { text }, ( appMemberType
-
& appListTemplate
& extensionElement* )
-
element app:collection {
-
appCommonAttributes,
attribute title { text }, attribute href { text }, ( appMemberType
-
& appListTemplate?
& extensionElement* )
Section 7.3.5:
-
Change: "The app:collection element MUST contain one 'app:list-template' elements"
To: "The app:collection element MAY contain one 'app:list-template' element"
Section 9
-
Change: "Collections, as identified in an Introspection Document, are resources that MUST provide representations in the form of Atom Feed documents"
To: "Collections, as identified in an Introspection Document, MAY provide a list-template that, after being processed to produce an IRI and dereferenced, provides a listing of collection membership in the form of an Atom Feed Document."
Change: "For this reason, Introspection documents refer to collections not with IRIs but with IRI Templates"
To: "For this reason, Introspection documents refer to listing of collection membership not with IRIs but with IRI Templates"
Change: "To produce an IRI that can be used to retrieve part or all of the collection"
To: "To produce an IRI that can be used to retrieve a partial or full listing of collection membership"