-
Notifications
You must be signed in to change notification settings - Fork 10
Fundamental needs and preferences
Summarized in August 2021
- Multiple views of the regulations (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 regulations (the common term may be different than the regulatory term).
- Multiple options for navigating the regulations depending on what they’re doing and their level of familiarity with the particular piece of regulation.
- Ability to trust that less experienced people will interpret the regulations 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.
- Get into the regulations and supplementary content quickly, without having to wade through less relevant material or UI elements
- Be able to share information easily
Summarized in June 2021
- Users primarily use laptops for regulation research over the reg book. Many people use at least one external monitor.
- There isn't a standard process to research policy information: everyone develops their own process.
- Some people have been trained by the reg book, others by eCFR.
- People ask each other questions on how best to find information, especially as they are starting out in their role.
- Currently, people can find and read all of the regulations that they need to access.
- DSG and policy makers currently use eCFR, LII and the Medicaid.gov's [Federal Policy Guidance](https://www.medicaid.gov/federal-policy-guidance/index.html.
- However, analyzing regulations can be a very manual process requiring people to cross-reference multiple sources no matter which tool they currently use.
- People often save a lot of information locally or use browser bookmarks to aid in re-findability.
- People writing regs may print and annotate regulations text as part of their research and writing process.
- We don't know how much the pandemic has affected people's relationship to the regs (using the book, printing, etc.). One or two people we've talked with mentioned that they used to use their reg book at the office, but left it at their desk after shifting to working from home.
- People tend to research policy using multiple tabs and windows on multiple monitors for more information.
- People primarily want current regulatory guidance, as well as relevant regulation resources, such as sub-regulatory guidance
- However, historical guidance that tracks policy changes over time is helpful and will be heavily accessed
- People will benefit from demonstrations of new features and training sessions and/or documentation on eRegulations capabilities
Summarized in June 2021
- eRegulations users are across the Centers for Medicaid and CHIP (both DSG and the policy groups).
- Different departments within DSG have different needs for their tools.
- eRegulations should look like it lives in the same world as Medicaid.gov, and ideally, live within the site itself
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