{ "lexicon": 1, "defs": { "lineRef": { "description": "Lines of a file in a pull's diff, as GitHub's review comments name them.", "properties": { "line": { "description": "The last line commented on, counting from 1.", "minimum": 1, "type": "integer" }, "path": { "description": "The file's path on the side commented on.", "maxLength": 1024, "type": "string" }, "side": { "description": "`new`, the side the pull brings in, or `old`, the side it leaves, for lines it removes. Absent, `new`.", "knownValues": [ "old", "new" ], "maxLength": 16, "type": "string" }, "startLine": { "description": "The first, for more than one line; no later than `line`.", "minimum": 1, "type": "integer" } }, "required": [ "path", "line" ], "type": "object" }, "main": { "description": "Kept in the commenter's account; for a private repository, in their repo inside the repository's space.", "key": "tid", "record": { "properties": { "attachments": { "description": "What it carries beside its body: the pictures the body shows. Kinds unknown to a reader are passed over, and kept by a client changing it.", "items": { "refs": [ "dev.knotless.defs#image" ], "type": "union" }, "maxLength": 32, "type": "array" }, "body": { "description": "Markdown.", "maxLength": 20000, "type": "string" }, "commit": { "description": "The hex object ID of the head commit a review looked at, or that a comment's `line` is in.", "maxLength": 64, "minLength": 40, "type": "string" }, "createdAt": { "format": "datetime", "type": "string" }, "dismisses": { "description": "The review, a dev.knotless.comment with a verdict on the same pull, this dismisses, its body saying why. From the repository's owner or a collaborator, the review stops counting toward the pull's reviews, for or against it, until its reviewer reviews again; one from anyone else changes nothing.", "format": "at-uri", "type": "string" }, "facets": { "description": "The accounts its body mentions, by where: written as it is, from each `@handle` outside code and links.", "items": { "ref": "dev.knotless.defs#facet", "type": "ref" }, "maxLength": 50, "type": "array" }, "line": { "description": "For a comment on a pull's diff, the lines it is on, in the file as it was at `commit` on that side.", "ref": "#lineRef", "type": "ref" }, "reply": { "description": "The dev.knotless.comment, with a `line`, whose thread this answers. An answer has no `line` of its own.", "format": "at-uri", "type": "string" }, "repo": { "description": "The repository the pull or issue is on.", "ref": "dev.knotless.defs#repoRef", "type": "ref" }, "review": { "description": "The review, a dev.knotless.comment, this was sent with as one of its line comments, all in one write.", "format": "at-uri", "type": "string" }, "subject": { "description": "The dev.knotless.pull or dev.knotless.issue commented on.", "format": "at-uri", "type": "string" }, "updatedAt": { "description": "When its author last changed its body.", "format": "datetime", "type": "string" }, "verdict": { "description": "Present on a review: `approve`, or `changes` to ask for changes. Readers take each reviewer's latest as where they stand, and none from the pull's author.", "knownValues": [ "approve", "changes" ], "maxLength": 64, "type": "string" } }, "required": [ "repo", "subject", "body", "createdAt" ], "type": "object" }, "type": "record" } }, "description": "A comment on a pull or issue. With a verdict it is a review; with a line, a comment on lines of a pull's diff, starting a thread there; with a reply, an answer in such a thread.", "id": "dev.knotless.comment" }