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

> Suggestions let readers propose edits to page content without editing the page directly. Authors review each suggestion and accept or reject it.

# Suggestions

# Suggestions

Suggestions are a way for people to propose changes to a page's content without having edit access. When someone submits a suggestion, the original content stays untouched. The page author reviews the suggested change and chooses to accept or reject it.

Suggestions are different from comments. A comment is a note attached to a page. A suggestion is a proposed change to the actual text of the page — and accepting it is still a manual action by the author or an editor.

## How suggestions work

A reader selects text on a page and clicks the **Suggest Change** button that appears in the toolbar. They write their proposed replacement text, add an optional explanation, and submit. The suggestion appears as a pending thread anchored to the selected text.

The page does not change immediately. The suggestion stays in a **Pending** state until the page author or an editor reviews it and either accepts or rejects it.

## Suggestion status

| Status       | Meaning                                                                                                  |
| ------------ | -------------------------------------------------------------------------------------------------------- |
| **Pending**  | The suggestion has been submitted and is waiting for the author's review. The page content is unchanged. |
| **Accepted** | The author accepted the suggestion. The proposed change was applied to the page manually by the author.  |
| **Rejected** | The author dismissed the suggestion. The page content is unchanged.                                      |

<Note>
  Accepting a suggestion does not automatically rewrite the page content. It marks the suggestion as accepted and closes the thread. The actual edit still needs to be made by an editor. Think of "Accept" as confirming the change is a good idea, not as an automated text replacement.
</Note>

## Making a suggestion

<Steps>
  <Step title="Open the page">
    Navigate to the page you want to suggest a change on. You need at least view access to the page.
  </Step>

  <Step title="Select the text">
    Highlight the text you want to propose a change to. A small toolbar appears above the selection.
  </Step>

  <Step title="Click Suggest Change">
    Click the **Suggest Change** button (shown as a comment with a pencil icon) in the selection toolbar.
  </Step>

  <Step title="Write your suggestion">
    A panel opens on the right side of the page. Type the replacement text you are proposing and add an explanation in the comment field. Be specific — explain why you are suggesting the change so the author understands your intent.
  </Step>

  <Step title="Submit">
    Click **Submit suggestion**. The suggestion appears as a pending thread anchored to the selected text. The page author is notified.
  </Step>
</Steps>

## Reviewing and accepting a suggestion

<Steps>
  <Step title="Open the suggestions panel">
    Open the page. Pending suggestions are shown as highlighted anchors in the text and listed in the right sidebar under the **Suggestions** tab. You can also reach them from the notification you received when the suggestion was submitted.
  </Step>

  <Step title="Read the suggestion">
    Click a suggestion to expand it. You can see who submitted it, when it was submitted, which text it refers to, what change is being proposed, and any explanation they added.
  </Step>

  <Step title="Accept the suggestion">
    Click **Accept** to mark the suggestion as accepted. Then manually apply the proposed change to the page text. The suggestion thread closes and the suggester is notified.
  </Step>
</Steps>

## Rejecting a suggestion

<Steps>
  <Step title="Open the suggestion">
    Click the suggestion in the sidebar or directly on its anchor in the page text.
  </Step>

  <Step title="Reject it">
    Click **Reject**. The suggestion is dismissed and the page content is not changed. The suggester receives a notification that their suggestion was rejected.
  </Step>

  <Step title="Add a reason (optional)">
    Before clicking Reject, you can add a reply to the suggestion thread explaining why you are rejecting it. This is helpful for the suggester and keeps the discussion visible in the thread history.
  </Step>
</Steps>

## Replying to a suggestion

Both the page author and the suggester can reply to a suggestion thread before a decision is made. This is useful for clarifying intent or discussing alternatives.

* Click the suggestion to expand it.
* Type your reply in the comment field at the bottom of the thread.
* Click **Reply**. The other party is notified.

Replies do not change the suggestion status — it remains Pending until explicitly accepted or rejected.

## Notifications

| Event                       | Who receives the notification           |
| --------------------------- | --------------------------------------- |
| Suggestion submitted        | The page author and all page editors    |
| Suggestion accepted         | The person who submitted the suggestion |
| Suggestion rejected         | The person who submitted the suggestion |
| Reply added to a suggestion | The other party in the thread           |

All notifications appear in the notification bell at the top of the screen and link directly to the relevant suggestion on the page.