How to Review a Specification as a Holly User

Last updated: November 18, 2026

How to read through a specification, leave comments or suggested edits, and mark your review complete. This article is for reviewers with a Holly account.

If you don't have a Holly account, see 📄 How to Review a Specification in Holly as an External Reviewer instead. For background on how the approval workflow fits together, see 📄 How Holly's Approval Workflow Works.


Getting Started

Click the link in your email notification to open the specification. Your email includes the name of the specification and may include a note from the document owner about what they'd like you to focus on. If you aren't already logged in, you'll be prompted to log in first and then redirected to the specification.

The specification opens on the Spec editor tab, which is where you'll do all of your editing, commenting, and reviewing. When you open a review, you're in Suggesting mode. Any change you type becomes a suggested edit for the document owner to accept or reject, and you can leave comments at the same time.

Can't type or add comments? Your step may be read-only. In a read-only review, you can't edit the spec or comment on the text. Leave your feedback in the note when you submit your review. See 📄 How to Complete a Read-Only Review.

Show edits

Turn on Show edits to see every suggested change in the document. Added text is underlined and removed text is struck through, with a different color for each reviewer. Use the filter to see edits from all users or only your own.


Providing Feedback

You have two ways to leave feedback, and they serve different purposes.

Comments

Use comments for questions, concerns, or feedback that doesn't require a specific text change. To add one, select the text you're commenting on or click + Add comment in the Comments panel on the right, then write your comment and submit.

Comments show up in the Comments panel, where a filter dropdown lets you focus on what matters most:

  • Open: Comments and suggestions that haven't been resolved, accepted, or rejected yet

  • Resolved: Comments marked as handled. Resolved comments appear greyed out in the document.

  • Accepted: Suggestions the document owner has approved

  • Rejected: Suggestions the document owner has declined

  • All: Everything, useful for reviewing the full history

Comments from external reviewers show the name they entered when they opened the review.

Suggested Edits

Use suggested edits when you know exactly what the text should say. Edit the text directly: additions appear underlined and deletions appear as strikethrough. The document owner sees each suggestion and can accept or reject it individually.


Completing Your Review

Once you've added all your feedback, click Submit review. You'll see a window where you can optionally add a public note, a general comment not tied to any specific section. It's useful for a summary thought like "Looks good, just flagged a couple of questions on the qualifications section." Click Submit.

The workflow can't advance to the next step until everyone assigned to your step has finished their review, so don't skip this even if you're done adding feedback.


Next Steps

After you finish your review, the document owner will work through the feedback from your step and either respond, accept, or reject what you've submitted.