> ## Documentation Index
> Fetch the complete documentation index at: https://docs.criminal.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Suggestions

> Members post ideas, everyone votes, staff deliver a verdict with a reason.

Suggestions post into a channel you choose and carry persistent 👍/👎 buttons. Votes are stored per
member, so counts survive restarts and a member can't vote twice.

## Setup

```text theme={null}
/config channel suggestion-channel #suggestions
```

Until that's set, `/suggest` replies with a warning telling you which setting to change.

## Posting

```text theme={null}
/suggest suggestion:"Add a movie night channel"
```

The text must be between 10 and 1,500 characters. The bot posts it as the next numbered suggestion
(`#14`, say), tells you the number and the channel, and pins nothing.

## Voting

One vote per member, and voting again on the same button **removes** your vote rather than switching
it. Clicking the other button moves your vote across.

Voting closes the moment staff issue a verdict: the buttons are replaced with a static tally marked
"voting closed".

## Staff verdicts

```text theme={null}
/suggestion approve 14 "Great idea, we'll set it up this week."
/suggestion deny 14 "We already have one."
/suggestion implemented 14 "Shipped in the last update."
```

| Status | Meaning |
| - | - |
| `pending` | Default; voting is open |
| `approved` | Accepted, not shipped yet |
| `denied` | Rejected, reason optional |
| `implemented` | Shipped |

The optional reason is rendered under the suggestion as **Reason**, attributed to the staff member
who set it, and the original post is edited in place · so the history of a suggestion reads top to
bottom.

## Browsing

```text theme={null}
/suggestion list
/suggestion list status:approved
```

Paginated, six per page, newest first, capped at the last 100 suggestions. Each entry shows the
status, author, a 110-character preview, the vote split and when it was posted.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.