Compare Content and Form Changes
About this pattern
This is a generated FPF pattern page projected from the published FPF source. It is canonical FPF content for this ID; it is not a FPF Reference product feature page.
How to use this pattern
Read the ID, status, type, and normativity first. Use the content for exact wording, the relations for adjacent concepts, and citations to keep active work grounded without pasting the whole specification.
Type: Method pattern Status: Stable
Use this when. You must choose between two versions of a Method description or establish why one works better for its reader. The change may concern instructions, the form in which they are expressed, or both. When a revision changes both, a better answer can follow from the new instruction even if its presentation adds nothing. A reading result can support a choice of description. A claim about the Method's effectiveness needs evidence from its use.
Relations
Content
Problem frame
Use this when. You must choose between two versions of a Method description or establish why one works better for its reader. The change may concern instructions, the form in which they are expressed, or both. When a revision changes both, a better answer can follow from the new instruction even if its presentation adds nothing. A reading result can support a choice of description. A claim about the Method's effectiveness needs evidence from its use.
The working reader is a Method engineer comparing descriptions, pattern languages or other inspectable representations for a named reader and action. Start by asking: what answer or action should improve, and what changed in the material available to that reader?
The first useful result is a bounded comparison: the earlier and proposed answers, the content and representation differences, what the evidence supports, and the next repair or selection. One local contrast can be enough. If the problem is simply choosing a representation for one action, use C.37; if several unlike Method uses need complementary representations, use C.37.MP. Use C.11.MV when the question is the practical worth of the Method itself.
Problem
A new pattern language often adds examples, stops and source returns while changing headings and navigation. Readers then answer better, and the gain is attributed entirely to the language form. Conversely, a terse table can look worse because essential content was removed, not because tables are unsuitable.
The same confusion occurs with a checklist, diagram, executable description or AI-supported presentation. A comparison that changes subject, content, tools and task together can support a useful bundle choice, but it cannot isolate the contribution of one change.
Forces
Solution
C.37 supplies the use boundary and C.2.8 the selected structural-recovery question. The comparison below constructs contrasts that can separate changed claims from changed expression, records reader help and tests an affected use. It does not turn a small contrast into a causal effectiveness study; that stronger question uses the applicable research design.
Compare the description change at the receiving use, separate the available contrasts, and report only the difference that the observations warrant.
Fix the comparison question
Name the reader or consuming system, the Method or candidate account, the intended action or decision, and the result and stop the description should let the reader recover. Keep the task facts, relevant source conditions, tools and opportunity to act comparable.
State the content that must survive: the relied-on action claims, relations, applicability, uncertainty, result, stop and source-return information. Then state the representation difference, such as notation, arrangement, salience, navigation or interaction. Do not call a new condition or an unsupported diagram edge a form-only change.
Use A.6.3.RT when a change of representation language or reasoning medium affects the receiving operation, or the applicable same-regime wording, narrative or coarsening result. Its preservation and loss answer helps establish the comparison inputs; it does not demonstrate improved performance. If the Method's reusable semantics also changed, retain the A.3.1.MV identity/variant question and bound the description comparison accordingly.
Choose the smallest informative contrasts
When only content changed in a fixed form, compare those two versions. When only form changed and the relevant content is preserved, compare those two forms.
When both changed and the receiving decision needs their separate contributions, use:
The three-variant arrangement gives two local contrasts. It does not identify an interaction. Four cells make that question inspectable but supply neither replication nor causal identification by themselves.
If a cell cannot be constructed without changing another load-bearing feature, say so. A bundle comparison may still support a local choice. Do not describe it as an isolated content or form result.
Observe the receiving use
Ask the reader to obtain the first useful result, not to rate which document looks better. Recover:
- the action or decision called for, and the reader's answer;
- the result, stop or missing condition the reader identifies;
- unsupported inferences or lost distinctions that change the answer;
- the source returns needed to support or correct it; and
- the observed burden when time, source openings, attempts or other relevant effort were recorded.
When the question is how much selected structure the reader can extract, use C.2.8 ExtractableStructuralInformation. Identify the expressed account, the expression being tested and the reader, with selected relations, correctness criterion, prior knowledge, operations, help, access and budget qualified for this comparison. A qualitative account of recovered and missing relations often suffices. A number needs a declared structural scale and fixed units or denominator, not counts of words or arrows.
Keep a design estimate separate from an actual recovery observation or a mapped formal estimate. A response establishes what was returned in that trial. Attribute recovery or application to the reader when their observed work and the help available support that inference. A correct answer of unknown origin can still serve its intended use while authorship stays open. One response cannot establish maximum performance or reliability across a population.
Before interpreting a correct answer, reconstruct what each reader received. The text, prompt, examples, available tools or another participant may already have chosen the unit of comparison, the rule for matching two entries, or the action to take. Credit the reader with the choice they made. Following a supplied rule can be exactly the intended use.
A stronger claim may be that the reader can turn a general method into a rule for work in a discipline. Give the reader the general method and material from that discipline. Leave the consequential modeling choices open. Ask them to construct and justify a rule that another practitioner could apply. Use it on a change for which plausible rules would give different answers. An illustration of the principle or a fresh set of numbers for an already specified calculation provides different evidence. B.5.MR:4.3 explains how to test a claim that someone used a transdisciplinary principle (L3) to construct a repeatable rule for a discipline (L2).
Missing basis is not zero. A successful changed-condition return supports its own condition rather than increasing the original amount.
These are candidate observations, not one universal score. Select those that can change this comparison. A source-opening count does not measure comprehension; shorter reading does not prove lower total effort; recognizing a prescribed action does not establish its correct enactment.
Choose readers and allocation to variants in proportion to the claim. A fresh probe withholds the other answers and the author's preferred conclusion when they would teach the task. Repeated-reader comparisons retain learning and order effects instead of calling the reader fresh.
In AI probes, keep the model, supplied context and available tools recoverable when they affect inference. Generalizing from a few AI answers to human performance is another unanswered question.
When testing a changed-condition return
Use this probe when the comparison needs to establish how a reader responds to a new fact. First retain the reader's initial answer. Then disclose the changed source, missing fact or altered receiving use. Ask what must change and what remains usable.
The reader should revisit the dependent claim rather than repeat the whole task or preserve an invalid assumption. Compare the reader's revised answer, its source returns and its stop. If the changed condition changes the comparison question or available action set, identify that new question; do not present the two answers as observations under identical conditions.
Return a bounded revision result
State the inspected variants, the content/form contrasts they support, observations, losses, uncertainty and next decision. Distinguish a demonstrated local difference, no distinguishing result in this probe, an unavailable contrast and a confounded comparison.
Compare extraction effort and receiving value separately from structural amount through C.11.CRC and C.11. Retain the sufficient incumbent when the proposed change supplies no worthwhile gain.
Return a content correction to A.3.2.DE, a contradicted maintained claim to A.3.1.CC, and selection evidence to C.37 or C.37.MP. Use A.3.1.WT for representative enactment evidence and C.11.MV for a Method-worth decision. A causal claim needs its own justified research design and inference basis; neither this table nor an attractive explanation supplies it.
An ordinary comparison can remain short prose. When another decision will rely on it, retain the candidate versions, receiving use, observations and inference limits as an identifiable account, with the source conditions that reopen it.
Archetypal Grounding
Added stop information versus a table
This constructed comparison uses the texts below; it reports no reader study.
The receiving action is deciding whether an earlier review may support a current description revision.
A, earlier prose: “Reuse the previous review for a display-only change.”
B, revised prose: “For a display-only change, reuse the previous review only while the reviewed claims, question and qualification window still match. If a required source argument cannot be recovered for a new recheck, stop that recheck and return to its source; preserve unrelated earlier results.”
C, the same revised content in a table:
Initially, the facts say that the change is display-only, the claims and question are unchanged, and the qualification window is current. All variants can support reuse. The later condition says that a new recheck needs an argument outside the available excerpts and that the retained dossier contains only its locator.
B and C state the local stop and preservation instructions; A does not contain that distinction. This establishes a content-coverage difference in the constructed texts. It does not show that an actual reader preferred or used C more effectively than B. A reader comparison would still be needed for that form claim. The first task lets the reader use a stated review rule. To find out whether they can devise a review rule for their own discipline, give them records from that practice and leave the criteria for reusing work for them to choose and justify.
For the revision, retain the missing stop information and withhold the table-superiority claim.
A graph that adds a claim
A proposed graph draws an unconditional edge from “review complete” to “publish”. The prose requires a separate publication decision. The graph has added a consequential claim; it is not another form of the same content. Repair the edge and its condition before testing a pure form contrast, or compare the changed bundle with that difference explicit.
Compare explanations of a pattern language
An engineer has a use-bounded description of an admitted Method for checking a claim against its source. The engineer now asks why the surrounding language separates source allocation, coherence checking and reconstruction: should those three entries become one review procedure? This is a constructed comparison. The engineer knows ordinary procedures and can consult the complete framework, but has no private authoring notes.
Use A.3.2.DE for the claims describing the checking Method. E.8.ML supplies the different answer about the language arrangement: its entries serve independent questions, with different useful results and source returns. The existing arrangement is candidate A. The author proposes a shorter paragraph, B, and a table, C, for the same receiving question.
B — Selected explanation in prose. Use F.0.2.MA to decide where a recovered source contribution belongs in the language. Use A.3.1.CC when a maintained claim contradicts its basis. Use F.0.2.RC when a promised source contribution cannot be recovered.
Each entry can finish the question it answers. If you also need to choose where to start, identify the result still missing. To establish what a publication actually contains, compare its text with the allocation. Grouping the entries in an explanation leaves open which Methods are constituents of a particular whole.
C — The same selected claims in a table.
Each entry can finish the question it answers. If you also need to choose where to start, identify the result still missing. To establish what a publication actually contains, compare its text with the allocation. Grouping the entries in an explanation leaves open which Methods are constituents of a particular whole.
Make the comparison. C.37.CF separates the available contrasts. B selects and rewrites content from A; A against B does not isolate a layout effect. C rearranges B's selected claims while retaining its common conditions. B against C can therefore address that presentation difference. The full E.8.ML account remains available for conditions or questions beyond this selected explanation.
For the stated question, explain why the entries can be used separately. A practitioner may need to allocate a recovered contribution while its claims are coherent, correct a contradiction while its allocation is known, or reconstruct missing content. Each result can therefore serve a different decision. For a further request to choose an entry, identify the missing result. With an adequate allocation and one contradictory maintained claim, A.3.1.CC can suffice. In a changed case, an argument needed for a new recheck becomes unavailable. Return the affected current-use claim and source relation, preserving the earlier answer and independently supported contributions. If the question becomes publication authorization, obtain that result separately.
A reading comparison would keep the engineer's preparation, task, source access, tools and permitted help comparable and retain the initial answer before giving a corrective cue. Record reading or source-return effort only when it is observed. A shorter paragraph or a table alone establishes no reduction in total effort, and a correct response establishes neither learning nor the effectiveness of the described Method.
The source comparison supports the selected claims and their returns. It supplies no observed advantage of B or C for this reader. Retain the existing explanation unless an obtainable comparison can establish a worthwhile change. If a needed relation is absent, restore that content with A.3.2.DE or the applicable language answer before crediting a new form. If the promise is instruction, obtain the applicable subject- and holder-specific learning contribution and its evidence conditions; a form comparison does not establish that learning.
Bias-Annotation
Authors tend to know the omitted condition and may answer correctly from memory. Readers who see all variants can learn it too. Separate text inspection, fresh reading, repeated reading and actual enactment evidence.
The constructed examples expose content and inference boundaries. They contain no measured time saving, error rate or Method-effectiveness result.
Conformance Checklist
- The receiving reader, subject, action, result and stop are fixed sufficiently for the comparison.
- Content changes and representation changes are stated, including added or lost relations.
- Every claimed contrast is supported by the available variants and conditions.
- The account identifies the consequential choices the reader made and those already supplied by the text, task, tools or help. Credit for constructing a rule requires evidence from work in which that choice was open.
- When a changed-condition return is tested, an initial answer precedes disclosure of that condition.
- Observed burden is distinguished from estimated or unmeasured burden.
- The result returns to the content, selection, trial or worth decision it informs.
Common Anti-Patterns and How to Avoid Them
Consequences
A useful revision can be retained without overstating why it helped. Content defects and representation defects receive different repairs, and later selection or worth decisions receive evidence with usable limits.
The cost is preparing informative contrasts and observing the reader carry out the task. When that cost cannot change the decision, take the sufficient direct result or a bounded bundle comparison.
Architectural Rationale
A.3.2.DE asks whether a description exposes the claims a use needs. C.37.MP organizes complementary representations across uses. A.3.1.CC checks agreement and repair ownership. None of those results alone answers which difference between revised descriptions explains an observed improvement.
This pattern joins established representation-preservation and validation Methods around that professional revision question. It does not replace experimental design, produce a universal representation ranking or merge description usability with Method performance.
SoTA-Echoing
ACAP analysis (Doellken, Nelius and Matthiesen, 2024) distinguishes attention, comprehension, application and performance when investigating design-method difficulties. Adopt that separation; the evaluated sheet-metal-design setting and interpretive analysis do not justify universal metrics or causal attribution to each content element.
NIST's factorial-design account supplies the established crossed-factor idea. Adapt it to the contrasts the Method-description decision needs; do not claim a new experimental theory. C.37, A.6.3.RT and C.37.MP retain their representation results.
The cheaper alternative is direct claim inspection plus the existing representation selection. In the review-reuse example it already identifies the missing stop information; no reader experiment is necessary for that content defect. Use the fuller comparison only when a material form, learning, burden or interaction question remains. Reopen the result on a changed task, source condition, candidate content, reader population or hidden confound.
Relations
- A.3.2.DE supplies the description and receiving use; A.6.3.RT supplies representation-preservation and loss.
- C.2.8 supplies the optional structural-recovery characteristic; C.11.CRC and C.11 keep extraction cost and marginal usefulness distinct.
- C.37 and C.37.MP consume bounded evidence for one-action selection and cross-use representation profiles.
- A.3.1.CC receives a contradicted-claim correction; A.3.1.MV distinguishes description revision from Method variation.
- A.3.1.WT supplies actual trial evidence; A.3.1.FT and C.11.MV separately judge transfer/fit and practical worth.
- E.8.ML can use the comparison when choosing a pattern-language representation; F.0.2.RC supplies reconstruction failures that may motivate another comparison.
C.37.CF:End
Last Updated: 2026-10-12 — this section last modified in upstream FPF commit 6c31cd80 (github.com/ailev/FPF)