org.anthers.post

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "content": {
      "description": "WHATEVER OF THIS POST ANYBODY MAY READ — which is the whole of an ungated post, and the public part of one that is not. Defined that way rather than as `the post` on purpose: if a post can later be put behind a gate, a field meaning `the post` would quietly come to mean something narrower, and a consumer built on the first meaning would misread the second without anything detecting it. Optional, because a post may be a single image with no words at all, and because a gated post may choose to reveal nothing.",
      "properties": {
        "format": {
          "description": "How to read `value`. `markdown` is what Anthers writes. Carried explicitly because a consumer that renders the wrong format shows syntax to a reader and nothing detects it — and because the alternative, changing what a bare string means later, is a break the evolution rules do not catch. An open set, so a plain-text-and-facets rendering or anything else may join without a new schema.",
          "knownValues": [
            "markdown"
          ],
          "maxLength": 64,
          "type": "string"
        },
        "value": {
          "description": "The content itself. Markdown rather than plain text with facets: facets annotate byte ranges and cannot express a heading, a list, a fenced code block or an image at a position, all of which an Anthers post may contain. Images and other media are referenced by absolute URL rather than carried here. The limits are deliberately far above what Anthers itself accepts, because a length limit can never be raised once published — new data must stay valid under the old schema — so a limit set to today's product rule would become tomorrow's ceiling.",
          "maxGraphemes": 100000,
          "maxLength": 1000000,
          "type": "string"
        }
      },
      "required": [
        "format",
        "value"
      ],
      "type": "object"
    },
    "main": {
      "description": "A post by a creator — an announcement, a devlog, a note to an audience. Posts are written by creators; a reader's contributions are comments, reviews and votes rather than posts of their own. A post is long-form: it may carry headings, lists, code, quotes and images, which is why its content is markdown rather than the plain text and facets a microblog post uses.",
      "key": "tid",
      "record": {
        "properties": {
          "content": {
            "ref": "#content",
            "type": "ref"
          },
          "publishedAt": {
            "description": "When the post went live. This is the post's own date rather than the record's: a post may be drafted long before it is published, and a record written by a later backfill would otherwise claim the backfill's date. Record-creation time is already encoded in the record key, so this field exists only because the two genuinely differ.",
            "format": "datetime",
            "maxLength": 64,
            "type": "string"
          },
          "url": {
            "description": "Where the post can be read. Deliberately not assumed to be an anthers.org address, because a creator's writing outliving any one host is the point. Required, because a post whose content is withheld must still say where to go.",
            "format": "uri",
            "maxLength": 2048,
            "type": "string"
          }
        },
        "required": [
          "url",
          "publishedAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "org.anthers.post",
  "lexicon": 1
}