Docs: merge the 7.4.2-to-7.4.3 migration guide into the release notes

- inline the callback sweep recipe, drop the separate migration doc
- repoint crystaljson links and the toc to releases/7.4.3.md

Author: KrzysFR

CLAUDE.md

@@ -97,7 +97,7 @@ Known accepted netfx differences (do not "fix" by changing shared code): doubles
 
 The published NuGet packages are cut from [`Common/VersionInfo.props`](Common/VersionInfo.props). The reference **sample and sandbox projects are not part of the release**: they pin *published* `FoundationDB.*` package versions (so a reader can `restore` them like their own app), which means they legitimately lag the in-development version. Fold this sweep into the pre-tag routine:
 
-- **Before the tag**, write the version documents from the commit log (which follows the `Area: summary` house form: `git log <prev-tag>..HEAD --format='- %s'`, grouped by area prefix, then curated into prose, never the raw log). [`Documentation/releases/<N>.md`](Documentation/releases/) is the complete release notes: every change from the previous STABLE version (not the previous rc), in full detail, grouped as highlights, new features, behavior changes, breaking changes, build and tooling. It is the authoritative notes the GitHub release points at. [`Documentation/migrations/<N-1>-to-<N>.md`](Documentation/migrations/) is the upgrade companion the breaking-change entries link to for the step-by-step recipes. Add a `releases/<N>.md` entry to [`Documentation/toc.yml`](Documentation/toc.yml). The GitHub release body stays slim: the highlights and the breaking-change list, pointing to `releases/<N>.md` for the full detail.
+- **Before the tag**, write [`Documentation/releases/<N>.md`](Documentation/releases/) from the commit log (which follows the `Area: summary` house form: `git log <prev-tag>..HEAD --format='- %s'`, grouped by area prefix, then curated into prose, never the raw log). It is the single release-notes and upgrade document: every change from the previous STABLE version (not the previous rc), ordered by what applications use, each behavior change inlining what to do about it, and a final Breaking changes section for the rest. There is no separate migration guide. Follow [`Documentation/writing-style.md`](Documentation/writing-style.md), and add a `releases/<N>.md` entry to [`Documentation/toc.yml`](Documentation/toc.yml). The GitHub release body stays slim: highlights and the breaking-change list, pointing to `releases/<N>.md` for the full detail.
 - **After** the new packages are live on NuGet (they must be restorable), and **before** locking the release with a git tag, bump the pinned `FoundationDB.*` versions in the standalone samples ([`samples/getting-started/`](samples/getting-started/)) and any sandbox projects to the just-published version, then `restore` + build them to confirm they still work against the shipping packages. Doing it before the tag keeps the tagged tree pointing at real, restorable versions; it cannot be done earlier because the packages do not exist yet.
 
 ## Coding conventions

Documentation/crystaljson/index.fr.md

@@ -118,7 +118,7 @@ vais-je obtenir » ne doit jamais dépendre du chemin. Les deux membres ci-dessu
 inclusion-plus-ignore-inconditionnel est refusée (`CJSON0008`). Le remède est toujours la
 scission : un *DTO* par contrat de format, chacun portant un seul jeu cohérent d'attributs. La
 même politique rejette la signature de *callback* de l'ère `DataContractJsonSerializer` plutôt que
-de l'approximer. Le [guide de migration](../migrations/7.4.2-to-7.4.3.md) documente chaque refus
+de l'approximer. Le [guide de migration](../releases/7.4.3.md) documente chaque refus
 avec son identifiant de diagnostic et son remède.
 
 Notez que le *DTO* à double sortie est un besoin différent de servir des consommateurs *legacy* et

Documentation/crystaljson/index.md

@@ -109,7 +109,7 @@ members above are **build errors**, not choices: the double name is refused (`CJ
 the include-plus-unconditional-ignore pair is refused (`CJSON0008`). The remedy is always the
 split: one DTO per format contract, each carrying a single coherent set of attributes. The same
 policy rejects the `DataContractJsonSerializer`-era callback signature rather than approximating
-it. The [migration guide](../migrations/7.4.2-to-7.4.3.md) documents each refusal with its
+it. The [migration guide](../releases/7.4.3.md) documents each refusal with its
 diagnostic id and remedy.
 
 Note that the dual-output DTO is a different need than serving legacy and modern consumers from

Documentation/crystaljson/reference.fr.md

@@ -4,7 +4,7 @@ Les tables de référence du travail quotidien : le *setup* du générateur de s
 vous posez sur un type, les *settings* que vous passez à un appel, et les diagnostics de *build* que vous
 pouvez rencontrer. Pour les guides pratiques, voir [Travailler avec CrystalJson](serializing.fr.md) ;
 pour la conception, voir [Ce que c'est, et pourquoi](index.fr.md). Quand un comportement a changé
-entre deux versions, le [guide de migration 7.4.2 vers 7.4.3](../migrations/7.4.2-to-7.4.3.md) porte
+entre deux versions, le [guide de migration 7.4.2 vers 7.4.3](../releases/7.4.3.md) porte
 l'histoire complète, et cette page y renvoie plutôt que de la répéter.
 
 Tous les exemples utilisent `using SnowBank.Data.Json;`.
@@ -55,7 +55,7 @@ produit, et quels types elle enrôle.
 | `[CrystalSerializable(typeof(T))]` | `SnowBank.Data` | enrôle un type ; répétable ; alimente chaque format que le *container* produit |
 | `[CrystalJsonOutput(...)]` | `SnowBank.Data.Json` | demande le format JSON et porte ses paramètres (profil, politique de nommage) |
 | `[CrystalJsonConverter(...)]` | `SnowBank.Data.Json` | alias : `[CrystalConverter]` + `[CrystalJsonOutput]` avec les mêmes paramètres, pour un *container* JSON seul |
-| `[CrystalJsonSelfSerializable]` | `SnowBank.Data.Json` | méta-attribut pour les types auto-sérialisables (un type sert de son propre *container*) ; voir le [guide de migration](../migrations/7.4.2-to-7.4.3.md#new-apis) |
+| `[CrystalJsonSelfSerializable]` | `SnowBank.Data.Json` | méta-attribut pour les types auto-sérialisables (un type sert de son propre *container*) ; voir le [guide de migration](../releases/7.4.3.md#new-apis) |
 
 Un profil passé à `[CrystalJsonOutput(...)]` ou `[CrystalJsonConverter(...)]` fixe la forme de sortie
 par défaut du *container*, `CrystalJsonSerializerDefaults.Web` pour le *camelCase*,
@@ -97,7 +97,7 @@ Attention au piège de nommage : `Never` veut dire « ne jamais ignorer ».
 Pour les types `[DataContract]`, `[DataMember(Name = ...)]` renomme et
 `[DataMember(IsRequired = true)]` fait *throw* à la lecture quand le membre est absent. Les *containers*
 générés appliquent le modèle d'appartenance DataContract depuis la 7.4.3 ; le
-[guide de migration](../migrations/7.4.2-to-7.4.3.md#breaking-changes) en donne le détail.
+[guide de migration](../releases/7.4.3.md#breaking-changes) en donne le détail.
 
 ### Attributs d'autres sérialiseurs
 
@@ -120,7 +120,7 @@ CrystalJson `[JsonProperty]`, puis `[JsonPropertyName]`, puis Newtonsoft `[JsonP
 attributs de nommage qui divergent sont une erreur de *build* (`CJSON0011`) : un type ne peut pas servir
 deux contrats de sortie. Un `[JsonConverter]` étranger qui nomme un type n'implémentant pas le contrat
 de convertisseur CrystalJson est ignoré, pas une erreur, donc un *DTO* à moitié porté reste
-sérialisable. Le [guide de migration](../migrations/7.4.2-to-7.4.3.md) donne les règles d'*interop*
+sérialisable. Le [guide de migration](../releases/7.4.3.md) donne les règles d'*interop*
 complètes.
 
 ## *Settings*
@@ -174,7 +174,7 @@ pas `WithTrailingData()` (qui parse la première valeur et jette le reste).
 Les codes `CJSON####` ci-dessous sont ceux qu'un auteur normal rencontre en écrivant des *DTO*. Chacun
 est rapporté au même endroit par les deux chemins : le générateur émet le diagnostic, et le chemin
 par réflexion *throw* le même message quand il construit le contrat du type. Le
-[guide de migration](../migrations/7.4.2-to-7.4.3.md) donne le traitement complet de chacun.
+[guide de migration](../releases/7.4.3.md) donne le traitement complet de chacun.
 
 | Id | Sévérité | Refuse | Remède |
 |---|---|---|---|
@@ -191,4 +191,4 @@ par réflexion *throw* le même message quand il construit le contrat du type. L
 
 Les diagnostics des types auto-sérialisables (`CJSON0004` à `CJSON0007`, `CJSON0020`, `CJSON0021`) et
 les codes du générateur XML (`CRYS####`, `CXML####`) sont couverts dans le
-[guide de migration](../migrations/7.4.2-to-7.4.3.md) et [CrystalXml](../CrystalXml.md).
+[guide de migration](../releases/7.4.3.md) et [CrystalXml](../CrystalXml.md).

Documentation/crystaljson/reference.md

@@ -3,7 +3,7 @@
 The lookup tables for everyday work: the source generator setup, the attributes you put on a type,
 the settings you pass to a call, and the build diagnostics you might hit. For the task guides see
 [Working with CrystalJson](serializing.md); for the design see [What it is and why](index.md). Where
-a behavior changed between releases, the [7.4.2 to 7.4.3 migration guide](../migrations/7.4.2-to-7.4.3.md)
+a behavior changed between releases, the [7.4.2 to 7.4.3 migration guide](../releases/7.4.3.md)
 carries the full story, and this page links to it rather than repeating it.
 
 Every example uses `using SnowBank.Data.Json;`.
@@ -53,7 +53,7 @@ produces, and which types it enrolls.
 | `[CrystalSerializable(typeof(T))]` | `SnowBank.Data` | enrolls a type; repeatable; feeds every format the container produces |
 | `[CrystalJsonOutput(...)]` | `SnowBank.Data.Json` | requests the JSON format and carries its parameters (profile, naming policy) |
 | `[CrystalJsonConverter(...)]` | `SnowBank.Data.Json` | alias: `[CrystalConverter]` + `[CrystalJsonOutput]` with the same parameters, for a JSON-only container |
-| `[CrystalJsonSelfSerializable]` | `SnowBank.Data.Json` | meta-attribute for self-serializable types (a type acts as its own container); see the [migration guide](../migrations/7.4.2-to-7.4.3.md#new-apis) |
+| `[CrystalJsonSelfSerializable]` | `SnowBank.Data.Json` | meta-attribute for self-serializable types (a type acts as its own container); see the [migration guide](../releases/7.4.3.md#new-apis) |
 
 A profile passed to `[CrystalJsonOutput(...)]` or `[CrystalJsonConverter(...)]` sets the container's
 default output form, `CrystalJsonSerializerDefaults.Web` for camelCase, `.DataContractCompat` for the
@@ -94,7 +94,7 @@ Note the naming trap: `Never` means "never ignore".
 
 For `[DataContract]` types, `[DataMember(Name = ...)]` renames and `[DataMember(IsRequired = true)]`
 makes an absent member throw on read. Generated containers apply the DataContract membership model as
-of 7.4.3; the [migration guide](../migrations/7.4.2-to-7.4.3.md#breaking-changes) has the details.
+of 7.4.3; the [migration guide](../releases/7.4.3.md#breaking-changes) has the details.
 
 ### Attributes from other serializers
 
@@ -116,7 +116,7 @@ CrystalJson `[JsonProperty]`, then `[JsonPropertyName]`, then Newtonsoft `[JsonP
 attributes that disagree are a build error (`CJSON0011`): one type cannot serve two output contracts.
 A foreign `[JsonConverter]` naming a type that does not implement the CrystalJson converter contract is
 ignored, not an error, so a half-ported DTO stays serializable. The
-[migration guide](../migrations/7.4.2-to-7.4.3.md) has the full interop rules.
+[migration guide](../releases/7.4.3.md) has the full interop rules.
 
 ## Settings
 
@@ -168,7 +168,7 @@ To read several consecutive documents out of one buffer, use `CrystalJson.ParseF
 The `CJSON####` codes below are the ones a normal author hits while writing DTOs. Each is reported at
 the same place by both paths: the generator emits the diagnostic, and the reflection path throws the
 same message when it builds the type's contract. The
-[migration guide](../migrations/7.4.2-to-7.4.3.md) has the full treatment of each.
+[migration guide](../releases/7.4.3.md) has the full treatment of each.
 
 | Id | Severity | Refuses | Remedy |
 |---|---|---|---|
@@ -185,4 +185,4 @@ same message when it builds the type's contract. The
 
 The self-serializable diagnostics (`CJSON0004` to `CJSON0007`, `CJSON0020`, `CJSON0021`) and the XML
 generator codes (`CRYS####`, `CXML####`) are covered in the
-[migration guide](../migrations/7.4.2-to-7.4.3.md) and [CrystalXml](../CrystalXml.md).
+[migration guide](../releases/7.4.3.md) and [CrystalXml](../CrystalXml.md).

Documentation/crystaljson/serializing.fr.md

@@ -4,7 +4,7 @@ Les gestes de tous les jours, une section par tâche. Cette page suppose que vou
 CrystalJson et pourquoi il a un DOM (Document Object Model), des *proxies* et deux chemins de
 sérialisation ; sinon, lisez [l'explication](index.fr.md) d'abord. Porter un parc
 `DataContractJsonSerializer` ou Newtonsoft est un projet à part entière ; le
-[guide de migration](../migrations/7.4.2-to-7.4.3.md) couvre les diagnostics et les changements de
+[guide de migration](../releases/7.4.3.md) couvre les diagnostics et les changements de
 comportement que vous rencontrerez. Les tables complètes des attributs, des *settings* et des
 diagnostics sont dans la [référence](reference.fr.md).
 

Documentation/crystaljson/serializing.md

@@ -3,7 +3,7 @@
 The everyday gestures, one section per task. This page assumes you know what CrystalJson is and
 why it has a DOM (Document Object Model), proxies and two serialization paths; if not, read
 [the explanation](index.md) first. Porting a `DataContractJsonSerializer` or Newtonsoft estate is
-its own project; the [migration guide](../migrations/7.4.2-to-7.4.3.md) covers the diagnostics and
+its own project; the [migration guide](../releases/7.4.3.md) covers the diagnostics and
 behavior changes you will hit. The complete attribute, settings and diagnostics tables are in the
 [reference](reference.md).