Skip to content

Commit a9a642f

Browse files
authored
Make url field optional for release objects
As discussed in swiftlang/swift-evolution#1319 (comment)
1 parent 51b2ffd commit a9a642f

File tree

1 file changed

+6
-1
lines changed

1 file changed

+6
-1
lines changed

Documentation/RegistryDraft.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -348,9 +348,14 @@ whose values are objects containing the following fields:
348348

349349
| Key | Type | Description | Requirement Level |
350350
| --------- | ------ | ------------------------------------- | ----------------- |
351-
| `url` | String | The location of the release resource. | REQUIRED |
351+
| `url` | String | The location of the release resource. | OPTIONAL |
352352
| `problem` | Object | A [problem details][RFC 7807] object. | OPTIONAL |
353353

354+
A server MAY specify a URL for a release using the `url` key.
355+
A client SHOULD locate a release using the value of the `url` key, if one is provided.
356+
Otherwise, the client SHOULD locate a release
357+
by expanding the URI Template `/{scope}/{name}/{version}` on the originating host.
358+
354359
A server SHOULD communicate the unavailability of a package release
355360
using a ["problem details"][RFC 7807] object.
356361
A client SHOULD consider any releases with an associated `problem`

0 commit comments

Comments
 (0)