Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Expand analysis of "Custom Registry Mechanism Registries" #1150

Merged
merged 10 commits into from
Nov 23, 2023

Conversation

JKRhb
Copy link
Member

@JKRhb JKRhb commented Oct 25, 2023

Will resolve #1144 -- currently still WIP.

@JKRhb JKRhb force-pushed the extend-custom-registry-analysis branch from 7b0c65f to 811fd27 Compare November 15, 2023 16:08
@JKRhb JKRhb marked this pull request as ready for review November 15, 2023 16:08
@JKRhb
Copy link
Member Author

JKRhb commented Nov 15, 2023

The PR should now be ready for review :) Let me know if something is unclear or missing.

@egekorkan
Copy link
Contributor

Call of 15.11:

  • We can add whether the registry is still active or not, also the creation date is interesting.
  • It would be better to specify how versioning happens (modification request is not clear). Do they submit a new document or is something modified in place while incrementing the version.
  • It would be nice to have 1-2 words about the category of the mechanism, e.g. "Submission Mechanism". @JKRhb will also evaluate having a table to easily compare them.
  • Noting that, deprecation can be useful if a protocol binding has a new version and the old one is tried to be phased out.

Our primary goal is to write a section where we document the mechanisms we want to adopt from other registries and maybe also what we should not do.

Copy link
Contributor

@egekorkan egekorkan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Mostly comments and small changes. Other aspects are mentioned in last week's call


- Each entry consists of MIME type/subtype which is mapped to a publicly available specification for a byte stream format. Furthermore, it has to be specified if a flag for generating timestamps needs to be set with the byte stream format.
- It is recommended that the specification should be available without fees.
- All requirements mentioned in the [Media Source Extensions](https://www.w3.org/TR/media-source/#byte-stream-formats) specification must be fulfilled.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a good point for us, meaning we can specify the requirements of bindings in general in one place and registry requirements point to that.

registry-analysis/Readme.md Outdated Show resolved Hide resolved

The registry, its entries and the modification process are specified as follows:

- Entries are given out on a "first come, first serve" basis
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is interesting for us and did not see this in other mechanisms. This can help with the case that two people try to register two entries (one each) for a certain protocol. E.g. what do we do if another person says "I don't like the CoAP Binding Template, here is mine which has other design decisions and thus not a direct improvement of the existing document"

registry-analysis/Readme.md Outdated Show resolved Hide resolved
registry-analysis/Readme.md Outdated Show resolved Hide resolved
@JKRhb
Copy link
Member Author

JKRhb commented Nov 22, 2023

In the latest commits, I tried to separate the bullet points into the categories "Entry Format", "Submission Process", and "Modification Process", hope that addresses the discussion we had at last week's meeting :)

@egekorkan
Copy link
Contributor

@JKRhb will fill in the status and creation information. We will merge it asynchronously after those additions.

@egekorkan
Copy link
Contributor

Status and creation date are added, merging

@egekorkan egekorkan merged commit 38ffb0d into w3c:main Nov 23, 2023
@JKRhb JKRhb deleted the extend-custom-registry-analysis branch November 23, 2023 20:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Extending W3C Custom Registry Analysis
3 participants