Questions on an issue

A comment on an issue can be a question. An open question is never folded out of a long thread: it stays on the page, in view, until someone settles it. Pulls have no questions; a review asking for changes is their standing request.

Who may: the comment's author, or anyone who writes in the repository. Mirrors are read-only here.

Web: tick "Ask as a question" beside the Comment button when posting. A question reads "Question, open" under its comment with a Settle button; a settled one reads "Question, settled" with Ask again. An ordinary comment has no control, so a long thread carries none on its rows. To mark an existing comment, use the API.

API: POST /api/v1/repos/:owner/:name/issues/:number/comments/:id/question with { "state": "open" | "settled" | "none" } (none takes the mark off). Needs a rw token: 401 without one, or for someone who may not change that comment; 400 for any other state; 404 for a comment that is not on that issue. The answer is the comment, with question.

Terminal: on an issue, Q opens the composer as "Question" and posts the comment as an open question (if the mark is refused the toast says so); z settles the newest open question, or says "no open question".

Pinned by test/thread-window.test.ts (the fold, the page) and test/question-api.test.ts (the API, the terminal).

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs