-
Notifications
You must be signed in to change notification settings - Fork 11
Audiences
Focus for pilot stage:
- CMCS Staff - such as Business Analysts, Policy Analysts, and State Officers
- Especially people whose responsibilities include consistent and accurate interpretation of regulations in order to answer questions (including from states), analyze materials (such as State Plan Amendments), and develop documents (such as guidance, briefing materials, and proposed regulations)
- CMCS Leadership - including group leadership
May also benefit from pilot stage:
- CMCS Contractors who may need to review or learn about regulations as part of their work, such as people working on systems that implement policy-related requirements
Potential future audiences:
- State Staff
- Such as Policy Analysts
- State Contractors
- Such as IT Developers
- Managed Care Organizations
- Fee-for-Service Providers
- People in the broader public
- Foundations + Non-Profits
- Advocates
- Journalists
- Attorneys
Needs
- Multiple views of the regs (i.e. section, subpart, part). They want to conceptually zoom in and out with larger and smaller amounts of information, and search in browser via CTRL-F.
- An understanding of how comprehensive the information they’re reading is. Are they looking at all the supplementary content available or just some amount of it? Is anything missing?
- The ability to look for words/phrases that may not actually be in the regs (the common term may be different than the regulatory term).
- Multiple options for navigating the regs depending on what they’re doing and their level of familiarity with the particular piece of reg.
- Ability to trust that less experienced people will interpret the regs correctly based on what they see, and that misinterpretations will not arise based on the information provided.
- An understanding of how current our information is and when it was last updated.
Goals
- Get into the regs and supplementary content quickly, without having to wade through less relevant material or UI elements
- Be able to share information easily
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