Skip to content

Commit 57c3db0

Browse files
mikebrowmikebrow
committed
split out changes
Signed-off-by: Mike Brown <[email protected]>
1 parent 02ec813 commit 57c3db0

File tree

2 files changed

+102
-99
lines changed

2 files changed

+102
-99
lines changed

‎changes.md‎

Lines changed: 101 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,101 @@
1+
# OCI Distribution Specification Changes
2+
3+
This doc should be updated when changes are made to the specification, indicating what is different.
4+
5+
Each set of changes is given a letter corresponding to a set of modifications that were applied to the baseline specification.
6+
These are merely for reference and shouldn't be used outside the specification other than to identify a set of modifications.
7+
8+
<dl>
9+
<dt>l</dt>
10+
<dd>
11+
<ul>
12+
<li>Document TOOMANYREQUESTS error code.</li>
13+
</ul>
14+
</dd>
15+
16+
<dt>k</dt>
17+
<dd>
18+
<ul>
19+
<li>Document use of Accept and Content-Type headers in manifests endpoint.</li>
20+
</ul>
21+
</dd>
22+
23+
<dt>j</dt>
24+
<dd>
25+
<ul>
26+
<li>Add ability to mount blobs across repositories.</li>
27+
</ul>
28+
</dd>
29+
30+
<dt>i</dt>
31+
<dd>
32+
<ul>
33+
<li>Clarified expected behavior response to manifest HEAD request.</li>
34+
</ul>
35+
</dd>
36+
37+
<dt>h</dt>
38+
<dd>
39+
<ul>
40+
<li>All mention of tarsum removed.</li>
41+
</ul>
42+
</dd>
43+
44+
<dt>g</dt>
45+
<dd>
46+
<ul>
47+
<li>Clarify behavior of pagination behavior with unspecified parameters.</li>
48+
</ul>
49+
</dd>
50+
51+
<dt>f</dt>
52+
<dd>
53+
<ul>
54+
<li>Specify the delete API for layers and manifests.</li>
55+
</ul>
56+
</dd>
57+
58+
<dt>e</dt>
59+
<dd>
60+
<ul>
61+
<li>Added support for listing registry contents.</li>
62+
<li>Added pagination to tags API.</li>
63+
<li>Added common approach to support pagination.</li>
64+
</ul>
65+
</dd>
66+
67+
<dt>d</dt>
68+
<dd>
69+
<ul>
70+
<li>Allow repository name components to be one character.</li>
71+
<li>Clarified that single component names are allowed.</li>
72+
</ul>
73+
</dd>
74+
75+
<dt>c</dt>
76+
<dd>
77+
<ul>
78+
<li>Added section covering digest format.</li>
79+
<li>Added more clarification that manifest cannot be deleted by tag.</li>
80+
</ul>
81+
</dd>
82+
83+
<dt>b</dt>
84+
<dd>
85+
<ul>
86+
<li>Added capability of doing streaming upload to PATCH blob upload.</li>
87+
<li>Updated PUT blob upload to no longer take final chunk, now requires entire data or no data.</li>
88+
<li>Removed `416 Requested Range Not Satisfiable` response status from PUT blob upload.</li>
89+
</ul>
90+
</dd>
91+
92+
<dt>a</dt>
93+
<dd>
94+
<ul>
95+
<li>Added support for immutable manifest references in manifest endpoints.</li>
96+
<li>Deleting a manifest by tag has been deprecated.</li>
97+
<li>Specified `Docker-Content-Digest` header for appropriate entities.</li>
98+
<li>Added error code for unsupported operations.</li>
99+
</ul>
100+
</dd>
101+
</dl>

‎spec.md‎

Lines changed: 1 addition & 99 deletions
Original file line numberDiff line numberDiff line change
@@ -132,107 +132,9 @@ If process A and B upload the same layer at the same time, both operations will
132132
The V2 specification has been written to work as a living document, specifying only what is certain and leaving what is not specified open or to future changes.
133133
Only non-conflicting additions should be made to the API and accepted changes should avoid preventing future changes from happening.
134134

135-
This section should be updated when changes are made to the specification, indicating what is different.
135+
The [changes.md](changes.md) doc should be updated when changes are made to the specification, indicating what is different.
136136
Optionally, we may start marking parts of the specification to correspond with the versions enumerated here.
137137

138-
Each set of changes is given a letter corresponding to a set of modifications that were applied to the baseline specification.
139-
These are merely for reference and shouldn't be used outside the specification other than to identify a set of modifications.
140-
141-
<dl>
142-
<dt>l</dt>
143-
<dd>
144-
<ul>
145-
<li>Document TOOMANYREQUESTS error code.</li>
146-
</ul>
147-
</dd>
148-
149-
<dt>k</dt>
150-
<dd>
151-
<ul>
152-
<li>Document use of Accept and Content-Type headers in manifests endpoint.</li>
153-
</ul>
154-
</dd>
155-
156-
<dt>j</dt>
157-
<dd>
158-
<ul>
159-
<li>Add ability to mount blobs across repositories.</li>
160-
</ul>
161-
</dd>
162-
163-
<dt>i</dt>
164-
<dd>
165-
<ul>
166-
<li>Clarified expected behavior response to manifest HEAD request.</li>
167-
</ul>
168-
</dd>
169-
170-
<dt>h</dt>
171-
<dd>
172-
<ul>
173-
<li>All mention of tarsum removed.</li>
174-
</ul>
175-
</dd>
176-
177-
<dt>g</dt>
178-
<dd>
179-
<ul>
180-
<li>Clarify behavior of pagination behavior with unspecified parameters.</li>
181-
</ul>
182-
</dd>
183-
184-
<dt>f</dt>
185-
<dd>
186-
<ul>
187-
<li>Specify the delete API for layers and manifests.</li>
188-
</ul>
189-
</dd>
190-
191-
<dt>e</dt>
192-
<dd>
193-
<ul>
194-
<li>Added support for listing registry contents.</li>
195-
<li>Added pagination to tags API.</li>
196-
<li>Added common approach to support pagination.</li>
197-
</ul>
198-
</dd>
199-
200-
<dt>d</dt>
201-
<dd>
202-
<ul>
203-
<li>Allow repository name components to be one character.</li>
204-
<li>Clarified that single component names are allowed.</li>
205-
</ul>
206-
</dd>
207-
208-
<dt>c</dt>
209-
<dd>
210-
<ul>
211-
<li>Added section covering digest format.</li>
212-
<li>Added more clarification that manifest cannot be deleted by tag.</li>
213-
</ul>
214-
</dd>
215-
216-
<dt>b</dt>
217-
<dd>
218-
<ul>
219-
<li>Added capability of doing streaming upload to PATCH blob upload.</li>
220-
<li>Updated PUT blob upload to no longer take final chunk, now requires entire data or no data.</li>
221-
<li>Removed `416 Requested Range Not Satisfiable` response status from PUT blob upload.</li>
222-
</ul>
223-
</dd>
224-
225-
<dt>a</dt>
226-
<dd>
227-
<ul>
228-
<li>Added support for immutable manifest references in manifest endpoints.</li>
229-
<li>Deleting a manifest by tag has been deprecated.</li>
230-
<li>Specified `Docker-Content-Digest` header for appropriate entities.</li>
231-
<li>Added error code for unsupported operations.</li>
232-
</ul>
233-
</dd>
234-
</dl>
235-
236138
## Overview
237139

238140
This section covers client flows and details of the API endpoints.

0 commit comments

Comments
 (0)