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

# Comments and suggestions

> Use CoDraft comments, suggesting mode, tracked changes, review display modes, and Sofie-assisted review.

Use comments and suggestions when a CoDraft needs review before text becomes final.

## Comments versus suggestions

| Use          | When                                                             |
| ------------ | ---------------------------------------------------------------- |
| Comments     | You need a question, note, review issue, or SME decision.        |
| Suggestions  | You want proposed text changes that can be accepted or rejected. |
| Direct edits | You are confident the change should be applied now.              |

Ask Sofie for the right review style.

```text theme={null}
Add comments where source support is missing. Do not rewrite the text yet.
```

```text theme={null}
Propose tracked changes for this section. Keep the original visible for review.
```

## Use Suggesting mode

<Steps>
  <Step title="Open the CoDraft">
    Open the document you want to review.
  </Step>

  <Step title="Switch Review Mode">
    Choose **Suggesting** when changes should be proposed instead of applied directly.
  </Step>

  <Step title="Make or request edits">
    Edit yourself or ask Sofie to propose changes.
  </Step>

  <Step title="Review suggestions">
    Use **Previous Suggestion** and **Next Suggestion** to move through proposed changes.
  </Step>

  <Step title="Accept or reject">
    Use **Accept Current Suggestion**, **Reject Current Suggestion**, **Accept All Suggestions**, or **Reject All Suggestions**.
  </Step>
</Steps>

<Warning>
  Do not use **Accept All Suggestions** until you have reviewed the changes against the source material.
</Warning>

## Use review display modes

Review display options can include:

| Mode           | Use it for                                     |
| -------------- | ---------------------------------------------- |
| **All Markup** | See comments, suggestions, and changes.        |
| **Original**   | Compare against the starting text.             |
| **No Markup**  | Read a cleaner version without visible markup. |

Use **All Markup** before export or review handoff.

## Ask Sofie to add comments

Comments are useful for review questions.

Good prompts:

```text theme={null}
Add comments where the draft makes unsupported claims, lacks source references, or needs SME confirmation.
```

```text theme={null}
Review this section and comment on unclear acceptance criteria, missing rationale, and places where causal language is too strong.
```

```text theme={null}
Add comments for the document owner. Do not change the text directly.
```

## Ask Sofie to propose suggestions

Suggestions are useful for wording changes.

Good prompts:

```text theme={null}
Propose tracked changes to make this section neutral and source-backed. Do not remove open questions.
```

```text theme={null}
Suggest revisions that separate observations from conclusions.
```

```text theme={null}
Propose a clearer table heading and column labels for this evidence table.
```

## Review with filters

Use the review pane filters to focus:

* **All** for a complete review.
* **Comments** for questions and discussion.
* **Changes** for suggested edits.

Work through comments before accepting final wording. Comments often identify source gaps that suggestions cannot resolve.

## Use Sofie for a review pass

Ask for a structured review before export.

```text theme={null}
Review this CoDraft. Return and add comments for unsupported statements, missing source references, inconsistent terminology, unresolved placeholders, unclear acceptance criteria, and sections needing SME confirmation.
```

For tracked changes:

```text theme={null}
Propose tracked changes for tone and clarity only. Do not change technical meaning, acceptance criteria, source references, or conclusions.
```

## Resolve review items

Before export:

* Switch to **All Markup**.
* Review open comments.
* Review every suggestion.
* Save a revision.
* Ask Sofie to list unresolved review items.
* Confirm the exported version is the intended version.

Prompt:

```text theme={null}
List all remaining comments, unresolved suggestions, placeholders, and source gaps that should be addressed before export.
```