Skip to content

Commit

Permalink
spec: Clarify that DNS-naming and signing have not been specified
Browse files Browse the repository at this point in the history
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>
  • Loading branch information
wking committed Apr 20, 2017
1 parent a82c098 commit d67c709
Showing 1 changed file with 5 additions and 2 deletions.
7 changes: 5 additions & 2 deletions spec.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

0 comments on commit d67c709

Please sign in to comment.