Skip to content

CR publication workflow

Denis Ah-Kang edited this page Jul 3, 2018 · 15 revisions

Starting July 2, 2018, Echidna is able to publish Candidate Recommendations. This page describes the different requirements you need to fulfill before submitting your CR to Echidna.

Types of Candidate Recommendations

Echidna can publish:

  • "ordinary" CR (coming from a WD)
  • CR update with substantive changes
  • CR update with editorial changes only

The first two cases require the Director's and Communication team's approval and will also trigger a new Call for Exclusion. If you just publish a CR update with editorial changes only, you don't need the approvals and can submit your document to Echidna directly.

CR publication workflow

Request a transition request

The transition requests are now managed at https://github.com/w3c/transitions. The README.md of that repository offers templates to create pre-filled issues for new transition requests. The director will then make some comments and ultimately approve the request with the following comment 'Transition approved.'.

Note: it's important that the title of the issue ends with the shortname of your specification. That's how Echidna will find the right issue when processing your request.

Draft announcement to the members

Once the transition is approved, you will need to send the draft transition to [email protected]. After a careful review of the draft, the Communication team will approve it by commenting on the GitHub issue 'Draft transition approved.'.

Request to Echidna

After you get all the necessary approvals, you can submit your document to Echidna as described in the wiki. When updating a CR, Echidna will assume it contains substantive changes by default. If you are only adding editorial changes, you can skip the transition/draft announcement steps by adding the following parameter editorial=true to your request, e.g.

curl 'https://labs.w3.org/echidna/api/request' --data 'url=<documentUrl>&decision=<decisionUrl>&token=<token>&editorial=true'