-
Notifications
You must be signed in to change notification settings - Fork 10
Home
eRegulations is a web application that reduces the time and effort required for Medicaid and CHIP staff to find, read, and analyze relevant statute, regulations, guidance, internal policy reference materials, and other policy information related to to Medicaid and CHIP. By providing a comprehensive and easy-to-use policy reference tool with powerful cross-referencing and search options, this application radically improves the speed and efficiency of work such as:
- Drafting and reviewing drafts of proposed rules, guidance, technical assistance, and other policy materials
- Reviewing and responding to submissions from state Medicaid and CHIP agencies, such as State Plan Amendments
- Answering technical assistance questions from state Medicaid and CHIP agencies
- Training staff, including new staff and transfers
The Center for Medicaid & CHIP Services started this project in September 2020 because existing resources for regulatory and subregulatory research were not meeting the needs of CMCS staff, especially being able to find all relevant policy materials for a particular topic without having to spend significant time and effort searching for and compiling resources.
Key ways that CMCS eRegulations is different from existing services and resources:
- Brings many kinds of related policy resources into context with each other, instead of being the publisher of only a specific category of policy information
- Focus on validated CMCS requirements, not a general publisher of information that has to serve the basic needs of a wide range of agencies
CMCS staff adopt eRegulations as part of their work because they decide it helps them find what they need.
This instance of eRegulations is based on open source software developed by CFPB and GSA - for another example, see ATF eRegulations. This code remains open source, so it is free for reuse and adaptation by government agencies and the public, including businesses. It minimizes cost of setup, maintenance, and operation through techniques including:
- Maximizing use of mature open source software packages, such as PostgreSQL, Django, and Vue.js
- Serverless architecture on AWS, using Lambda, RDS, and S3
- GitHub Actions (free for open source projects) with automated tests and deployment
- Using public APIs from eCFR, the Federal Register, and GovInfo.gov
Our team puts notes and documentation into this wiki to help us maintain a shared understanding of our work, including what we've done and why. It's public in case anything in here is helpful to other teams, including anyone who may be interested in reusing this code.
Notes from other teams that worked on earlier iterations of the eRegulations open source code:
Please note that all pages on this GitHub wiki are draft working documents, not complete or polished.
Our software team puts non-sensitive technical documentation on this wiki to help us maintain a shared understanding of our work, including what we've done and why. As an open source project, this documentation is public in case anything in here is helpful to other teams, including anyone who may be interested in reusing our code for other projects.
For context, see the HHS Open Source Software plan (2016) and CMS Technical Reference Architecture section about Open Source Software, including Business Rule BR-OSS-13: "CMS-Released OSS Code Must Include Documentation Accessible to the Open Source Community".
For CMS staff and contractors: internal documentation on Enterprise Confluence (requires login).
- Federal policy structured data options
- Regulations
- Resources
- Statute
- Citation formats
- Export data
- Site homepage
- Content authoring
- Search
- Timeline
- Not built
- 2021
- Reg content sources
- Default content view
- System last updated behavior
- Paragraph indenting
- Content authoring workflow
- Browser support
- Focus in left nav submenu
- Multiple content views
- Content review workflow
- Wayfinding while reading content
- Display of rules and NPRMs in sidebar
- Empty states for supplemental content
- 2022
- 2023
- 2024
- Medicaid and CHIP regulations user experience
- Initial pilot research outline
- Comparative analysis
- Statute research
- Usability study SOP
- 2021
- 2022
- 2023-2024: 🔒 Dovetail (requires login)
- 🔒 Overview (requires login)
- Authentication and authorization
- Frontend caching
- Validation checklist
- Search
- Security tools
- Tests and linting
- Archive