-
Notifications
You must be signed in to change notification settings - Fork 50
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
Add a changelog for tracking specification changes across versions #574
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks @kgryte. This will be quite useful for implementers. A few comments here and inline, with as common theme aiming to be more explicit and easier on the reader. It's a little bit terse and not as easy to navigate as it could be.
It would be useful to add a short description at the top. Something like "This changelog is organized by specification version, noting all changes with respect to the previous version. Within the section for a specific version (e.g., v2022.12
), separate sections are used for (a) changes to existing APIs and requirements, (b) new APIs and new requirements, and (c) errata".
I didn't review for completeness yet.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We had a look at this with a few folks during a call today - all looked clear and complete. So in it goes
Is #497 mentioned here? I don't see it. |
I would suggest adding this to the site itself somewhere. |
@asmeurer #497 is mentioned in multiple locations: https://github.com/data-apis/array-api/pull/574/files#diff-06572a96a58dc510037d5efa622f9bec8519bc1beab13c9f251e97e657a9d4edR15-R18. |
This is a follow-up to data-apisgh-574
This PR