{"schemaVersion":1,"id":"2026-10-13-suggestions-review-tree","status":"draft","source":{"kind":"entry-mdx","path":"apps/www/src/registry/changelog/entries/2026-10-13-suggestions-review-tree.mdx"},"change":{"type":"source","date":"2026-10-13","commits":[]},"release":{"status":"unresolved"},"kind":"behavior","summary":"Suggestions paint each change in its own color and mark whole-block changes","targets":[{"name":"suggestion","files":["apps/www/src/registry/components/editor/suggestion.tsx"],"definitionFiles":["apps/www/src/registry/registry-features.ts"],"diagnostics":[]},{"name":"mode-toolbar-button","files":["apps/www/src/registry/components/editor/mode-toolbar-button.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"discussion","files":["apps/www/src/registry/components/editor/discussion.tsx"],"definitionFiles":["apps/www/src/registry/registry-features.ts"],"diagnostics":[]},{"name":"suggestion-demo","files":["apps/www/src/registry/examples/suggestion-demo.tsx"],"definitionFiles":["apps/www/src/registry/registry-examples.ts"],"diagnostics":[]},{"name":"suggestion-format-demo","files":["apps/www/src/registry/examples/suggestion-format-demo.tsx"],"definitionFiles":["apps/www/src/registry/registry-examples.ts"],"diagnostics":[]},{"name":"suggestion-view-demo","files":["apps/www/src/registry/examples/suggestion-view-demo.tsx","apps/www/src/registry/examples/values/suggestion-document.tsx"],"definitionFiles":["apps/www/src/registry/registry-examples.ts"],"diagnostics":[]},{"name":"suggestion-persistence-demo","files":["apps/www/src/registry/examples/suggestion-persistence-demo.tsx","apps/www/src/registry/examples/values/suggestion-document.tsx"],"definitionFiles":["apps/www/src/registry/registry-examples.ts"],"diagnostics":[]},{"name":"version-history-demo","files":["apps/www/src/registry/examples/version-history-demo.tsx"],"definitionFiles":["apps/www/src/registry/registry-examples.ts"],"diagnostics":[]}],"entries":[{"id":"2026-10-13-suggestion-change-colors","kind":"behavior","summary":"Paint every part of one change in one color, and each change in its own color, even when one person made them all.","details":[],"migrationNotes":[],"targets":["suggestion"],"source":{"line":14,"row":1,"legacyRelease":{"date":"2026-10-13","entry":"2026-10-13-suggestions-review-tree","section":null}}},{"id":"2026-10-13-suggestion-block-marks","kind":"new","summary":"Mark a suggested line break, a removed line break, or a whole-block change such as a paragraph turned into a heading, in the left margin in its change's color.","details":[],"migrationNotes":[],"targets":["suggestion"],"source":{"line":18,"row":2,"legacyRelease":{"date":"2026-10-13","entry":"2026-10-13-suggestions-review-tree","section":null}}},{"id":"2026-10-13-suggestion-refusals","kind":"behavior","summary":"Show a toast when Suggesting refuses a change that touches a code block, a table or a list item, and leave the document as it was. The mode menu switches to Suggesting only when the switch takes.","details":[],"migrationNotes":[],"targets":["suggestion","mode-toolbar-button"],"source":{"line":22,"row":3,"legacyRelease":{"date":"2026-10-13","entry":"2026-10-13-suggestions-review-tree","section":null}}},{"id":"2026-10-13-discussion-card-decide","kind":"behavior","summary":"Accept and Reject on a suggestion card decide the change that card shows.","details":[],"migrationNotes":[],"targets":["discussion"],"source":{"line":26,"row":4,"legacyRelease":{"date":"2026-10-13","entry":"2026-10-13-suggestions-review-tree","section":null}}},{"id":"2026-10-13-suggestion-demos-intent","kind":"behavior","summary":"Pass only `authored={{ intent: 'propose' }}` to a suggesting view.","details":[],"migrationNotes":["Pass only the intent to a suggesting view: replace `authored={{ intent: 'propose', projection: 'markup' }}` with `authored={{ intent: 'propose' }}`."],"targets":["suggestion-demo","suggestion-format-demo","suggestion-view-demo","suggestion-persistence-demo"],"source":{"line":30,"row":5,"legacyRelease":{"date":"2026-10-13","entry":"2026-10-13-suggestions-review-tree","section":null}}},{"id":"2026-10-13-version-history-restore","kind":"behavior","summary":"Restore a saved revision with its Restore button, as one edit you can undo. The per-author revert is removed.","details":[],"migrationNotes":[],"targets":["version-history-demo"],"source":{"line":34,"row":6,"legacyRelease":{"date":"2026-10-13","entry":"2026-10-13-suggestions-review-tree","section":null}}}],"diagnostics":[]}