Bring sanity to the Spec situation

[geoffjentry]

(@kcibul - another Jeff Special)

The status of our spec(s) is super confusing.

There's "Draft 1 (closed)" which predates our team. There's "Draft 2 (open)". There's the master branch. There's the develop branch. The "Draft 2" on master doesn't match what's in develop all the time. There's also only one real implementation of the spec, and it's not even complete.

I recognizing the desire on our past selves' part to be official about everything but we could simplify this a lot by just having a spec that's allowed to change at will until if/when it actually becomes a problem.

[vdauwera]

Oh god yes please

(And if you can break it down into sections rather than a monolithic doc, all the better)

[geoffjentry]

@vdauwera Note the issue over in Cromwell which I tagged you in ;)