Add registration process.#78
Conversation
| To register an entry in the range <b>256-65,535</b>, a mature specification or standard document | ||
| must be provided alongside the request. These requests will undergo expert review before allocation. |
There was a problem hiding this comment.
We might want to say that the spec/standard must be with an SDO -- or something similar. I think it would be challenging (for reviewers) to determine whether any "spec" document is otherwise "mature" or stable, etc. This could, for example, be based on similar rules that W3C uses today for normative references.
| <b>256-65,535</b>: Specification required | ||
| </li> | ||
| <li> | ||
| <b>65,536+</b>: First come, first serve |
There was a problem hiding this comment.
| <b>65,536+</b>: First come, first serve | |
| <b>65,536+</b>: First come, first served | |
| <p> | ||
| To register an entry, follow the instructions in <a href="https://github.com/json-ld/cborld-registry">the README</a>. The registry is owned by the W3C JSON-LD Community Group. | ||
| Registration requests must be in the form of pull requests raised against the CBOR-LD Registry | ||
| from a fork of the repository. These requests must include: |
There was a problem hiding this comment.
| from a fork of the repository. These requests must include: | |
| via a fork of the repository. These requests must include: | |
| The use case for the registry entry, | ||
| </li> | ||
| <li> | ||
| A .yml file added to the `tables` directory, with the Registry Entry ID requested as the filename, |
There was a problem hiding this comment.
| A .yml file added to the `tables` directory, with the Registry Entry ID requested as the filename, | |
| A `.yml` file added to the `tables` directory, with the Registry Entry ID requested as the filename, | |
| </p> | ||
| <p> | ||
| Reasonable and conformant registration requests for ID <b>65,536</b> or higher will be merged by | ||
| the registry repository maintainers on a first-come-first-serve basis without additional review. |
There was a problem hiding this comment.
| the registry repository maintainers on a first-come-first-serve basis without additional review. | |
| the registry repository maintainers on a "first-come, first-served" basis, without additional review. | |
|
A minor, editorial comment: 65,535 (and other) numbers use the US approach to separate the thousands. It is not the same in other languages and/or countries (for the fun, you can look at the wikipedia page). I realize W3C standards use American English, but numbers are sometimes more difficult to "switch" for a reader. All this to say that may be probably better to write 65535. |
|
Some questions that we may want to discuss:
|
|
Guidelines for non-W3C normative references: |
|
Also note https://www.w3.org/guide/tools/ |
Maintainers of the various JSON-LD specifications are responsible for this, with W3C staff as backup. We will move the other questions into a separate issue for tracking and to unblock this PR. |
This PR adds a description of the registration process for requesting registry entries.
Fixes #46.
Preview | Diff