History, present, and future

We would like other agencies, developers, and groups to use eRegulations and adapt it. Here’s some insight into the current status of the project and where it’s going.


CFPB released its initial version of eRegulations in 2013, and 18F and ATF began reusing it for ATF in 2015.

A few news clippings that also discuss motivations for eRegulations:

  • Federal Source Code Policy: Achieving Efficiency, Transparency, and Innovation through Reusable and Open Source Software, August 2016, The White House: “18F and the Consumer Financial Protection Bureau (CFPB): Both of these organizations have policies that establish a default position to publish source code that is custom-developed by or for the organization. For example, both organizations contribute to the source code for the eRegulations platform, a web-based interface for public viewing and commenting on proposed changes to Federal regulations. The eRegulations platform, which originated at CFPB, is being used by other Federal agencies and continues to be improved based on public feedback;”
  • PDF Version of the Memorandum
  • The People’s Code

  • EPA Tests Future of Public Comments, July 2016, Nextgov: “An Environmental Protection Agency pilot lets citizens comment on specific paragraphs of proposed rules instead of submitting them via email or in a separate text box. It might seem like a minor feature that should have existed before, but EPA is among the first to test drive it, according to a blog post from General Services Administration tech consultancy, 18F. Since last year, 18F and the Consumer Financial Protection Bureau have been gradually adding new features to the eRegulations system, an open source platform that hosts proposals online.”

  • Want to Make Digital Government Work? Hire your Own Coders, January 2014, Nextgov: “By using hypertext and modern Web design, they thought, regulators could make proposed rules more available and comprehensible to the general public and reduce busy work for industry attorneys and activists who spend hours parsing through regulations each day…‘Where it’s going really depends on what we hear from the public, largely from the compliance industry and other folks that have to use regulations on a day to day basis as part of their jobs,’ Yuda said. ‘What we hear from those people will guide not just how we go forward with this but whether we go forward. If we hear it’s useful, then we’ll continue. If we hear that it’s not, then we have limited resources and we need to invest those in areas where we’re going to be providing value to the American public.’”

  • CFPB’s eRegulations tool promises to help users navigate federal regulations, October 2013, Administrative Conference of the US: “By opening eRegulations up to suggestions and improvements from the public, CFPB is allowing hands-on contribution to the debate over what sources are appropriately considered as a part of regulatory interpretation.”

  • One Federal Website That Works, October 2013, BloombergView: “Texts of official government rules are notoriously difficult to follow. Multiple cross-references to other rules make it necessary to consult many different resources. Experienced rule readers can find official interpretations; others can’t. CFPB’s new user-friendly site makes all available information visible and easily accessible…By focusing on users’ experience of the site, they built something that works well for real people. And the platform will constantly be upgraded because it’s open source – meaning that any agency or company can adopt it free and improve on it.”

A few places eRegulations has been presented to larger audiences:

  • Presented eRegulations Notice & Comment to The White House Open Data Innovation Summit (WHODIS), September 2016
  • Presented eRegulations Notice & Comment to The White House’s South by South Lawn City Summit, October 2016
  • Presented eRegulations Platform to the Canadian Community of Federal Regulators, October 2016
  • Presented eRegulations Notice & Comment at Gov Executive’s Festival on Bold Friday, October 2016
  • Presented eRegulations Notice & Comment to NARA Open Gov Working Group, November 2016

eRegs has also been cited in the White House’ Open Government Action Plans:

  • The second plan highlighted the initial launch of the eRegs platform at CFPB as a step towards expanding public participation in the development of regulations.
  • CFPB’s and ATF’s eRegs instances and Notice & Comment tools were noted in the self-assessment of that plan.
  • The third plan highlighted the potential of the Notice & Comment pilot.
  • The self-assessment of that plan describes the eRegs projects at ATF & FEC, along with the Notice & Comment pilot.

Present and future

Scope of eRegulations

eRegulations only covers Code of Federal Regulations parts right now. But each agency’s regulations are only one piece of their regulatory material.

Each agency creates a lot of related documents that aren’t included in the Code of Federal Regulations: both authoritative material (such as advisory opinions, rulings, and Federal Register notice preambles) and less-formal explanations that help people learn what they need to know (such as guidebooks and FAQs).

eRegulations could better integrate with that related material (as well as the relevant statutes in the United States Code) to help users understand regulations.

A challenge is that each agency has its own collection of materials related to its regulations - with some types of documents in common with other agencies and some unique to one agency. Some agencies use different names for similar types of documents.

A few examples:

  • CFPB includes “official interpretations” in its regulations (as an appendix to the main part of the regulation, all published together in the Code of Federal Regulations). CFPB also includes “section-by-section analysis” in its Federal Register notices. CFPB’s eRegulations displays both of those types of material to help readers understand regulations.
  • ATF publishes “rulings” and “open letters” that clarify aspects of its regulations. It also publishes plain-language Q&As, newsletters, and guidebooks to help explain its regulations. ATF’s eRegulations only has a small amount of cross-linking with related resources, and it could do a lot more in the future.
  • FEC publishes “advisory opinions” and “Matters Under Review” that clarify aspects of its regulations, among other kinds of material.

Relatedly, we’ve recently kicked off an effort to apply eRegs learnings to the Office of Management and Budget’s policy documents.

How it works

Code and documentation explains this in more detail, but in short: the parser eats XML from many different sources and writes that to an API. The UI then reads from that API.

There is currently one UI for eRegulations, but the intent is for the parser to be usable outside of this one interface into regulations, and for the API to be usable outside of this one interface.

For example, people could build a regulations authoring tool with a different UI. Some regulatory agencies have specific needs that may require a different UI.

The current codebase is somewhat tangled together, since there is just one UI right now, but supporting flexibility is an important ongoing goal.

Advice for ongoing cross-agency development

Everyone is free to use and adapt eRegulations as they wish. We encourage you to build your adaptation in the open (and with a public domain + CC0 license), and to build it in close coordination with other contributors, so everyone can benefit from each other’s work.

Working with the shared codebase and building agency-specific features

If you develop features or improvements that would benefit other agencies who use eRegulations, it makes sense to contribute them to the core cross-agency shared code libraries, which are regulations-core, regulations-site, and regulations-parser. We don’t have a very good “raw” eRegulations right now, though we’re slowly moving there. “Raw” eRegulations is basically CFPB eRegulations right now.

At this point, you would probably never run regulations-site or regulations-core on their own. Instead, they’re libraries, and you can modify them as libraries. Effectively, you point a wrapper to local checkouts. For an example of a wrapper, see atf-eregs.

Adding agency-specific styles, markup, and even certain types of features (specific to those agencies) should not require modifications to the core repositories. Instead, those can go in the agency-specific wrapper.

Share or fork the codebase? Specific features or generalizable features?

Each reuse of eRegulations faces a tradeoff: fork the codebase, or make the effort to work to share the main codebase? Build features specific to the agency, or try to build more generically reusable features even if it takes more time?

It’s important to plan to use the shared codebase and to build features that are relatively reusable — and to balance this vision with the pragmatic needs of your budget.

The work to make it generalizable is good for each agency. Each agency benefits from the generalizing work of previous agencies, and all clients will themselves benefit when, inevitably, they produce regulations in the future with quirks that will be easier to handle within an extensible/generalizable system.

We are not sure yet how long-term cross-agency maintenance will work. We’ll figure it out together.