Abstract
Add a new element to an 'entry' to declare the state of the entry.
Status
Open
Rationale
When editing an entry via the Atom Publishing Protocol the 'disposition' of the entry needs to be made explicit.
Proposal
Add a new section, before 3.5, that lists all the new additions to the format:
3.X Atom Element Definitions
This specification adds the following elements to an "atom:entry".
Unless stated otherwise these elements SHOULD only be used in the context
of the Atom Publishing Protocol.
3.X.1 "atom:state"
The "atom:state" element represents the state of an individual entry.
This element appears as a child of the atom:entry element. The content
of the element is a string that identifies the state of an entry.
If the "atom:state" element is not present then the state of the entry
must be interpreted as if the "atom:state" element was present and
had a value of "published".
The value of "atom:state" MUST be either a name that is non-empty and does
not contain any colon (":") characters, or a IRI [RFC3987]. Note
that use of a relative reference is not allowed. If a name is given,
implementations MUST consider the state to be equivalent
to the same name registered within the IANA Registry of Entry
States Section 5, and thus the IRI that would be obtained by
appending the value of the "atom:state" element to the string
"http://www.iana.org/assignments/entry-state/". The value of "atom:state"
describes the state of an entry, but does not impose any behavioral
requirements on implementations.
This document defines 2 initial values for the Registry of Link
Relations:
The value "published" signifies that the entry should be published
when it appears in a POST or PUT request body. When appearing in
a GET response it indicates that the entry has been published.
The value "draft" signifies that the entry should not be published
when it appears in a POST or PUT request body. When appearing in
a GET response it indicates that the entry has not been published.
5.1 Registry of Entry States
This registry is maintained by IANA and initially contains two
values: "published" and "draft". New assignments are subject to IESG Approval,
as outlined in [RFC2434]. Requests should be made by email to IANA, which
will then forward the request to the IESG requesting approval.
The request should contain discussion of at least the following five topics:
* A value for the "atom:state" attribute that conforms to the syntax rule
given in Section 3.X.1
* Common name for entry state.
* Description of state semantics.
* Expected display characteristics of an entry with the given state.
* Security considerations.
Impacts
Notes
[JoeGregorio] I really don't care if new elements are allowed or not allowed in a full Atom document, but I do believe we need to explicitly state a policy one way or the other.
I'm also not tied emotionally to the name 'state', it could be 'disposition', 'condition', 'druthers', etc.
How much do we want to pack into this element? For example, do we add 'allow-comments', 'accept-trackbacks', 'sent-notification-email', etc.
See Also: PaceOtherVocabularies
