DOC: add a v2.5 changelog

docs/changelog.md

@@ -1,5 +1,69 @@
 # Changelog
 
+## 2.5 (2026-02-23)
+
+This release targets the 2025.12 revision of the Array API standard, and supports
+Python versions 3.10--3.14.
+
+### 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 functions, new in the 2025.12 revision, are implemented:
+
+  - `isin`
+  - `broadcast_shapes`
+  - `linalg.eig`
+  - `linalg.eigvals`
+
+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 (`axis=-1` is
+    the last axis, `-2` is the second-to-last axis, and so on).
+
+The following functions now return tuples instead of lists:
+
+  - `__array_namespace_info__().devices`
+  - `broadcast_arrays`
+  - `meshgrid` 
+
+
+- Array objects can now be pickled.
+
+
+### Minor Changes
+
+- Several functions were diverging from the standard, and have been fixed to follow
+  the 2025.12 revision of the standard:
+
+  - `clip` has been updated to accept python `int` scalars for its `min` and `max`
+     arguments for clipping a floating-point array.
+  - `clip` has been updated to always returns a copy of an input array.
+  - `full` and `full_like` now reject array values for the `fill_value` argument.
+  - `expand_dims` accepts its axis argument as either positional or keyword argument.
+
+- `sign` of a complex zero, `sign(0 + 0j)` has been fixed to return zero.
+
+
+### Contributors
+
+The following users contributed to this release:
+
+Evgeni Burovski,
+Lucas Colley,
+Lucy Liu
+
+
 ## 2.4.1 (2025-07-27)
 
 ### Major Changes
@@ -8,7 +72,6 @@
 
 - Support for Python versions 3.10 and 3.11 has been reinstated.
 
-
 ### Minor Changes
 
 - Arithmetic operations no longer accept NumPy arrays.

docs/index.md

@@ -15,12 +15,10 @@ libraries. Consuming library code should use the
 support the array API. Rather, it is intended to be used in the test suites of
 consuming libraries to test their array API usage.
 
-array-api-strict currently supports the
-[2023.12](https://data-apis.org/array-api/latest/changelog.html#v2022-12)
-version of the standard.
-[2022.12](https://data-apis.org/array-api/latest/changelog.html#v2023-12)
-support is also implemented, [and can be enabled with a
-flag](array-api-strict-flags).
+`array-api-strict` currently supports the
+[2025.12](https://data-apis.org/array-api/2025.12/changelog.html)
+version of the standard. Support for previous versions is also implemented,
+[and can be enabled with a flag](array-api-strict-flags).
 
 ## Install
 
@@ -37,7 +35,7 @@ and [Conda-forge](https://anaconda.org/conda-forge/array-api-strict)
 conda install --channel conda-forge array-api-strict
 ```
 
-array-api-strict supports NumPy 1.26 and NumPy 2.0.
+array-api-strict supports NumPy 1.26 and NumPy 2.0-2.4.
 
 ## Rationale