markchipman / uslm

United States Legislative Markup (USLM) XML Schema

GPO released Beta USLM XML in the draft 2.0 schema on the govinfo Bulk Data Repository for enrolled bills from the 113th Congress forward, public laws from the 113th Congress forward, and the Statutes at Large from the 108th Congress forward. For enrolled bills, the Beta USLM XML is available in addition to the existing Bill DTD XML. The Beta USLM XML uses the same file naming convention as the Bill DTD XML but the Beta USLM XML is in a /bulkdata/BILLS/uslm/ folder. We also made the Beta USLM XML available on the govinfo website through "USLM" buttons and in the ZIP files. Beta USLM XML will be added to the govinfo API and Link Service in an upcoming release. See the proposed branch for more information.

Version 2.0.4 of the schema is now available in the proposed branch.

USLM Schema

In support of the United States Legislative Branch XML Working Group and in accordance with 2 U.S.C. 181, the Government Publishing Office (GPO) is making the United States Legislative Markup (USLM) XML schema available as an authoritative source on GitHub.

Versions

The current version of the schema is in the master branch. If there are any proposed changes to the schema, the changes will be in a proposed branch. A major.minor.point structure is used to identify the version, and the version is recorded as an attribute at the root level. The point number is incremented to indicate a non-breaking change while the minor number is incremented to indicate a breaking change. Breaking changes will only be implemented after all other options have been exhausted. Please refer to CHANGELOG.md for a summary of proposed and approved changes.

Draft USLM 2.0 Schema

The proposed branch contains the draft USLM 2.0 schema, a schema review guide, sample USLM enrolled bill files, CSS files, and additional schema required to validate the sample files. Additional sample files for public laws, the Statutes at Large, the Federal Register, and the Code of Federal Regulations will be added in the coming weeks.

To submit feedback, questions, or comments, please open a GitHub issue.

User Guide and Review Guide

Please refer to the User Guide in PDF or Markdown and Review Guide in Markdown for additional information about the schema.