Simplify introspection by eliminating Introspection Document and declaring that any IRI that resolves to an XHTML page containing <link rel="collection" /> elements identifies a Workspace.
<html> <head> <title>My Weblog Workspace</title> <link rel="collection" type="application/atomcol+xml" href="http://example.org/blog" title="Blog" /> <link rel="collection" type="application/atomcol+xml" href="http://example.org/photos" title="Photos" /> </head> ... </html>
The existing introspection document mechanism in the -05 draft is way too complicated.
(Replace the existing intro to Section 5 with...) (Why? Because if we're going to introduce the concept of Workspaces, it should be done at the beginning when we introduce Collections)
5. The Atom Publishing Protocol Model
The Atom Publishing Protocol is a subset of HTTP that is used to edit resources on the web. The APP is based on the notion of a Workspace composed of one or more Collections of Web Resources. The patterns of interaction within the APP are based on the common HTTP verbs.
GET is used to retrieve a representation of a resource or perform a read-only query
POST is used to create a new, dynamically-named resource, or to provide a block of data to a data-handling process
PUT is used to update a known resource
DELETE is used to remove a resource.
(Replace the existing Section 6.3 with...)
6.3 Introspecting Workspaces
In order for authoring to commence, a client must first discover the capabilities and locations of collections offered by a Workspace.
Any IRI may reference a Workspace. A client may discover which collections a Workspace offers by performing an HTTP GET operation on the IRI and scanning the response for XHTML link elements using the rel attribute value "collection". Each collection link identifies a distinct collection within the Workspace. The href attribute of the link specifies the IRI of the Collection Document describing the collection.
<link rel="collection" type="application/atomcol+xml" href="http://www.example.com/blog" title="Blog" /> <link rel="collection" type="application/atomcol+xml" href="http://www.example.com/photos" title="Photos" />
(Remove Section 7)