Add a changelog for tracking specification changes across versions#574
Add a changelog for tracking specification changes across versions#574
Conversation
rgommers
left a comment
There was a problem hiding this comment.
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.
rgommers
left a comment
There was a problem hiding this comment.
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