garden.lexicon.documentation

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "definitionDoc": {
      "description": "Documentation for a definition within a lexicon.",
      "properties": {
        "description": {
          "description": "Localized descriptions for this definition.",
          "items": {
            "ref": "#localizedString",
            "type": "ref"
          },
          "type": "array"
        },
        "name": {
          "description": "The name of the definition being documented (e.g., 'main', 'replyRef').",
          "maxLength": 512,
          "type": "string"
        },
        "properties": {
          "description": "Documentation for properties within this definition.",
          "items": {
            "ref": "#propertyDoc",
            "type": "ref"
          },
          "type": "array"
        }
      },
      "required": [
        "name"
      ],
      "type": "object"
    },
    "localizedString": {
      "description": "A string with an associated language code.",
      "properties": {
        "lang": {
          "description": "ISO 639 language code (e.g., 'en', 'es', 'ja').",
          "format": "language",
          "type": "string"
        },
        "value": {
          "description": "The localized string value.",
          "maxLength": 10000,
          "type": "string"
        }
      },
      "required": [
        "lang",
        "value"
      ],
      "type": "object"
    },
    "main": {
      "description": "Auxiliary documentation for a lexicon schema, supporting localized descriptions for the lexicon and its properties.",
      "key": "nsid",
      "record": {
        "properties": {
          "createdAt": {
            "description": "Timestamp when this documentation was created.",
            "format": "datetime",
            "type": "string"
          },
          "definitions": {
            "description": "Documentation for specific definitions within the lexicon (e.g., main, replyRef).",
            "items": {
              "ref": "#definitionDoc",
              "type": "ref"
            },
            "type": "array"
          },
          "description": {
            "description": "Localized descriptions for the lexicon.",
            "items": {
              "ref": "#localizedString",
              "type": "ref"
            },
            "type": "array"
          },
          "lexicon": {
            "description": "The NSID of the lexicon being documented.",
            "format": "nsid",
            "type": "string"
          }
        },
        "required": [
          "lexicon",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    },
    "propertyDoc": {
      "description": "Documentation for a specific property within a definition.",
      "properties": {
        "description": {
          "description": "Localized descriptions for this property.",
          "items": {
            "ref": "#localizedString",
            "type": "ref"
          },
          "type": "array"
        },
        "name": {
          "description": "The property name being documented.",
          "maxLength": 256,
          "type": "string"
        }
      },
      "required": [
        "name"
      ],
      "type": "object"
    }
  },
  "id": "garden.lexicon.documentation",
  "lexicon": 1
}