spec: Clarify that DNS-naming and signing have not been specified

wking · wking · commit d67c70954841 · 2017-04-20T07:18:02.000-07:00
We don't have these yet. I'd rather remove them, because: * We already track roadmap issues in the README [1] (which is not part of the spec itself). * We also have issue-labels for these features [2,3]. * We have entries in the scope table for these features [4]. * We can recover the current wording from version control if/when we land spec sections to back them. But at least three maintainers are in favor of keeping a note of some sort [5,6,7], and the only direct response to my desire to move the references to the existing roadmap section was: On Thu, Apr 20, 2017 at 04:09:32AM -0700, Jonathan Boulle wrote [8]: > Since the roadmap to 1.0 doesn't reference these, please just add > work-not-yet-started here in this list. I still don't see why that section needs to be 1.0-specific, especially since the only accurate part of the current roadmap body is the link to milestones which are not 1.0-specific. But I've already made the arguments I can think of, and for whatever reason the maintainers aren't convinced. [1]: https://github.com/opencontainers/image-spec/blob/v1.0.0-rc5/README.md#roadmap [2]: https://github.com/opencontainers/image-spec/labels/component%2Fnaming%20spec [3]: https://github.com/opencontainers/image-spec/labels/component%2Fsigning%20spec [4]: https://www.opencontainers.org/about/oci-scope-table [5]: #643 (comment) [6]: #643 (comment) [7]: #643 (comment) [8]: #643 (comment) Signed-off-by: W. Trevor King <wking@tremily.us>
diff --git a/spec.md b/spec.md
@@ -57,8 +57,11 @@ The high-level components of the spec include:
 * [Filesystem Layer](layer.md) - a changeset that describes a container's filesystem
 * [Image Configuration](config.md) - a document determining layer ordering and configuration of the image suitable for translation into a [runtime bundle][runtime-spec]
 * [Descriptor](descriptor.md) - a reference that describes the type, metadata and content address of referenced content
-* Signatures that are based on signing image content address (optional OCI layer)
-* Naming that is federated based on DNS and can be delegated (optional OCI layer)
+
+Future versions of this specification may include the following OPTIONAL features:
+
+* Signatures that are based on signing image content address
+* Naming that is federated based on DNS and can be delegated
 
 [c99-unspecified]: http://www.open-std.org/jtc1/sc22/wg14/www/C99RationaleV5.10.pdf#page=18
 [runtime-spec]: https://github.com/opencontainers/runtime-spec
