API v2

[augustuswm]

The initial set of endpoints for the RFD API were built to provide backwards compatibility with the CIO-based RFD API. This PR contains breaking changes to evolve the API surface forward.

API (v-api endpoints omitted):

• GET /rfd - List the latest revisions of RFDs. Returns RFD metadata only
• POST /rfd - Reserve a new RFD number
• GET /rfd/{number} - Get the metadata for the latest revision of a RFD
• GET /rfd/{number}/attr/{attr} - Get the value of an attribute for the latest revision of a RFD
• POST /rfd/{number}/attr/{attr} - Set the value of an attribute of a RFD
• GET /rfd/{number}/discussion - Get a list of comments for the latest revision of a RFD
• POST /rfd/{number}/content - Update the body content of a RFD
• GET /rfd/{number}/pdf - Get the latest revision of a RFD along with its pdf representations
• GET /rfd/{number}/raw - Get the latest revision of a RFD along with its raw document contents
• POST /rfd/{number}/raw - Update the full document of a RFD
• GET /rfd/{number}/revision/{revision} - Get the metadata for a specific revision of a RFD
• GET /rfd/{number}/revision/{revision}/attr/{attr} - Get the value of an attribute for a specific revision of a RFD
• GET /rfd/{number}/revision/{revision}/discussion - Get a list of comments for a specific revision of a RFD
• GET /rfd/{number}/revision/{revision}/pdf - Get a specific revision of a RFD along with its pdf representations
• GET /rfd/{number}/revision/{revision}/raw - Get a specific revision of a RFD along with its raw document contents
• POST /rfd/{number}/state/discuss - Transition a RFD to the discussion state
• POST /rfd/{number}/state/publish - Transition a RFD to the published state
• POST /rfd/{number}/visibility - Update the visibility (public / private) of a RFD
• GET /rfd-search - Perform a search of RFDs