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