Skip to content

jeffpar/argument-aloud

Repository files navigation

Argument Aloud

For The Sake of Argument

Every U.S. Supreme Court case ends in a decision, but it starts with arguments, and those arguments come in many forms: the initial petition, a series of briefs, and then usually oral arguments, all of which have been recorded since October 1955 and transcribed since October 1968.

Unfortunately, all those pieces tend to be scattered. Even the Supreme Court's own website directs you to different pages for every one of those pieces. Other essential pieces of information, such as copies of statutes, records from the lower courts, etc, can usually be found in the briefs or elsewhere, but you have to know where to look.

So we've created this "hub" to help connect those pieces. Here's an example: an excerpt from the March 23, 2026 argument in Watson v. RNC (No. 24-1260), with links to documents that activate automatically as the argument progresses.

This website barely scratches the surface of what is possible, but hopefully it will give you sense of what a modern UI can accomplish, and maybe it will even inspire others to "follow suit."

For The Sake of Accuracy

We rely only on "authoritative" sources, starting with The U.S. Supreme Court, as well as the The National Archives and The Oyez Project; however, authoritative does not mean error-free. For example:

Data from The Oyez Project is slightly more problematic, as we've noted, but being able to compare multiple data sources, including The Supreme Court Database, has been a great way of flushing out mistakes, on all sides.

And make no mistake: these are all simple, minor mistakes, so we don't mean to blow them out of proportion, but they do create problems when trying to connect all the pieces for all the cases. We make corrections here as we find them, but without the ability to feed those corrections back to their source, disconnects will persist.

For The Sake of Completeness

Missing data is also occasionally a problem; for example:

Advocate data is another challenge, because it's not recorded anywhere as a separate set of data. The Court does record advocate names in various places, including transcripts and Journals, but they presumably track that information separately as well, because on rare occasions, the Chief Justice will congratulate an attorney (e.g., Edwin Kneedler) for having just argued their 100th case.

Extracting advocate data from printed/scanned journals and transcripts is non-trivial and error-prone, and disambiguating names (ie, understanding when two similar names are different people, or vice versa) requires time. For cases from the October Term 1955 onward, we rely largely on transcripts, and for certain groups of advocates, we have either done our own research, as we did for Justice Advocates, or we have supplemented the research of others; see Women Advocates.

There is still more work to do in terms of producing a complete and accurate list of Top Advocates. Of course, if the Court shared its advocate data with the public, that would be even better.

TODO

  1. We need a simple way of capturing and then applying speaker corrections. Let's kick this off with an example, where the speaker is Justice Kennedy, not Justice White.

  2. Add support for journal_href (in audio entries) and history_href (in case entries), to provide more context regarding cases and arguments.

  3. loc.gov currently has copies of opinions from U.S. Reports as far forward as Volume 578. Unfortunately, they suffer from some sloppiness; for example, there is no entry for Sullivan v. Florida (560 U.S. 181); you can only find it at the bottom of the document for United States v. Comstock (560 U.S. 126). There are numerous other instances where opinions that should exist on loc.gov cannot be found, so at some point, a comprehensive audit should be performed.

MIT License

Project design (c) 2026 by Jeff Parsons

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

U.S. Supreme Court Courtroom
[Source]

Photograph of Supreme Court Building
[Source]

About

Mappings of U.S. Supreme Court Media

Resources

Stars

Watchers

Forks

Releases

No releases published

Contributors