How usgpo/uslm works
Project Type and Purpose
• This is an open-source specification repository (“USLM Schema”) providing XML Schema Definition files (XSDs), CSS, documentation (PDF/Markdown), and sample XML bills.
• Its primary purpose is to define and version the United States Legislative Markup (USLM) schema, provide guides and samples, and manage proposed changes via Git branches.
File-Structure Analysis
• Top-level directories/files:
• Schema artifacts (uslm-*.xsd, mathml3-*.xsd, xhtml-*.xsd, xml.xsd, dc.xsd, etc.)
• Stylesheet (uslm.css, uslm-debug.css)
• Documentation (README.md, CHANGELOG.md, USLM-User-Guide.*, USLM-2_0* Review Guides, LICENSE.md, CONTRIBUTING.md)
• Sample data (bill-version-samples-september-2024/, previous/)
• Governance files (.gitignore, CODEOWNERS)
• No runtime code—this is a content/artifact repository.
• Branch strategy implied: main branch holds approved schema versions; proposed branch holds drafts.
README Insights
• Confirms schema versioning scheme (major.minor.point)
• Directs consumers to guides and samples
• Describes governance: how changes move from proposed → main → published on GovInfo