Components Comparison
redline
Comparison Canvas Prose
Clause-by-clause comparison — verbatim language with inline <ins>/<del> tracking the amendment.
Variant
Use when an amendment's diff is the slide. The blockquote carries the redlined text with ins/del markers; the trailing list explains why the diff matters operationally.
When to use
- Verbatim text matters. When the amendment is the language — legal clauses, regulatory paragraphs, contract terms. Paraphrasing would lose the exact words the parties are bound by.
- Diff is the slide. The inline
<ins>and<del>markers are the editorial argument. The audience reads what changed by scanning the green and red inline marks, not by toggling between two blocks. - Why-this-matters trailer. End with a single operational sentence explaining what the diff means for the team's work. The clause is the evidence; the trailer is the implication.
When not to use
- Code diffs. For two code snippets side-by-side, use
compare-code. redline is for natural language — legal, regulatory, contractual — not source code. - Paraphrased clauses. If the quoted text isn't verbatim, the diff is meaningless. Either render the actual clause with its diff, or move to
compare-prosefor narrative comparison. - Long passage with one tiny diff. If one word changed in a paragraph, quote only the affected sentence or two. A wall of unchanged text with one inline mark buries the change.
Slots
| Slot | Selector | Required | Description |
|---|---|---|---|
heading | h2 | yes | Slide heading naming the amendment or change. |
citation | p:first-of-type > code | yes | Inline-code citation of the amended provision (e.g. 'Cal. Civ. Code §1798.135 · SB-362 (2024)'). |
redline | blockquote | yes | The amended language. Use <del>old text</del> and <ins>new text</ins> inline. |
implications | ul > li | no | Optional explanation. Use Why this matters for the operational read. |
Anatomy
┌─────────────────────────────────────────┐
│ header │
│ Clause diff heading. │
│ │
│ The original clause text with │
│ ~~struck-through removals~~ and │
│ __underlined insertions__ shown │
│ inline in the prose stream. │
│ │
│ footer 1/19 │
└─────────────────────────────────────────┘Variants
annotated — Annotated — numbered margin notes
Adds numbered sup markers in the quoted passage and renders the trailing list as numbered annotations. Use when the diff has several distinct changes that each need their own reviewer rationale.
<!-- _class: redline annotated -->
## SB-362 rewrote the opt-out link rule — annotated.
`Cal. Civ. Code §1798.135 · amendment SB-362 (2024)`
> A business that <del>collects</del> <ins>collects, sells, or shares</ins><sup>1</sup> consumers' personal information shall provide <del>two or more</del> <ins>at least one</ins><sup>2</sup> designated method for submitting requests to opt-out, <ins>including, at minimum, a clear and conspicuous link on the homepage titled "Your Privacy Choices,"</ins><sup>3</sup> for use by consumers.
- **Scope expansion.** Collapses sale and sharing into one duty.
- **Method floor.** One method is now sufficient; previously two were required.
- **Link mandate.** Pins a uniform link title across all businesses. three-col — Three-col — old | new | rationale
Splits the passage into three columns: prior text on the left, new text in the middle, reviewer rationale on the right. Use when both the diff and the why need to be on-screen together.
<!-- _class: redline three-col -->
## SB-362 — old, new, and why side-by-side.
`Cal. Civ. Code §1798.135 · amendment SB-362 (2024)`
> A business that collects consumers' personal information shall provide two or more designated methods for submitting requests to opt out of the sale of their personal information.
> A business that collects, sells, or shares consumers' personal information shall provide at least one designated method for submitting requests to opt-out, including a clear and conspicuous homepage link titled "Your Privacy Choices," for use by consumers to direct the business not to sell or share their personal information.
- **Scope.** Sale and sharing fold into one duty.
- **Method floor.** One method now suffices.
- **Link title.** Homepage label is mandatory and standardised. split — Split — old | new side by side
Two blockquotes laid out in columns: prior text on the left under an OLD label, amended text on the right under NEW. Use when the passages are short enough to read across.
<!-- _class: redline split -->
## SB-362 — before and after, side by side.
`Cal. Civ. Code §1798.135 · amendment SB-362 (2024)`
> A business that collects consumers' personal information shall provide two or more designated methods for submitting requests to opt out of the sale of their personal information.
> A business that collects, sells, or shares consumers' personal information shall provide at least one designated method for submitting requests to opt-out, including a clear and conspicuous homepage link titled "Your Privacy Choices."
- **Why this matters.** The left column is the prior text; the right is the amendment. Reading across makes the scope expansion obvious. stacked — Stacked — old block atop new
Stacks the prior text (struck, labelled OLD — prior text) above the current text (labelled NEW · current). Use when the passages are too long to sit side by side.
<!-- _class: redline stacked -->
## SB-362 — prior text struck, current below.
`Cal. Civ. Code §1798.135 · amendment SB-362 (2024)`
> A business that collects consumers' personal information shall provide two or more designated methods for submitting requests to opt out of the sale of their personal information.
> A business that collects, sells, or shares consumers' personal information shall provide at least one designated method for submitting requests to opt-out, including a clear and conspicuous homepage link titled "Your Privacy Choices."
- **Why this matters.** Stacking keeps the reading order vertical when each passage is a full sentence or more.