doc/spec: add first go of the spec