# Revision History

##### Document Revision History

The OSCAL revision history requires one FedRAMP extension to meet FedRAMP’s revision history requirements.

The revision history’s author information is derived from FedRAMP’s `party-uuid` flag, which points to a metadata `party` UUID value. The published field accepts the NIST OSCAL data type format. For details, see date-time-with-timezone on the NIST website.

<div class="callout">
<i><b>Note:</b></i> FedRAMP OSCAL requires only the publication date, not the time. You may replace the time portion with all zeros.
FedRAMP tools should present only the date in a user-friendly format.
</div>

The `remarks` field is a Markup multiline format, which enables formatting of text and requires special handling.

##### Representation
```yaml
revisions:
- published: '2025-03-30T00:00:00Z'
  version: '1.0'
  oscal-version: '1.1.3'
  props:
  - name: party-uuid
    ns: http://fedramp.gov/ns/oscal
    value: 9f411fde-00b2-45b4-8043-129da20ce6dd
  remarks: Initial publication.

  roles:
  - id: prepared-by
    title: Prepared By
    description: Cloud Service Provider

  parties:
  - uuid: 9f411fde-00b2-45b4-8043-129da20ce6dd
    type: organization
    name: Cloud Service Provider

  responsible-parties:
  - role-id: cloud-service-provider
    party-uuids:
    - 9f411fde-00b2-45b4-8043-129da20ce6dd
  - role-id: prepared-by
    party-uuids:
    - 9f411fde-00b2-45b4-8043-129da20ce6dd
```