diff --git a/.gittensory.yml.example b/.gittensory.yml.example
index ea54610708..b7b4868440 100644
--- a/.gittensory.yml.example
+++ b/.gittensory.yml.example
@@ -390,9 +390,12 @@ review:
     # Default: 0 (no cap). (#2065)
     # max_files: 25
 
-  # Planned display toggle (#2069): when enabled, the unified review comment includes a
-  # `review effort: N/5 (~M min)` line derived from the per-PR effort estimate.
+  # Unified-comment display toggles (#1957 / #1955 / #2069). Bool | null. Default: null/false — byte-identical.
+  # Only take effect when the `features.unifiedComment` feature is enabled.
+  # changed_files_summary: false
+  # When true, the unified review comment gains a deterministic "Changed files" summary table.
   # effort_score: false
+  # When true, the unified review comment gains a compact "review effort: N/5 (~M min)" chip.
 
   # Deterministic label suggestions (#2045). Each rule SUGGESTS a non-scoring label when a PR matches ALL of the
   # `when` criteria it sets (at least one is required): when_paths (any changed path matches a glob), title_contains,
diff --git a/config/examples/gittensory.full.yml b/config/examples/gittensory.full.yml
index e287bab71b..c29623e983 100644
--- a/config/examples/gittensory.full.yml
+++ b/config/examples/gittensory.full.yml
@@ -403,9 +403,12 @@ review:
     # Default: 0 (no cap). (#2065)
     # max_files: 25
 
-  # Planned display toggle (#2069): when enabled, the unified review comment includes a
-  # `review effort: N/5 (~M min)` line derived from the per-PR effort estimate.
+  # Unified-comment display toggles (#1957 / #1955 / #2069). Bool | null. Default: null/false — byte-identical.
+  # Only take effect when the `features.unifiedComment` feature is enabled.
+  # changed_files_summary: false
+  # When true, the unified review comment gains a deterministic "Changed files" summary table.
   # effort_score: false
+  # When true, the unified review comment gains a compact "review effort: N/5 (~M min)" chip.
 
   # Deterministic label suggestions (#2045). Each rule SUGGESTS a non-scoring label when a PR matches ALL of the
   # `when` criteria it sets (at least one is required): when_paths (any changed path matches a glob), title_contains,
diff --git a/test/unit/config-templates.test.ts b/test/unit/config-templates.test.ts
index eb0fe7ce2c..5ae5136361 100644
--- a/test/unit/config-templates.test.ts
+++ b/test/unit/config-templates.test.ts
@@ -56,6 +56,14 @@ describe("config/examples review templates (#1682)", () => {
     expect(full).not.toMatch(/not parsed yet/);
   });
 
+  it("documents shipped unified-comment display toggles in gittensory.full.yml (#2069)", () => {
+    const full = readConfigExample("gittensory.full.yml");
+    for (const field of ["changed_files_summary", "effort_score"]) {
+      expect(full, `missing review field ${field}`).toMatch(new RegExp(`# ${field}:`));
+    }
+    expect(full).not.toMatch(/Planned display toggle/);
+  });
+
   it("parses gittensory.minimal.yml with zero warnings and enables no agent actions", () => {
     const manifest = parseFocusManifestContent(readConfigExample("gittensory.minimal.yml"), "repo_file");
     expect(manifest.warnings).toEqual([]);