Add notes for v23.7

Author: mvdh7

docs/metadata.md

@@ -89,6 +89,12 @@ Like for the recommended columns, if optional column values are only needed for
 
     *Alias for `read_dat_method`, added in v23.7.*
 
+??? info "`gran_logic` : *which points to use for Gran-plot estimates*"
+    Prior to v23.7, Gran-plot initial estimates of alkalinity and EMF<sup>0</sup> were determined using data points that were above 10% and below 90% of the maximum value of the Gran function.  From v23.7, the 90% upper cutoff was removed.
+
+    * `"v23.7+"` : use the new behaviour without upper cutoff (default).
+    * `"legacy"` : use the original approach with upper and lower cutoffs.
+
 ??? info "`k_*` : *stoichiometric equilibrium constants*"
     If not provided, then these are calculated from temperature and salinity by [PyCO2SYS](https://pyco2sys.readthedocs.io/en/latest/co2sys_nd/#equilibrium-constants).
 

docs/versions.md

@@ -8,11 +8,19 @@ Calkulate v3 went too far overboard with the OO approach and ended up being very
 
 ### 23.7 (1 July 2025)
 
+!!! warning "Different results in v23.7"
+
+    A few default settings changed in v23.7, which means that calculated results will be slightly different.  Changes should be at most on the order of 1 µmol/kg, and the new results should be more accurate.
+
+    To revert to the old behaviours, use the following kwargs or [metadata table columns](metadata.md/#optional-columns): `dilute_totals_for_ks=True, double=False, gran_logic="legacy"`.
+
 !!! info "Changes in v23.7"
 
     * All EMF solvers now do a double-solve by default, in order to improve the range of pH data that are used.  This does mean that results may change as a different set of data points will sometimes be used to solve each titration.  To revert to the old behaviour, use `double=False`.
     * Equilibrium constants now vary through titrations with temperature only, not also with changing total sulfate and fluoride concentrations as in previous versions.  To revert to the old behaviour, use `dilute_totals_for_ks=True`.
-    * Added support for German-language Tiamo titration files.
+    * More points used for the Gran-plot initial estimate of alkalinity and EMF<sup>0</sup>.  To revert to the old behaviour, use `gran_logic="legacy"`.
+    * `pH_range` kwarg replaced with separate `pH_min` and `pH_max` kwargs, which can also be used as [metadata table columns](metadata.md/#optional-columns).
+    * Added support for German-language Tiamo titration files (use `file_type="tiamo_de"`).
     * Major revisions to streamline the backend processing.
 
 ### 23.6 (19 February 2024)