UserPreferences

PaceSimplifyIntrospection


Abstract

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>

Status

Proposed

Rationale

The existing introspection document mechanism in the -05 draft is way too complicated.

Proposal

(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.

(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)

Impacts

Notes


CategoryProposals