Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
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 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 automaticaly 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).