wufm/osdi-docs — pull request #120 by j-ro (2014-02-28 19:47:22+00:00)
Title: PROPOSAL: Petition action type

We've developed a petition action type to compliment our other action types (like events, for instance), that we want to contribute back as part of the spec.

Petitions follow a lot of the same conventions as events, but they represent petition actions. They have various fields of metadata about themselves (such as the target of the petition) and then they have signature resources to represent each signing transaction, the signer person object, and their comments on signing.

The new fields we'd be proposing are:

target -- an array of hashes representing the target(s) of the petition. Right now, we're only using name in the hash, but open to suggestions for other parts of a target hash that would be useful.

petition_text -- the actual text of the letter to the target, different from the summary and description, which are usually more signer focused (call to action, etc...)

We're also incorporating the proposal we have open in issue #107.