DOC: start adding a changelog for 2.5

Author: ev-br

docs/changelog.md

@@ -1,5 +1,59 @@
 # Changelog
 
+## 2.5 (2026-02-XX)
+
+### Major Changes
+
+- The default version of the array API standard is now 2025.12. Previous versions can
+  still be enabled via the [flags API](array-api-strict-flags), e.g., by calling
+  `set_array_api_strict_flags(api_version='2024.12')` or setting
+  `ARRAY_API_STRICT_API_VERSION=2024.12`.
+
+  Note that this support is still relatively undertested. Please [report any
+  issues](https://github.com/data-apis/array-api-strict/issues) you find.
+
+- The following new functions, new in the 2025.12 revision, are implemented:
+
+  - `isin`
+  - `broadcast_shapes`
+  - `linalg.eig`
+  - `linalg.eigvals`
+
+- Array objects can now be pickled.
+
+
+### Minor Changes
+
+The following updates to existing APIs have been implemented, per the 2025.12 Array API
+standard revision:
+
+- `searchsorted` now accepts a python scalar for its second argument,
+  `x2`.
+
+- `expand_dims` now accepts tuples of axes.
+
+- `permute_dims` now accepts negative axes, with the usual meaning (a negative value
+  for an axis counts backwards from the end).
+
+The following functions now return tuples instead of lists:
+
+- `__array_namespace_info__().devices`
+- `broadcast_arrays`
+- `meshgrid` 
+
+- `clip` has been updated to accept python `int` scalars for its `min` and `max`
+  arguments for clipping a floating-point array.
+
+
+### Contributors
+
+The following users contributed to this release:
+
+Evgeni Burovski,
+Lucas Colley,
+Lucy Liu
+
+
 ## 2.4.1 (2025-07-27)
 
 ### Major Changes
@@ -8,7 +62,6 @@
 
 - Support for Python versions 3.10 and 3.11 has been reinstated.
 
-
 ### Minor Changes
 
 - Arithmetic operations no longer accept NumPy arrays.