**Upgrade Notices**
-TODO
+TODO - Copy to updates page
-- **Category** - Notice
+- **PHP Version Requirement Change** - The minimum supported PHP version has changed from PHP 8.0.2 to PHP 8.1 in this release. Please see our ["Updating PHP & Composer" documentation page](/docs/admin/updating-php/#updating-php) for guidance on updating PHP.
+- **Sorting** - Basic sort order changes for chapters and pages will no longer affect the "updated" time for these items. Wider changes during sorting (moving to a new parent) will still increment the "updated" time.
TODO - Video
<!-- {{<pt imWKrALvSwokP3vrjRdUXh>}} -->
TODO
+
+### Search Indexing Improvements
+
+The way BookStack indexes content for search now follows more advanced logic
+for this release to address some common limitation faced.
+Specifically, single terms containing certain punctuation like `.` periods
+would have previously been split, leaving any searches for terms like "24.5"
+falling back to slower exact matches.
+
+As of v25.02, BookStack will now index the non-split term in addition to the split term,
+allowing both to match with indexed and scored results.
+In additions to `.` periods, this is also done for `-` hyphens which we previously did not
+consider before.
+
+Lastly, «giullemets» are now considered as punctuation in the same manner as other brackets.
+
+Note that to receive this improvements for existing content, you'll need to
+[regenerate the search index](/docs/admin/commands/#regenerate-the-search-index) after upgrading.
+
### Translations
TODO