{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://trust.trustswiftly.com/schemas/documentation.schema.json",
  "title": "Trust Swiftly Documentation Overview",
  "description": "Overview of the documentation supplied by the provider for the cloud service offering (FedRAMP CDS-CSO-PUB). An overview only: it names the documentation sets, who can reach each one, and where. It is never a substitute for the documents themselves, and it must not describe anything not actually published — every public URL here is expected to resolve without authentication.",
  "type": "object",
  "required": ["updatedAt", "summary", "portal", "sets"],
  "additionalProperties": false,
  "properties": {
    "updatedAt": { "type": "string" },
    "summary": { "type": "string" },
    "portal": {
      "type": "object",
      "description": "The primary public documentation site.",
      "required": ["label", "url"],
      "additionalProperties": false,
      "properties": {
        "label": { "type": "string" },
        "url": { "type": "string", "format": "uri" }
      }
    },
    "sets": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "required": ["title", "access", "url", "summary"],
        "additionalProperties": false,
        "properties": {
          "title": { "type": "string" },
          "access": {
            "enum": ["public", "agency"],
            "description": "public = reachable without authentication. agency = shared with federal agency customers through the access-controlled agency trust center. There is deliberately no third value: anything not in one of those two places is not documentation this offering supplies, and must not be listed."
          },
          "url": { "type": "string", "format": "uri" },
          "summary": { "type": "string" }
        }
      }
    }
  }
}