Skip to main content

Reviews

A review is the moment your work leaves the solo-draft stage and enters an approval process. It's the equivalent of opening a pull request — but inside RuleForge, with the right content and context for the reviewer.

When to open a review​

Open a review when:

  • content is ready for evaluation by someone else;
  • your project policy requires approval before publishing;
  • you want a formal record of who requested changes and who approved.

For personal drafts or exploration, use a workspace — it stays with you until you decide otherwise.

How a review moves​

A review goes through these stages:

  • Draft — you're still preparing.
  • In review — you've requested evaluation; reviewers can comment.
  • Changes requested — the reviewer pointed out adjustments.
  • Approved — the review has been accepted and the content can move to publishing.
  • Published — the matching version has been published.

The interface indicates the current stage on each review.

Step by step​

  1. In the project, click New review.
  2. Give it a short title and describe the goal (for example, "SSH detections — May").
  3. Confirm the content has already been validated and, if applicable, that regression is clean.
  4. Assign who should review.
  5. Wait for analysis. Comments appear on the review screen itself.
  6. After approval, create the version and publish.

Best practices​

  • Write goals and context — this saves rounds of back-and-forth.
  • Answer comments by marking each one as resolved.
  • Resolve change requests before asking for another round.
  • Keep reviews short and focused; giant reviews tend to sit idle.

Common questions​

"I can't approve the review"​

Your current role may allow commenting but not approving. See Roles and permissions or ask the person responsible to adjust.

"The review is approved but publishing is still blocked"​

Reviews handle the editorial part, but publishing also depends on:

  • validation with zero errors;
  • clean regression;
  • minimum quality score (if your policy requires it).

See the versions and quality criteria tab to find which criterion is pending.

"My organization doesn't have the reviews screen"​

The feature depends on the plan. See Billing and plans.