Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions src/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@
- [Behind Upstream](./triagebot/behind-upstream.md)
- [Canonicalize Issue Links](./triagebot/canonicalize-issue-links.md)
- [Close](./triagebot/close.md)
- [Concern](./triagebot/concern.md)
- [Documentation Updates](./triagebot/doc-updates.md)
- [GitHub Releases](./triagebot/github-releases.md)
- [Issue Links](./triagebot/issue-links.md)
Expand Down
38 changes: 38 additions & 0 deletions src/triagebot/concern.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# Concern

The `concern` command is used to formally register a concern at the top comment of a GitHub issue/PR.

## Usage

A concern can be registered by writing a comment with the command:

```text
@rustbot concern my concern title
```

The concern is then added in the top comment of the GitHub issue to a special section: `Concerns` (which should *not* be edited by hand).

*Concerns can only be registered by member of the organization and cannot be registered on active [rfcbot FCPs](https://rfcbot.rs).*

### Resolving a concern

Concerns can be resolved by writing a comment with the command:

```text
@rustbot resolve my concern title
```

The concern is then strikethrough and a link to the comment resolving the concern is added next to it.

## Configuration

This feature is enabled by having a `[concern]` table in `triagebot.toml`:

```toml
[concern]
labels = ["has-concerns"] # optional, list of labels to be added to the issue/PR when there are un-resolved concerns
```

## Implementation

See [`parser/src/command/concern.rs`](https://github.com/rust-lang/triagebot/blob/HEAD/parser/src/command/concern.rs) and [`src/handlers/concern.rs`](https://github.com/rust-lang/triagebot/blob/HEAD/src/handlers/concern.rs).