[JBTM-747] track changes to spec
[JBTM-747] Draft 8 of the spec with comments