-
Notifications
You must be signed in to change notification settings - Fork 11
Frontend caching
Note: For a long time, we had this cache configured to 8 hours. As of June 2024, we turned off caching to minimize confusion for SMEs editing content.
When you view a regulation page on eRegulations, the website "caches" certain bits of data for that page - in other words, it saves a copy of the data in a tiny file on your computer (as part of a hidden browser storage folder). That tiny cache file expires (gets automatically deleted) at a configurable time, so people should see fresh data periodically.
Pros:
- If you view a page and then refresh it or load it again in a little while, resources load instantly. This is intended to be a good experience for users doing research, especially anyone on a slower internet connection.
Cons:
- When a SME views a regulation page, then tags a resource intended to show up in the sidebar for that page, and then views the page again a minute later, it'll show the old version from the cache.
- A user doing research may not see brand-new links until their next work day.
The devs can adjust the length of time for caching or turn it off.
- You can open an incognito window to see new material: Ctrl-Shift-N (Windows) or Command-Shift-N (mac OS) in Chrome or Edge.
- You can go to our cache-clearing tool (add
/cache/
to the end of our URL, like this:https://example.com/cache/
), scroll to the end, and choose "delete all cache items".
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