Lexicon Garden

dev.knotless.comment

Kept in the commenter's account; for a private repository, in their repo inside the repository's space.

Repository @lexicons.knotless.dev did:plc:yqsg7znbbhfmj3a2nrpnaerk namespace authority
Details · record, key tid
Kindrecord
Record keytid
Authorityknotless.dev
Indexed
Compare Edit in builder → Fork →

Record

record · key tid

Properties

attachments

array

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.

  • maxLength: 32
itemsunion
One of

body

requiredstring

Markdown.

  • maxLength: 20000

commit

string

The hex object ID of the head commit a review looked at, or that a comment's `line` is in.

  • minLength: 40
  • maxLength: 64

createdAt

requiredstring · datetime

dismisses

string · at-uri

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.

facets

array

The accounts its body mentions, by where: written as it is, from each `@handle` outside code and links.

  • maxLength: 50
itemsref
Reference

line

ref

For a comment on a pull's diff, the lines it is on, in the file as it was at `commit` on that side.

Reference

reply

string · at-uri

The dev.knotless.comment, with a `line`, whose thread this answers. An answer has no `line` of its own.

repo

requiredref

The repository the pull or issue is on.

Reference

review

string · at-uri

The review, a dev.knotless.comment, this was sent with as one of its line comments, all in one write.

subject

requiredstring · at-uri

The dev.knotless.pull or dev.knotless.issue commented on.

updatedAt

string · datetime

When its author last changed its body.

verdict

string

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.

  • maxLength: 64
  • knownValues: approve | changes

#lineRef

object

Lines of a file in a pull's diff, as GitHub's review comments name them.

Properties

line

requiredinteger

The last line commented on, counting from 1.

  • minimum: 1

path

requiredstring

The file's path on the side commented on.

  • maxLength: 1024

side

string

`new`, the side the pull brings in, or `old`, the side it leaves, for lines it removes. Absent, `new`.

  • maxLength: 16
  • knownValues: old | new

startLine

integer

The first, for more than one line; no later than `line`.

  • minimum: 1

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • dev.gitosphere.repository.pullRequestComment

    record

    A comment or typed finding bound to one Pull Request round. body is its canonical Markdown.

  • dev.knotless.createComment

    procedure

    Comments on a pull or an issue, or on lines of a pull's diff, or answers a comment, or reviews a pull, as the account logged in to this appview's pages.

  • dev.gitosphere.repository.issueComment

    record

    A comment on one Issue. body is its canonical Markdown.

  • dev.knotless.issue

    record

    An issue on a repository, kept in its author's account.

  • dev.gitosphere.repository.pullRequestThreadDecision

    record

    A verdict on a blocking Pull Request thread, bound to the round it was given in. Comment records are immutable, so verdicts accumulate as separate records. Whether a verdict decides the thread or only proposes is derived from its author's role when it is read: the thread's author and repository admins decide; the Pull Request author can only propose addressed or noLongerApplies.