OpenCongress Blog
New Feature: Inline Commenting for Bill Text
February 23, 2009 - by Donny ShawA quick scan through the legislation pending in Congress and things look pretty good. They’re working on fixing the economy, helping people keep their homes, protecting children from online predators, etc. But with every piece of legislation, there is the ideal it represents, and then there is the specific changes to the law it proposes in order to achieve that ideal.
Usually it’s the specifics that really matter. That’s why we’re adding inline commenting for all legislative text on OpenCongress. For every bill in Congress (see hot bills), now you can leave comments and spark discussion on specific blocks of text within a bill. Just scroll over any section of bill text, and the option to leave a comment will appear. After you leave a comment, a marker will show up next to the block of text you commented on so that everyone who reads through the bill knows that they can click through to view your comment.


The top screenshot shows the normal view of a section of bill text with comments. The bottom one shows what happens when you click to view the comments.
This feature can be used in a variety ways – pointing out problematic language in a bill, asking questions for people with more legal expertise, suggesting changes and amendments, sharing related information from U.S. code, or just expressing your opinion. Bill text comments are threaded, so users can respond to your comments, offer secondary suggestion, answer your questions, etc.
We have also added the ability to easily create permalinks for specifics sections of bills. Just scroll over a section of bill text, click “Permalink,” and copy the new url from your browser’s address field. Now, when you’re blogging about a bill or discussing it on a forum, you can use the url to focus more easily on the specific provisions in a bill that are important to you.
Big thanks to Josh Tauberer of GovTrack and Kevin Henry, working as a volunteer with GovTrack, for building the open-source code that this feature is based on!
Announcing 4 Big Features - Wiki, Video, and More
March 5, 2009 - by Donny ShawWe have four major features to announce on OpenCongress today, and we are very excited about each one of them. Here’s an overview, with more info and examples of each new feature below:
1. OpenCongress Wiki – for every Senator, Representative and major piece of legislation in Congress, there is now a space for people to work together to build a comprehensive overview of all the most important information – the stuff that can’t be gotten from government data sources alone.
2. Videos from Metavid, the open video archive of the U.S. Congress, and the YouTube hubs for the House and Senate. Now, for every Senator, Representative, and major bill in Congress, OpenCongress shows you embedded video footage of relevant floor speeches, official announcements, and more. It’s video, it’s awesome.
3. Inline commenting on bill text, now with the ability to compare different versions of a bill. Building off our feature to comment and link to a bill’s official text, paragraph-by-paragraph, now text changes are displayed in different color type for at-a-glance comparison. Jump in to sections, compare, and comment on such high-profile legislation as the Stimulus Bill, the major Omnibus Spending Bill, and every bill in Congress.
4. For the Read The Bill campaign from the Sunlight Foundation and others, a new page to track bills that have been rushed through the Congressional process. Subscribe to the RSS feed to watchdog bills that haven’t been posted for open public review on the Internet for 72 hours before debate begins.
OpenCongress Wiki

On bill pages, the OpenCongress Wiki serves as a collaborative editing space for people to work through legislation line-by-line, translating the legalese into plain language and interpreting the implications of the proposed changes to the law. Wiki pages also give a narrative overview of every action that is taken on a bill by Congress, from introduction, to committee, amending, passing, conference, and, finally, being signed into law by the President. All content on the Wiki will be thoroughly sourced, so you can trace back the information to be sure of its quality. The best part of all this is that we already have a great foundation to build this off of. For an example bill page to see where things are starting, click the “Wiki” tab on the Stimulus Bill, or the Lilly Ledbetter Fair Pay Act of 2009.
Senator and representative Wiki pages are starting out even stronger. The information we are including for the launch the OpenCongress wiki is some of the best around for getting a thorough, non-partisan overview of what a member of Congress is all about. You can view information on senator and representative’s key votes, political views, controversies and scandals, personal life, campaign financing, and much more. Click the “Wiki” tab on Sen. Chris Dodd’s (D-CT) page or Rep. Roy Blunt’s (R-MO) page to view an example.
There are also hundreds of pages in the wiki that don’t fit into these categories. They are organized into sections and linked organically throughout the Wiki. Here are a handful to check out:
- Cloture and filibusters in the U.S. Congress
- How a bill becomes a law
- Members of Congress under investigation
- Members of Congress who Twitter
- Campaign finance (U.S.)
- How Congress Works: Earmarks
- Congressional Scorecards
…Poke around a bit and you’ll find a lot more.
Even though we are launching the OpenCongress wiki with some great content already in place, we need everyone to lend a hand in helping us build public knowledge about Congress. If you are reading this, you probably have more political savviness than the average person, and there is probably an issue, member of Congress, or piece of legislation that you know particularly well. The OpenCongress wiki is built entirely by readers like yourself, so please be bold in adding your knowledge to the Wiki pages. To get in touch, email Conor Kenny, the Site Editor: conor@opencongress.org.
To get you started, we have put together some help documentation with information on how to edit a page, how to start a new page, how to cite your sources, and lots more. Note for developers: the OpenCongress Wiki uses the Semantic MediaWiki platform, so all the Wiki content can be queried and remixed – for more on that, view the still-in-development OpenCongress API, or write conor@opencongress.org. Thanks to Yaron Koren, our lead Wiki programmer, for his assistance and expertise.
The OpenCongress Wiki is still in beta, so you may come across a bug or two in your browsing. If you do, feel free to email us with a bug report at writeus@opencongress.org. We’ll be fixing stuff that’s broken and making improvements continually.
Video Feeds of Congress
We’re also pleased to be integrating the best video footage of Congress that’s publicly available. OpenCongress automatically brings in relevant videos for of Members of Congress and prominent bills from Metavid, the open video archive, and the YouTube Senate Hub and House Hub. Video coverage for legislation and floor debates comes primarily from Metavid, a non-profit project of UC Santa Cruz and the Sunlight Foundation serving as a community archive project for public domain US legislative footage. We’re very proud to be working closely with Metavid on their important mission to make our (small-d) democratic public policy deliberations more widely accessible to the public. What’s more, because Metavid is also a Wiki and our data is connected, you can help improve video coverage on both sites by getting involved and participating in the effort to open up the Congressional process to the vital world of online video.
Here’s where you can find video footage throughout our site. On every page for senators and representatives, about halfway down we display the two most recent videos relevant to that Member, with links to “view all” – often upwards of 50 total videos per person, and growing. For people in Congress, my personal favorite video pages are Rep. Barney Frank’s (D-MA) and Rep. Ted Poe’s (R-TX). Since this is just the beginning of our video integration, only some of the most prominent bills are currently bringing in videos from Metavid – the Stimulus Bill being the best example as of now — and we hope you’ll help us expand our offerings by tagging videos with associated bills over at Metavid. Each video comes with descriptions of the title, speaker, date, and length, and here’s a tip: drag the indicator in the progress bar to skip ahead (or “seek” ahead) to a later point in the video, it loads pretty quickly.
Compare Bill Text
Building off our previous announcement of inline commenting on bill text, now it’s possible to compare different versions of a bill on the OpenCongress bill text viewer – where bills have been altered by the House or Senate, changes to the text will display in different colors and with strikethrough. At the top of the bill text, in the section for “Version History”, click the link to “Show Changes” wherever it appears — for example, see the Stimulus Bill, which received 3,244 changes in its final version. A good place to get started with commenting on specific sections of text (though there weren’t many changes to the bill) is the $410 billion Omnibus Spending Bill.
Read the Bill!
Finally, OpenCongress is proud to be a part of the Read The Bill campaign, kicked off by the Sunlight Foundation and endorsed by a variety of well-known organizations. From their About page: “Too often, controversial bills are voted on hours after coming to the House or Senate floor. There is no time for members of Congress to read the bill, and no chance for interested citizens to weigh in on the legislation. ReadTheBill.org’s mission is to strengthen our democracy by making sure elected officials and citizens have the chance to read and understand legislation.” As a first step, we encourage you to sign the petition: “Congress should change its rules to require that non-emergency legislation and conference reports be posted on the Internet for 72 hours before debate begins.”
To support this effort, OpenCongress dug into legislative data to create a page of Rushed Bills: bills in Congress for which the time of the full bill text being available to the time of the bill’s initial consideration is less than 72 hours. To track bills that haven’t had enough time to be openly scrutinized before debate begins, simply subscribe to the RSS feed on that page and help watchdog Congress. Let us know what you think of this common-sense campaign to open up the legislative process: writeus@opencongress.org.
Enjoy the Wiki and the videos! Compare and comment on bills you care about! Tell Congress to Read the Bill! And contribute your knowledge in the Wiki. As always, let us know what you think and how you’re using these new features!
Preview of OpenCongress Redesign
June 29, 2009 - by David Moore![]()
Today, at the Personal Democracy Forum conference, OpenCongress is announcing our biggest update yet, coming this summer: a complete site re-design, more data on “the money trail” in Congress, and new tools to engage with your elected officials. Everyone can be an insider.
Currently, OpenCongress works as a hub of conversation about bills and issues in Congress, but the upcoming redesign will make the site a more powerful organizing platform. If OpenCongress were a software project, we’d call it version 2.0, and we’re excited to get it out into the world.
Here are some screenshot previews of the redesign, along with quick ways for you to give your feedback and help spread the word. First, to the right, check out the new OC homepage in progress — click the image once to see it in full in a new browser window and again to enlarge:
… so fresh & so clean, the redesign improves the readability & usability of all the government data & social wisdom on our pages. We’re continually working toward the point where, instead of feeling overwhelmed or intimidated by government data, newcomers to politics feel more informed and empowered in the face of the legislative process.
Congress w/ Social Context
Second, our bill page interface has been redesigned with one of the primary aims being to foreground the interactive tools:
… the new right-hand sidebar presents easy access to tracking and voting features, built-in social sharing, and now, as below, the ability to write your elected officials directly from bill pages with your opinion on the bill:
… scrolling down back on this draft bill page, we’ve brought out and highlighted the social data on “Users Tracking This Bill” — what other bills and Members people are tracking, supporting, and opposing. This data, uniquely generated by the OpenCongress community, works like a “Six Degrees of OpenCongress” — find other topics of likely interest to you in the Congressional haystack, based on the associations of real people.
Watchdog Congress
Third, we’re especially excited to announce a new set of “Watchdog” features called as part of every free “My OpenCongress” profile:
… on your “Watchdog” tab, you can easily view your Senators’ and Representative’s latest actions, and compare your personal votes “aye/nay” on bills with their official votes on those bills’ passage. Watchdog tabs are accompanied by state- and Congressional district-specific portals to find your elected officials and what other users in your state are tracking, supporting, and opposing. These are significant steps towards our goal of taking OpenCongress more local and facilitating peer-to-peer constituent communication about the votes that matter to you.
More $$ Data
Fourth, we’re integrating more campaign contribution data to help the public follow “The Money Trail” throughout Congress. For Members of Congress, the redesigned site will show new levels of detail from OpenSecrets on which industries have donated to their campaigns. For bills, we’re now syndicating more info from MAPLight on interests that support and oppose the bill (e.g., the recent Climate Change Bill [H.R. 2454]). These are significant additions in making OpenCongress a more useful tool for combating corruption and building broad-based accountability.
Fifth, as part of the redesign launch we’ll be releasing the OpenCongress API, currently in beta. In short, the API provides web developers with automated access to all the data on OpenCongress in order to remix it for their own websites & online communities. In addition to official legislative data, the API offers a wealth of one-of-a-kind social data: bills most in the news & blogs, what’s popular in the Battle Royale, users tracking this bill are also tracking these bills, summaries of hot bills, and much more.
Wiki Knowledge
Sixth and last, the redesign will feature enhanced access to the shockingly useful content available on the OpenCongress Wiki — especially RaceTracker, the community project tracking every election for the U.S. House, the U.S. Senate, and governorship. This crowd-sourced project allows individuals to add information they know about who’s running for office in their district and state, as long as the info is referenced to an outside source. The result is a collaborative, non-partisan, rich web resource on everyone running for Congress in 2010 and beyond. The OC Wiki will also release a new project giving enhanced access to Congressional scorecards from issue-based organizations from a variety of backgrounds. On pages for Members of Congress, you’ll have over 30 scorecards at your fingertips with meaningful votes on important issues, as well as the ability to access all this structured data through semantic MediaWiki. For example, visit the wiki profile of Rep. Gary Ackerman (D-NY) & do a ‘find’ on “Congressional scorecards”.
Help Us Out!
Overall, by making our site more social and interactive, we’re working to make Congress more transparent and accountable. We’re interested in your feedback – to volunteer as a beta-tester and how the new features work for you, simply email us at w/ subject line “redesign”. In the weeks to come we’ll email you a preview link with further instructions on how to help. In the meantime, please help spread the word about our upcoming redesign — short link to Tweet, Digg post to Digg, or simply email this blog post to your friends. As always, OpenCongress is a 100% free, open-source, non-partisan, and not-for-profit joint project of Sunlight Foundation and the Participatory Politics Foundation. Can’t wait to see how individuals and organizations use the new site to get involved in the Congressional process. Thanks for using OpenCongress.

Blog - Articles Tagged 'OpenCongress'


