UserPreferences

PaceRemoveWhoWritesWhat


Abstract

Remove Section "8.2.1 Role of Atom Entry Elements During Editing" and related text.

Status

Open

Rationale

There is no need to specify what can or cannot be written by the client. Clients can send what they want to POST/PUT and the server can allow/disallow/alter the entry as it sees fit. Most notably, the prohibition against clients writing atom id is detrimental to any process that moves entries around from one collection to another via the APP.

Proposal

Remove Section "8.2.1 Role of Atom Entry Elements During Editing"

8.2.1  Role of Atom Entry Elements During Editing

   The elements of an Atom Entry Document are either a client writable
   or server controlled.

   Client Writable - An element of an Atom Entry whose value is editable
   by the client.  Servers MAY modify the content of client writable
   elements.  Some reasons that a server may change client writable
   content include length limits, obscenity filters or the addition of
   boilerplate text.

   Server Controlled - An element of an Atom Entry whose value is
   enforced by the server and not editable by the client.  Clients
   SHOULD NOT change the value of server controlled elements.  Servers
   MUST NOT rely on clients preserving the values of server controlled
   elements.

              +--------------------+--------------------+
              | Atom Entry Element |      Property      |
              +--------------------+--------------------+
              |     atom:author    |   Client Writable  |
              |                    |                    |
              |    atom:category   |   Client Writable  |
              |                    |                    |
              |    atom:content    |   Client Writable  |
              |                    |                    |
              |  atom:contributor  |   Client Writable  |
              |                    |                    |
              |       atom:id      |  Server Controlled |
              |                    |                    |
              |      atom:link     |   Client Writable  |
              |                    |                    |
              |   atom:published   |   Client Writable  |
              |                    |                    |
              |     atom:source    |   Client Writable  |
              |                    |                    |
              |    atom:summary    |   Client Writable  |
              |                    |                    |
              |     atom:title     |   Client Writable  |
              |                    |                    |
              |    atom:updated    |  Server Controlled |
              |                    |                    |
              |     app:control    |   Client Writable  |
              +--------------------+--------------------+

Remove the following lines from Section 3

client writable element - An element of an Atom Entry whose value is editable by the client and not enforced by the server.

server-controlled element - An element of an Atom Entry whose value is enforced by the server and not editable by the client.

Impacts

draft06

Notes

see also: ChangingId


CategoryProposals