Skip to content

Commit 5e0175e

Browse files
committed
distribution: Copy-edits for the scope table
There's precendent in the scope table for "Not currently being worked" (the "Creating Reference spec for optional DNS based naming & distribution" entry [1]), but "Work not yet started" (from the "Archival Format" entry [1]) is a more complete fragment. The "...provide a standardized way to use DNS..." line is part of the "Creating a reference spec for optional DNS based naming and discovery" entry, so I'm dropping it from the "Specifying authentication and authorization schemes" entry. I've dropped one of the "parallel" instances for from the parallel-naming/discovery sentence. No need to say that twice in once sentence. [1]: https://www.opencontainers.org/about/oci-scope-table Signed-off-by: W. Trevor King <[email protected]>
1 parent 6587fa0 commit 5e0175e

File tree

1 file changed

+5
-6
lines changed

1 file changed

+5
-6
lines changed

proposals/distribution.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -85,19 +85,18 @@ The following entries should be added to the [scope table][scope]:
8585
* In/Out/Future: Out of scope
8686
* Status: N/A
8787
* Description: Defining protocols for authenticating and authorizing distribution access.
88-
* Why: As a HTTP-based protocol, clients and servers can negotiate authentication via HTTP's [challenge-response authentication framework][rfc7235-s2.1].
88+
* Why: As an HTTP-based protocol, clients and servers can negotiate authentication via HTTP's [challenge-response authentication framework][rfc7235-s2.1].
8989
There is no need for the distribution specification to choose a particular authentication scheme, because clients receiving 401 and 407 responses can use IANA's [HTTP Authentication Scheme Registry][iana-auth] to look up referenced schemes and take appropriate action.
90-
It is reasonable to provide a standardized way to use DNS based distribution in conjunction with OCI without requiring its use.
9190

9291
* “Creating a reference spec for optional DNS based naming and discovery”.
9392
Discovery and registry protocols are completely separate and do not need to be added together.
9493
This entry replaces part of the previous “Creating Reference spec for optional DNS based naming & distribution” entry.
9594

9695
* What: Creating a reference spec for optional DNS based naming and discovery
9796
* In/Out/Future: In scope for future specification
98-
* Status: Not currently being worked
97+
* Status: Work not yet started
9998
* Description: Define a protocol for resolving an image name to retrieval information.
100-
When we address this, we will also allow for alternative, parallel name-to-image discovery protocols in parallel with the OCI-specified protocol.
99+
When we address this, we will also allow for alternative name-to-image discovery protocols in parallel with the OCI-specified protocol.
101100
* Why: It is reasonable to provide a standardized way to use DNS based distribution in conjunction with OCI without requiring its use.
102101
There are many good use cases for DNS based distribution, but not all use cases support this.
103102
Furthermore, encoding the location of a bundle into the bundle can cause issues with downloads from alternate locations other than the origin specified in the name.
@@ -123,13 +122,13 @@ The following entries should be added to the [scope table][scope]:
123122

124123
* “Retrieving images by their content-addressable hash”.
125124
Docker's registery API already provides endpoints for fetching manifest objects by digest][get-manifest].
126-
Docker's registery API does not currently provides endpoints for fetching image objects by digest, but this is the project where that will happen.
125+
Docker's registery API does not currently provide endpoints for fetching image objects by digest, but this is the project where that will happen.
127126

128127
* What: Retrieving images by their content-addressable hash
129128
* In/Out/Future: In scope
130129
* Status: In progress (see opencontainers/distribution-spec)
131130
* Description: Specify a protocol for retrieving an image from a distribution engine by the image's content-addressable hash.
132-
* Why: Using a hash as a name is a way to ensure a unique image name without relying on a particular naming authority/or system.
131+
* Why: Using a hash as a name is a way to ensure a unique image name without relying on a particular naming authority or system.
133132
Using hashing for name is an acceptable addition as it does not encode any centralized namespace.
134133

135134
The following entries should remain in the [scope table][scope] but not be addressed by this project:

0 commit comments

Comments
 (0)