-
Notifications
You must be signed in to change notification settings - Fork 10
Export data
This page is mainly intended for team members who want to learn about ways to work with our content, although it could also be of interest to anyone reusing the codebase for a new project.
Go to /api/swagger/
to see our API documentation. This tells you the API endpoints that our developers use to pull information into our frontend website. The endpoints provide data in JSON format.
APIs for retrieving non-sensitive information (such as regulation text and metadata about Federal Register documents) do not require authentication/authorization.
APIs for modifying information or retrieving internal information (such as uploaded files) are controlled by Django authorization management, which is hooked to CMS SSO authentication.
Go to /sitemap.xml
to see a list of regulation pages in the site. We don't use this for anything right now. Note: As of February 2024, this only includes regulation subparts from one title, but we support multiple titles now, so this is missing some info.
We previously had an RSS feed with all of our links to public documents, including Federal Register documents, at /latest/feed/
.
We built this to tell Search.gov about the public content we wanted them to automatically index, using their supplemental content feature. We stopped using Search.gov, and our user audience doesn't use RSS feeds, so when we refactored some related features, we removed this instead of updating it.
We previously had a /resources/
page with a Download CSV button. The goal was to enable users to do their own advanced searching, sorting, filtering, and annotation. We retired the resources page but would like to rebuild this button later.
If you clicked that button, it downloaded metadata about all supplemental content and Federal Register documents into a CSV, one row for each document. Then you could open that CSV in Excel or Google Sheets. (Although special characters, such as em dashes and curly quotes, got displayed in a corrupted way in the CSV.)
- In Excel, go to "advanced search" and search for a file extension, like .doc (which catches both .doc and .docx), to find out how many Word doc links we have.
- Sort the URL column A-Z, then scroll up and down to get a quick sense of how many items we have from websites other than Medicaid.gov.
- Turn on filters, select the Name field, and uncheck "null". Click the column header and look at the count (in the bottom status bar) to find out how many items we have with names.
We built Import JSON and Import CSV options in our admin panel for importing supplemental content metadata in bulk, but they were rarely used and hard to maintain, so we removed them.
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