bring /spec into conformance with the finalize v1.0 of the spec, and fix errors