Document pipeline configuration migration workflow

2026-08-30 15:19:30 +00:00
parent fcb5f825e1
commit 4c203d8588
6 changed files with 27 additions and 3 deletions
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -95,6 +95,10 @@ Safe fix:
 - correct the selected profile or its overlay; or
 - correct the campaign party/family declaration that owns generated values.

+To review what would actually change before switching profiles, run `config
+diff` with the same pipeline and campaign selectors. It compares normalized
+effective values rather than YAML formatting or source-file layout.
+
 Relevant reference: [Configuration inspection](./config.md#read-only-effective-pipeline-inspection).

 ## Audio mode conflict