docs: relabel consolidated schema as end-of-2.8 and tighten changelog entries

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: turegjorup

CHANGELOG.md

@@ -4,16 +4,8 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
-- Consolidated 25 historical 2.x Doctrine migrations into a single schema-dump migration
-  representing the end-of-2.7 schema. Upgraders must be on the latest 2.7.x with every migration
-  applied, then run `doctrine:migrations:rollup` instead of `doctrine:migrations:migrate`. Fresh
-  installs are unaffected and continue to use `migrate`. See `UPGRADE.md` step 3.
-- Restored three previously removed `Template` entity properties (`icon`, `resources`,
-  `description`) as deprecated, write-only fields with no getters/setters. The columns are kept
-  in the consolidated 3.0 schema so fresh installs and 2.x → 3.0 upgraders end up with identical
-  schemas, and Doctrine writes a value on every INSERT (the columns are NOT NULL with no DB
-  default). The properties and the matching column-drop migration are scheduled for removal in
-  3.1.
+- Consolidated 25 historical 2.x Doctrine migrations into a single end-of-2.8 schema migration; upgraders run `doctrine:migrations:rollup` (see `UPGRADE.md` step 3).
+- Restored three deprecated `Template` properties (`icon`, `resources`, `description`) as write-only fields; scheduled for removal in 3.1.
 - Fixed Calendar and Colibo feed configuration urls and added [] result when no locationEndpoint is set.
 - Fixed baked-in `.env` shipping `APP_ENV=dev` in the API image; rewritten to `prod` at build time so
   direct reads don't try to bootstrap a dev environment the prod-only dependencies can't satisfy.

UPGRADE.md

@@ -75,7 +75,7 @@ Rename the following .env variables in `.env.local`:
 
 #### 3 - Consolidate Doctrine migrations
 
-3.0 ships a single consolidated migration that represents the end-of-2.7 schema. The 25 historical
+3.0 ships a single consolidated migration that represents the end-of-2.8 schema. The 25 historical
 2.x migrations have been removed from the repository.
 
 Because every upgrading database already matches that consolidated schema (via the 25 migrations it
@@ -85,7 +85,7 @@ truncates the `doctrine_migration_versions` table and inserts a single row marki
 migration as already executed:
 
 ```shell
-# Confirm the database is at the latest 2.7.x state before rolling up.
+# Confirm the database is at the latest 2.8.x state before rolling up.
 # All 25 historical versions should appear as "migrated" / "available".
 docker compose exec phpfpm bin/console doctrine:migrations:status
 
@@ -94,9 +94,9 @@ docker compose exec phpfpm bin/console doctrine:migrations:status
 docker compose exec phpfpm bin/console doctrine:migrations:rollup --no-interaction
 ```
 
-> **Prerequisite:** the database must be on the final 2.7.x release with every 2.x migration
-> applied. If `doctrine:migrations:status` (run while still on 2.7.x) reports any pending
-> migrations, run `doctrine:migrations:migrate` on 2.7.x first, then upgrade to 3.0 and continue
+> **Prerequisite:** the database must be on the final 2.8.x release with every 2.x migration
+> applied. If `doctrine:migrations:status` (run while still on 2.8.x) reports any pending
+> migrations, run `doctrine:migrations:migrate` on 2.8.x first, then upgrade to 3.0 and continue
 > here.
 
 Fresh installs (no prior 2.x database) skip the rollup and run

migrations/Version20260506215847.php

@@ -8,11 +8,11 @@
 use Doctrine\Migrations\AbstractMigration;
 
 /**
- * Consolidated end-of-2.7 schema.
+ * Consolidated end-of-2.8 schema.
  *
  * Replaces the 25 historical 2.x migrations (Version20220309093909 …
  * Version20250828084617) with a single migration representing the schema
- * everyone is on after the final 2.7.x release.
+ * everyone is on after the final 2.8.x release.
  *
  * Includes three columns the 3.0 `Template` entity carries as deprecated,
  * write-only fields — `template.icon`, `template.resources`,
@@ -29,7 +29,7 @@ final class Version20260506215847 extends AbstractMigration
 {
     public function getDescription(): string
     {
-        return 'Consolidated end-of-2.7 schema (replaces all 25 historical 2.x migrations).';
+        return 'Consolidated end-of-2.8 schema (replaces all 25 historical 2.x migrations).';
     }
 
     public function up(Schema $schema): void

src/Entity/Template.php

@@ -30,7 +30,7 @@ class Template extends AbstractBaseEntity implements MultiTenantInterface, Relat
     /*
      * The three properties below ($icon, $resources, $description) are
      * carried over from 2.7 with their original mapping and PHP-level
-     * defaults so the consolidated end-of-2.7 schema matches both fresh
+     * defaults so the consolidated end-of-2.8 schema matches both fresh
      * installs and 2.x → 3.0 upgraders, and so Doctrine emits a value
      * for each on every INSERT (the columns are NOT NULL with no DB
      * default). They are intentionally write-only here — no getters,