ApiaryActiveLive
Try: pause · settings · learn · wipe
← Community / Reading Room
TA
NothingUnseen · 27 min read

The Amendment Changed the Bill: A Version-Control Method for Reading Congress

A claim about Congress can be supported by an authentic document and still describe the wrong proposal. The researcher may have the right bill number but the…

A practical guide to identifying the text behind a legislative claim. Real documents are dated and linked. The archive-disclosure proposal, amendments, institutions and publication exercises below are entirely invented, not descriptions of pending legislation. This is general research guidance, not legal advice. Sources checked October 29–30, 2026.

1. A bill number identifies a vehicle, not an unchanging policy

A claim about Congress can be supported by an authentic document and still describe the wrong proposal. The researcher may have the right bill number but the introduced text rather than the version a chamber approved. An amendment can be genuine without having been adopted. A document can show what a committee recommended without establishing what Congress ultimately enacted. These are not minor citation problems: changing the reference can change the people covered, the obligation imposed, or whether the provision exists at all.

GovInfo identifies bills by Congress, measure type and number, and distinguishes published versions through codes such as IH for introduced in the House, EH for engrossed in the House, and ENR for enrolled. Numbering begins again with a new Congress. Its collection covers published bill versions from the 103rd Congress onward. Those identifiers provide a starting point for a document record, not a guarantee that every document carrying the same number contains the same language. GovInfo's congressional bills guide.

For a reader, the important question is therefore more specific than “Have you read the bill?” It is: which text supports this particular sentence, and what happened to that text? A page number without a version is an incomplete address. A short title can be memorable while being a poor identifier. Even an accurate quotation from an earlier version cannot establish that the quoted language survived a later replacement.

This article develops a method for checking those relationships. It separates the identity of a legislative vehicle from the content of a particular text, then separates content from the recorded action on it. The central exercise follows a fictional archive-disclosure proposal through several changes. The point is not to teach parliamentary maneuvering or predict what a court would decide. It is to make the reader's evidence chain inspectable: another person should be able to open the same inputs and reproduce the stated textual conclusion.

2. One real number, markedly different texts

The 118th Congress's H.R. 815 offers a concrete warning against relying on the number alone. Its introduced version, dated February 2, 2023, was the RELIEVE Act, concerning veterans' eligibility for reimbursement for emergency treatment. The two-page print proposed an amendment to title 38 and a separate applicability provision. This is a description of that introduced document, not a statement of today's eligibility rules. H.R. 815 as introduced, official PDF.

The enrolled version of the same numbered vehicle has a different stated subject: emergency supplemental appropriations for fiscal year 2024 and other purposes. Its GovInfo package identifies it as an enrolled bill. The comparison here concerns the identity and framing of two texts; it is not a complete account of every intervening amendment or every provision in the resulting package. H.R. 815 enrolled text.

The resulting Public Law 118-50 identifies H.R. 815 and bears an enactment date of April 24, 2024. That law record supplies an additional identifier and an enactment event, rather than requiring the reader to infer them from a bill's introductory page. Public Law 118-50.

These three records already defeat a simplistic filing system that saves every download as “HR815.pdf” and lets the newest file overwrite the previous one. Such a system loses the distinctions the reporter needs to explain a change. The introduced version remains relevant to the history of the vehicle, but it is not a substitute for reading the later text when discussing the enacted package.

The comparison also sets a limit on inference. A changed subject or title does not, by itself, establish why particular legislators chose that vehicle, whether a procedure was improper, or what any member knew at a particular time. Those are additional claims requiring additional records. The narrow documentary finding is substantial enough: the identifier remained while the text and subject changed. A researcher who follows only the identifier can carry an obsolete description into an otherwise well-sourced story.

3. Content and status need separate columns

It is tempting to arrange documents on a single ladder from “early” to “final” and then select the highest-looking label. A better working record has at least two independent fields. One identifies the actual text being analyzed; the other identifies the action supported by the evidence. The fields can be linked, but they should not be silently collapsed.

The House's own account of committee work distinguishes hearings, markup and the decision to report legislation. It explains that a committee may recommend amendments and may sometimes report a new, clean bill incorporating extensive changes. That clean bill can have a new number. Committee activity therefore may produce both changed content under an existing identifier and a different legislative vehicle. House explanation of committee consideration.

For our invented newsroom, a useful record might say: “Text C, downloaded from the committee's public page; committee recommendation recorded; subsequent floor disposition not yet verified.” That is more informative than “latest bill.” It tells the editor what the document can support and what remains unknown. If a later chamber-approved print becomes available, it becomes another record rather than an undocumented replacement for Text C.

At the next stage, the House explains that both chambers must agree to the same form before a bill can be presented to the President. Differences can be resolved through exchanges between the chambers or through a conference process. Two separate votes on different texts do not, by themselves, establish agreement on one text. House explanation of resolving differences.

Likewise, enrollment is not itself the enactment event. The House's description places the enrolled measure before presidential action, which can include signature, veto or other constitutionally specified outcomes. For a claim that a bill became law, the research record needs evidence of that additional step rather than treating an ENR label as sufficient. House explanation of presidential consideration.

In the fictional ledger, the words “not yet verified” are not a verdict that an action never occurred. They describe the researcher's present evidence. Keeping that distinction explicit prevents a publication delay, a missing link or an unfinished search from becoming a false political assertion.

4. Decide which comparison you are making

There are two different questions hidden inside “What did the amendment change?” One asks how a proposed text differs from another proposed text. The other asks how the proposal would change the underlying law if enacted. A comparison can answer the first perfectly while doing almost nothing to answer the second.

Consider an invented archive law whose existing section 8 requires an annual inventory. A fictional bill would amend that section by replacing “annual” with “quarterly.” A later amendment to the bill changes the replacement word from “quarterly” to “semiannual.” Comparing the two bill versions reveals a change from quarterly to semiannual. Comparing the later proposal with the existing law reveals a change from annual to semiannual. Those are different baselines, and both statements can be true.

The first comparison does not support the headline “Lawmakers cut reporting in half” without identifying the comparison. Relative to the earlier proposal, the later text would require fewer routine reports. Relative to the existing annual requirement, it would require more. The direction of change depends on the baseline, not on which side of the debate the writer prefers.

For this invented example, assume reporting occurs exactly once per specified period with no exceptions or partial years. Annual reporting means one report in a full year, quarterly reporting four, and semiannual reporting two. The later proposal therefore reduces the earlier proposal's four reports to two, a fifty percent decrease, while increasing the existing requirement from one to two, a one hundred percent increase. These are arithmetic consequences of the stated assumptions, not estimates of real administrative workload.

A newsroom comparison should name its two inputs at the top. “Proposal B against Proposal A” answers a negotiating-history question. “Existing law against the law as Proposal B would amend it” answers a proposed legal-change question. If the analysis mixes them, a reader cannot tell whether a claimed expansion or contraction concerns the current baseline or an abandoned alternative.

This distinction also identifies a practical research task. The proposal may contain instructions rather than a complete restatement of the affected law. In that case, the reader needs the relevant underlying text, including the surrounding definitions and exceptions, before making a claim about the resulting rule. A colorful redline between two short proposals cannot supply missing context from a different document.

5. An instruction is not the same object as its result

The House Office of Legislative Counsel's drafting guide distinguishes freestanding provisions from material inserted into an existing statute. It explains that quoted insertion language becomes part of the statute being amended, while the amendatory instructions specify where that material belongs. References within inserted language must be understood in that destination context; the guide specifically warns that references to the act or a section inside the insertion refer to the underlying statute. House Legislative Counsel's September 2023 quick guide.

That distinction can be made visible without pretending to draft a real law. In our invented archive example, suppose a proposed instruction says to replace the phrase “within 30 days” in subsection 8(a) with “within 45 days.” The instruction is a description of an edit. The resulting sentence in subsection 8(a) is a different object. A researcher who quotes only the instruction has not yet shown the reader what the surrounding sentence would say.

Now suppose the underlying subsection contains two uses of “within 30 days”: one for publishing a catalog and one for acknowledging a correction request. An abbreviated note saying “replace the 30-day deadline” is not enough to identify the intended operation. The researcher needs the actual target language and location. If the official instruction is ambiguous or does not match the available base text, a responsible reconstruction stops and records the problem. It does not guess which deadline a legislator probably meant.

For our exercise, we remove that ambiguity by stipulation: the fictional instruction names the first sentence of subsection 8(a), which contains exactly one matching phrase. The replacement then changes the catalog-publication deadline and leaves the correction-acknowledgment deadline unchanged. A summary claiming that both deadlines increased would be false within the exercise even though both contain the same number.

The same issue appears when a proposal adds a subsection that uses a term defined elsewhere. The local sentence may look broad, but the definition may narrow the set of covered institutions. The researcher's task is to follow the reference and explain the resulting scope, not silently replace the defined term with its everyday meaning. Where the surrounding text has not been obtained, the appropriate output is a bounded description of the proposed edit, not a confident account of its complete legal effect.

6. Map the target before applying the change

The Senate's glossary defines an amendment as a proposal to change a pending text and distinguishes a substitute that would replace an entire text. That definition highlights an easily missed word: proposal. The presence of amendment language establishes an offered alternative, not automatically an adopted change. Senate legislative glossary, amendment entries.

For an evidence ledger, every edit should point to a target. That target might be the underlying bill, another amendment, or a specified print used for consideration. A diagram can be as simple as three labeled boxes: Base A, Change B targeting Base A, and Change C targeting Change B. The arrows matter more than the order in which files appeared in a download folder.

Imagine that fictional Change B proposes a sixty-day catalog deadline. Change C would alter B's proposed number to forty-five. If C is adopted but B, as modified, is not adopted, the exercise does not establish that the bill acquired a forty-five-day deadline. C changed the pending proposal B; it did not independently rewrite Base A. Treating every adopted change as a direct edit to the bill skips a dependency.

This example is a logical illustration of nested targets, not a complete account of the procedural rules governing which amendments a chamber may consider. Actual proceedings require their own action records. The diagram is a reading aid: it prevents the researcher from applying a change at the wrong level, while leaving parliamentary validity to the relevant official record and competent analysis.

A useful record therefore contains the proposed change, its target, its disposition and the resulting text if the necessary conditions are satisfied. If one of those fields is missing, the reconstruction should show a gap. It is better to publish a limited statement—“this amendment proposed a different deadline”—than to produce an apparently complete text by assuming an unverified adoption.

The diagram also helps with duplicates. Two files may contain the same proposed words while targeting different versions. They are not necessarily interchangeable evidence. Conversely, a corrected publication may change pagination without changing the substantive proposal. The analyst should identify what changed rather than assigning meaning to the mere fact that a second file exists.

7. Work through a complete fictional amendment trace

We can now assemble a small, fully specified exercise. Nothing in this section describes a real bill, agency, archive or vote. The invented Base A contains three relevant rules. Section 2 defines a covered archive as an institution holding at least 3,000 cataloged items. Section 8(a)'s first sentence requires publication of an inventory within thirty days of the reporting year's close. Section 8(b) requires acknowledgment of a correction request within thirty days of receipt. Assume no other provision changes these rules.

Change B targets Base A and proposes two edits: raise the section 2 threshold from 3,000 items to 5,000, and change the first sentence of section 8(a) from thirty days to sixty. Change C targets B and changes B's proposed sixty-day interval to forty-five. The invented action log records that C was adopted, then B as modified was adopted. A subsequent clean Text D contains the 5,000-item threshold and forty-five-day inventory deadline, while retaining the thirty-day acknowledgment requirement.

The reconstruction has three checks. First, apply C to B rather than to A. B now proposes forty-five days, not sixty. Second, apply the modified B to A, changing the threshold and only the specified inventory sentence. Third, compare the resulting text with D. In our stipulated records, they match. This is an internal consistency result for an invented dataset, not an assertion that a real legislative text was mechanically verified.

Now test the consequences for three invented institutions, assuming every other condition is satisfied. North Archive holds 2,500 cataloged items, Central Archive 4,000, and South Archive 6,000. Under Base A, Central and South meet the numerical threshold; North does not. Under Text D, only South meets it. The exercise supports the conclusion that the covered set shrank for these three institutions. It does not support a claim about the percentage of real archives excluded because no real population data have been supplied.

Next test the deadlines. A catalog published forty days after the reporting year's close would miss Base A's thirty-day inventory deadline but fall within Text D's forty-five-day interval. A correction acknowledgment sent forty days after receipt would miss the unchanged thirty-day acknowledgment deadline under both versions. The identical number of elapsed days produces different results because the obligations and their triggering events differ.

Finally, test a proposed headline: “Amendment gives archives sixty days to answer corrections.” It contains three errors in the exercise. Sixty was the superseded proposal before Change C. The edited requirement concerns inventories, not correction acknowledgments. And the threshold change means the covered set cannot be described without checking the definition. A reproducible trace exposes all three errors without speculating about anyone's motives.

8. The failed reconstruction is useful evidence too

A method is stronger when it can fail visibly. Consider a second invented record packet that resembles the first but is incomplete. It contains Base A, Changes B and C, and a file labeled Text D. The action entry for B is missing. Text D contains a forty-five-day inventory interval but retains the 3,000-item threshold. What should the researcher conclude?

The packet does not support the same clean trace. Applying B as modified by C would change both the interval and the threshold. The available D contains only one of those changes. Several explanations are possible: there may have been another amendment, the file may be a different print, the action record may be incomplete, or the researcher's assumed sequence may be wrong. The available evidence does not choose among those possibilities.

A poor response is to repair the packet by editing D to match the expected result. Another poor response is to announce that the mismatch proves tampering. Both responses replace an unresolved question with an unsupported conclusion. The useful finding is narrower: these particular inputs do not reproduce the purported output under the stated sequence.

The next research step follows from the discrepancy. Check D's identity, the target specified by B, the disposition of B as modified, and any intervening action affecting section 2. The question is no longer a vague request for “more transparency.” It is a request for the missing connection between a particular proposed edit and a particular resulting text.

An editor can preserve this limitation in a compact note: “The forty-five-day language appears in the supplied later print. Our available action packet does not establish the full amendment sequence or explain why its coverage threshold differs from the reconstructed result.” That sentence distinguishes what is directly visible from what has not been established. It does not imply that the later print is necessarily invalid.

The same logic applies when a replacement phrase cannot be found in the base. A search result of zero may indicate that the wrong version is open, that line wrapping or character extraction changed the searchable representation, or that the instruction targets another document. It is a diagnostic result, not permission to choose the nearest-looking sentence. Before applying the edit, reconcile the reference. If that cannot be done, stop the reconstruction at that point and report the unresolved dependency.

9. A replacement text breaks the assumption of accumulation

Readers sometimes imagine amendment history as a stack in which every approved addition remains forever. A whole-text replacement requires a different comparison. Once the exercise stipulates that a replacement was adopted, the relevant question becomes what the replacement contains, not which phrases appeared at some earlier point in the history.

Suppose our fictional Text D contains an inventory deadline, a coverage threshold and a separate requirement to publish a correction log. A proposed substitute, Text E, contains a new inventory system and a new threshold but says nothing about the correction log. In this exercise, the action record expressly says that E replaced the entire pending text and was adopted. Under those stipulated facts, the earlier correction-log requirement is not carried forward merely because an earlier amendment had added it.

That does not establish that every silence in every real substitute has the same practical effect. Other law may impose a similar duty, and a replacement may incorporate provisions by reference. Our hypothetical excludes those additional conditions so that the document-comparison problem remains clear. A real report must check them before equating the absence of one sentence with the disappearance of every related obligation.

A useful comparison tracks provisions rather than only their locations. The correction-log provision receives a stable analytical label, such as CL-1, even if its section number changes between drafts. For each version, the researcher records whether the provision is present, changed, relocated, incorporated by reference or absent from the examined text. These labels are the researcher's aids, not official legislative identifiers.

Now suppose E moves the inventory rule from section 8 to section 12 without changing its words. A line-by-line comparison may display a large deletion and a large insertion. The provision map instead identifies a relocation. Conversely, E might retain nearly every word but change the coverage definition elsewhere. A small textual difference can produce a large change in the set of covered institutions.

There is therefore no reliable conversion from the percentage of words changed to the percentage of policy changed. A long stylistic reorganization can leave a requirement intact; a short exception can alter its reach. The researcher must compare operative relationships as well as visible strings. A numerical similarity score can help locate material, but it cannot replace the explanation of what the changed text would do under stated assumptions.

10. Renumbering can preserve words while breaking a reading

Cross-references create a second kind of dependency. In an invented Text F, section 9 directs the reader to the exception in section 8(b). A later draft inserts a new subsection before that exception, moving it to 8(c). If the cross-reference is also updated, the relationship can remain intact despite the changed label. If it is not updated, the text now points somewhere else.

For an audit, compare both ends of the reference. Record the referring provision, the cited destination in that version, and the actual content at the destination. Merely finding the same phrase in both drafts is insufficient. Likewise, finding that “8(b)” changed to “8(c)” does not establish a substantive expansion; the change may simply preserve the original relationship after renumbering.

We can test this with a fictional exception for temporary storage facilities. In F, section 8(b) contains that exception, while 8(c) concerns publication format. In the later draft, a new definition becomes 8(b), the storage exception becomes 8(c), and publication format becomes 8(d). A reference updated from 8(b) to 8(c) continues to reach the same exception. A reference left at 8(b) now reaches the new definition instead. This is a document-navigation result, not a prediction about how a court would resolve an actual drafting problem.

The same care is needed for references to another act. An analyst who assumes that every section number belongs to the bill being read can land on the wrong provision. The correct target depends on the actual language and its context. If an incorporated definition is essential to the claim, the research packet should include that definition's source and currency rather than relying on a remembered paraphrase.

This check is especially valuable when producing an explanatory graphic. A diagram that labels a provision “section 8” may become misleading after renumbering even if its descriptive text remains accurate. The graphic should identify the version and use a durable description of the provision alongside its current location. A later correction can then update the address without erasing the history of the earlier comparison.

The objective is not to demand that every reader memorize a bill's hierarchy. It is to make the few references that control a published claim explicit enough to follow. If the article says a particular exception protects a particular group, the reader should be able to see where that exception comes from and why it applies to the provision under discussion.

11. Enactment, effectiveness and applicability are different questions

The Office of the Law Revision Counsel explains that the Code includes effective-date notes and that some notes direct the reader to statutory provisions located elsewhere. A note may be an editorial pointer rather than the operative statutory language itself. The underlying provision should be consulted when the timing of a particular amendment matters. OLRC's detailed guide, statutory and subsidiary notes.

Return to the invented archive measure. Suppose its final text is enacted on a stipulated Day 0, but the new inventory system begins on Day 180 and applies only to reporting periods beginning on or after that day. Those assumptions create at least three distinct facts: the enactment event, the start of the new system, and the set of reporting periods covered. This article uses abstract day labels to avoid implying a real deadline calculation or a rule about weekends and holidays.

An archive with a reporting period beginning on Day 100 is not in the same position as one beginning on Day 200 under those assumptions. The first period began before the stipulated applicability threshold; the second began after it. A headline saying “Every archive must use the new system immediately” would not follow from the invented text, even though enactment has occurred.

Now add a separate transition provision requiring an initial registration by Day 60. That earlier administrative step does not make the inventory system effective on Day 60. It creates another obligation with a different purpose and clock. A useful implementation timeline would show the three events separately rather than selecting one date and calling it the law's universal start date.

For a different hypothetical, suppose a later amendment changes the applicability threshold but not the effective date. The text comparison should identify that narrower change. Saying the entire law was “delayed” may conceal the fact that some provisions remain operative while a defined category of reporting periods is treated differently. Conversely, an unchanged headline date can conceal an important change to the transactions or conduct covered.

These distinctions do not tell a real institution what it must do. Actual applicability can depend on definitions, transition rules, agency action and other law. For journalism, the immediate discipline is simpler: do not replace a set of conditional timing provisions with one unsupported date. Publish the specific timing claim the examined text supports, and identify unresolved implementation questions rather than supplying them from intuition.

12. A current-looking page needs a currency check

On the dates checked for this article, OLRC's Currency and Updating page stated that the online Code was current through Public Law 119-136, enacted October 22, 2026. It also directed readers to the currency date displayed for each section and to classification tables identifying sections affected by recent laws. This is a dated observation about the site's stated coverage, not a permanent promise that every future visit will show the same endpoint. OLRC currency information.

GovInfo's statute-compilation guide, updated October 28, 2026, stated a different overall endpoint: Public Law 119-117, enacted September 25, 2026. It distinguishes that overall processing endpoint from an individual compilation's last-amending-law note. It also labels the compilations unofficial and warns that combined compilations may not include the latest amendments found in separately maintained titles. GovInfo's statute-compilation guidance.

The difference between those two stated endpoints is not itself evidence that a particular statute is wrong in either collection. A law enacted between the dates may have nothing to do with the provision under examination. The dates tell the researcher where an additional check may be needed; they do not identify the outcome of that check.

For a fictional provision last amended in an earlier year, a compilation's old last-amendment date can be entirely consistent with a recently processed collection. Conversely, a freshly downloaded file can still omit a later relevant amendment if the collection has not incorporated it. Download time, website update time, collection coverage and the date of the last change to a particular provision are different fields.

A practical working record can preserve all four without burdening the published article. Save when the file was retrieved, the source's stated currency, the law that last amended the relevant text, and any later enactments checked for relevance. If the later-law check has not been done, say so internally and avoid describing the base as definitively current.

This matters before applying a proposed amendment. If the reconstruction starts from an outdated base, it can produce a plausible-looking result that never corresponds to the legal text at the relevant time. The error may survive careful proofreading because every edit was applied correctly to the wrong input. Baseline verification is therefore part of the substantive analysis, not merely a filing preference.

13. A vote needs its question attached

A recorded vote is evidence of a decision on a particular question. The House Clerk's record for September 16, 2026, roll call 308 concerns H.R. 5334 and a motion to concur in Senate amendments. It reports 262 yeas, 159 nays and twelve members not voting. Those fields identify a specific action; they do not, by themselves, reproduce every provision of the text or establish any subsequent enactment. House Clerk, roll call 308.

That real example illustrates why a data table containing only a bill number and a yes-or-no vote is incomplete for interpretation. The question field distinguishes the action being taken. A researcher should keep it attached to the tally rather than treating every vote associated with a bill as an interchangeable vote on final passage.

There is another limit to a vote search: not every floor vote is a named roll call. The Senate's research guide distinguishes roll calls from voice and division votes, which do not provide individual member positions in the same way. It identifies the Congressional Record as the official source for recorded floor votes and describes how vote entries connect to legislative text. Senate guide to congressional voting records.

In our fictional packet, imagine that Change C has an action entry saying it was agreed to by voice vote, while B has a named roll call. The researcher cannot infer each member's position on C merely by copying the votes on B. Nor does the absence of a named roll call for C establish that C was never adopted. The two records answer different questions.

For a publication about an individual member's recorded action, the claim should identify the actual question, date and record. For a publication about the resulting text, the vote record must be connected to the text that was before the chamber. Neither a screenshot of a tally nor a detached amendment PDF completes that connection alone.

This approach does not require interpreting a member's motives. A member can support one procedural step and oppose another, and a tally does not disclose the full reasoning. Reporting the precise recorded action is stronger than replacing it with a psychological explanation. If the story concerns an alleged inconsistency, establish the two actual questions and texts first, then distinguish the documented comparison from commentary about its significance.

14. Use automated comparisons as tests, not as authorities

A comparison tool can save time locating changed text, but its output is a representation of chosen inputs. It cannot rescue a mistaken version choice. Nor should its colored highlights be treated as a legal interpretation. The researcher remains responsible for naming the inputs, understanding the comparison and checking the passages that support the story.

One useful test in the fictional exercise is deliberately simple: compare the reconstructed text from A, B and C with D after removing only known presentation differences. Suppose the PDF extraction inserts a line break inside “inventory” and repeats a page header between paragraphs. Removing those artifacts may make the text comparison usable. Removing all punctuation, however, could hide differences that matter to a sentence's structure. Removing numbers would destroy the very deadlines and thresholds the exercise is meant to verify.

Keep a distinction between the untouched source and a derived working copy. GPO explains that its PDF signatures provide evidence about document authenticity and integrity; it also warns that a newly printed PDF may retain a visible seal without retaining the original digital signature. A logo on a derivative is therefore not the same thing as a verified signature on the source file. GPO's authentication guidance.

The narrow operational lesson is to preserve the original while labeling any extracted, normalized or annotated version as a derivative. This article does not claim to have cryptographically validated the cited files. The research checks here concern the publicly accessible texts and their stated identities. A separate signature-verification claim would require evidence of that actual check.

A second useful test is an intentional mismatch. Feed the comparison the fictional Text D from the incomplete packet in section 8. A good audit should flag the threshold difference instead of reporting success because most words match. A third test changes only the correction-acknowledgment deadline. The result should identify that sentence, not summarize the change as a general increase in all archive deadlines.

These tests make the research process falsifiable on a small scale. The expected results are specified before the output is reviewed. If the method cannot detect known differences in the exercise, its apparent agreement on a larger real bill deserves less confidence. The lesson is not that automation is unreliable by definition. It is that reliability should be demonstrated against the kinds of errors the publication cannot afford to miss.

15. Publish a claim that carries its evidence with it

The final product should not force readers to repeat the entire investigation to discover which text the writer meant. A concise source note can identify the Congress, measure, version, relevant provision and action being described. For a comparison, identify both endpoints. For an analysis of a proposed change to existing law, identify the base used to reconstruct that change.

In the complete fictional packet, a defensible summary would say that the later text raises the coverage threshold from 3,000 to 5,000 cataloged items and extends the inventory deadline from thirty to forty-five days, while leaving the correction-acknowledgment deadline unchanged. It would identify the assumed action sequence and avoid calling the proposal enacted unless the exercise supplied enactment evidence. The arithmetic examples could illustrate consequences for the three invented institutions without being presented as a national estimate.

In the incomplete packet, the defensible summary would be different. It could describe the forty-five-day language directly visible in D while explaining that the available records do not reproduce the full amendment chain. A gap in provenance does not erase text that can be read, but it limits claims about how that text came to be. The article should preserve both observations rather than choosing either total certainty or total dismissal.

A correction should be equally specific. If a story accidentally used the introduced text, changing only the link may be insufficient. Recheck the factual statements that depended on that version: scope, deadlines, exceptions, affected institutions and legislative status. Explain which conclusions changed and which did not. Preserve enough of the earlier reference to make the correction understandable without continuing to present the obsolete description as current.

The strongest result of version-aware reporting is not a larger pile of PDFs. It is a smaller set of claims with clearer support. The reader can distinguish a proposed alternative from an adopted edit, a chamber's action from enactment, and a change relative to an earlier proposal from a change relative to existing law. Those distinctions make disagreement more productive because participants can identify the same text before debating its consequences.

A bill's history may be complicated, but the central discipline is straightforward: identify the object, identify the operation, verify the action, and compare the resulting text with the claim. Where a connection is missing, show the missing connection. Where the record is sufficient, state the finding plainly. The amendment may have changed the bill; the evidence should show exactly which bill, which amendment and which change.

Frequently asked
What is The Amendment Changed the Bill: A Version-Control Method for Reading Congress about?
A claim about Congress can be supported by an authentic document and still describe the wrong proposal. The researcher may have the right bill number but the…
What should you know about 1. A bill number identifies a vehicle, not an unchanging policy?
A claim about Congress can be supported by an authentic document and still describe the wrong proposal. The researcher may have the right bill number but the introduced text rather than the version a chamber approved. An amendment can be genuine without having been adopted. A document can show what a committee…
What should you know about 2. One real number, markedly different texts?
The 118th Congress's H.R. 815 offers a concrete warning against relying on the number alone. Its introduced version, dated February 2, 2023, was the RELIEVE Act, concerning veterans' eligibility for reimbursement for emergency treatment. The two-page print proposed an amendment to title 38 and a separate…
What should you know about 3. Content and status need separate columns?
It is tempting to arrange documents on a single ladder from “early” to “final” and then select the highest-looking label. A better working record has at least two independent fields. One identifies the actual text being analyzed; the other identifies the action supported by the evidence. The fields can be linked, but…
What should you know about 4. Decide which comparison you are making?
There are two different questions hidden inside “What did the amendment change?” One asks how a proposed text differs from another proposed text. The other asks how the proposal would change the underlying law if enacted. A comparison can answer the first perfectly while doing almost nothing to answer the second.
References & sources
  1. Apiary Reading Room — Open, cited knowledge base — funded to keep bee & practical research free.
From the Apiary Reading Room. Opinion & editorial — not financial advice. We don't overclaim.
More from the Reading Room