Answer a repository audit's questions

During an audit, an investigation can ask your team a question the repository alone cannot answer, such as whether another service changes the data it reads. Answer it on the audit's report so the investigation can use what you know.

A running audit's Investigations tab shows one answered question and an open question with a draft in Your answer.
Each question sits under the investigation that asked it. Fictional demo workspace.

Find the questions#

Open Repositories, choose the repository, select Audits in its sidebar, then select the audit's commit to open its report. Select the Investigations view. Each question appears under the investigation that asked it, oldest first.

Send an answer#

You need write access to the repository on GitHub. Without it, Proofline refuses the answer and shows the reason beside the question.

  1. Under an open question, write your reply in Your answer.
  2. Select Send answer.

Your answer then appears under the question with your name and the time you sent it. You cannot edit an answer or send a second one, so include everything the investigation should know.

An investigation keeps working while its questions are open and reads each answer at its next step. Answer while the investigation is still running: once it ends, its questions close, and an answer it has not read yet stays unread.

What each state means#

  • An answered question shows the answer, who gave it and when, and below it whether the investigation read it:
    • Read by the investigation means the investigation received the answer and continued its work with it.
    • Not yet read by the investigation means the investigation is still running and has not taken its next step since the answer arrived.
    • The investigation ended before it read this answer means the investigation or the audit ended first, so the answer did not shape its work.
  • Withdrawn: the investigation no longer needed an answer means the investigation stopped needing the answer before anyone sent one.
  • Unanswered means the investigation or the audit ended while the question was open, including when someone stopped the audit.

An answer is your team's statement, not evidence. It can point the investigation toward what to read, but a finding's evidence never rests on it. An unanswered question is never taken as a fact either way: the audit makes no assumption about what the answer would have been.

If Send answer reports that the question takes no answer, someone else answered it, or its investigation ended or withdrew it, after you started writing. The report shows the question's current state, and there is nothing more to send.

Search help

Tab to a result. Enter to open. Escape to close.