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

Normative or informative definitions #347

Closed
chrisn opened this issue Feb 16, 2024 · 2 comments
Closed

Normative or informative definitions #347

chrisn opened this issue Feb 16, 2024 · 2 comments

Comments

@chrisn
Copy link
Member

chrisn commented Feb 16, 2024

All of the byte stream format specs (such as this one) have ReSpec warnings because they refer to informative definitions in the MSE spec, e.g., "media segment", "initialization segment".

Should we make these definitions normative - e.g., by moving the current section 1.1 Definitions to a new section 2, so it's outside the informative section 1 Introduction? Some of the definitions include normative requirements on implementations.

@tidoust
Copy link
Member

tidoust commented Mar 19, 2024

+1 to make the definitions normative. On top to the byte stream format specs, the MSE spec itself references these informative definitions from within normative sections and algorithms, which isn't ideal either.

chrisn added a commit that referenced this issue Mar 20, 2024
Introduction is non-normative, but the definitions
include normative requirements for implementations,
and are referenced normatively from the MSE Byte
Stream Format Registry entries, and so need to be
normative.

Resolves #347
@chrisn
Copy link
Member Author

chrisn commented Apr 1, 2024

Resolved in #352

@chrisn chrisn closed this as completed Apr 1, 2024
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

No branches or pull requests

2 participants