Skip to content

Create and edit an issue

  1. Select New issue.
  2. Choose the Repository. This cannot be changed after the issue exists — GitHub has no way to move an issue between repositories through its API.
  3. Fill in the title and the body.
  4. Optionally set labels, assignees, a milestone, a project and its field values.
  5. Select Create issue.

The issue is created in GitHub first. Only when GitHub returns it does it appear in Pealboard. If GitHub refuses — a missing permission, a repository the installation does not cover, a label that no longer exists — you see GitHub’s refusal and nothing was created.

Today, every issue is authored as pealboard[bot] with a line naming you, whether or not you have linked your GitHub account in Account → Linked GitHub. Linking is required before an organization can be connected to a workspace; writing issues and comments as you, rather than as the app, is not available yet.

Open an issue and edit the title or body in place. Labels, assignees, milestone and project fields are in the Fields panel on the right. Every change is a write to GitHub, applied as soon as you leave the control.

Editing shows the same optimistic behavior as the board: the value changes immediately and moves back with GitHub’s refusal if GitHub does not accept it.

Close an issue as Completed or as Not planned, which are GitHub’s own two reasons. Both are shown to portal customers as a status word: Completed maps to Completed and Not planned maps to Closed. Reopening sets the status back to whatever the rules derive.

  • Move an issue to another repository.
  • Delete an issue. GitHub’s API cannot delete issues; close it instead.
  • Edit a comment somebody else wrote.
  • Convert an issue to a discussion or a pull request.