docs: Document Actor reviews#2580
Open
szaganek wants to merge 1 commit into
Open
Conversation
szaganek
added
documentation
Contributor
|
✅ Preview for this PR (commit |
TC-MO
reviewed
Jun 1, 2026
Contributor
TC-MO
left a comment
TC-MO
left a comment
There was a problem hiding this comment.
Few questions before approval. Small structural and wording bits.
Comment on lines
+33
to
+35
| ### Edit your reply | ||
|
|
||
| To edit your response, on your reply, select **Options** > **Edit**. |
Contributor
There was a problem hiding this comment.
Do we really need a one sentence section? Wouldn't it be better to fold it into one?
|
|
||
| ## About the Actor rating | ||
|
|
||
| Your Actor's rating isn't a pure average of all reviews. Instead, it's a weighted average that includes the following factors: |
Contributor
There was a problem hiding this comment.
Doesn't it make more sense to lead in with what it is? Or is the weighted average an actual assumption that community has and we want to dispel that explicitly?
Suggested change
| Your Actor's rating isn't a pure average of all reviews. Instead, it's a weighted average that includes the following factors: | |
| Your Actor's rating is a weighted average that includes the following factors: |
|
|
||
| If you believe that a review doesn't follow the community standards, you can report it. For details, see [Report a review](/platform/actors/running/reviews#report-a-review). | ||
|
|
||
| Note that the support team verifies all reports and only deletes the reviews that violate Apify policies. Users can share their experience even if it's negative. Here are some invalid reasons for reporting a review: |
Contributor
There was a problem hiding this comment.
Admonition feels more natural here, doesn't it?
Suggested change
| Note that the support team verifies all reports and only deletes the reviews that violate Apify policies. Users can share their experience even if it's negative. Here are some invalid reasons for reporting a review: | |
| :::note Report verification | |
| The support team verifies all reports and only deletes the reviews that violate Apify policies. Users can share their experience even if it's negative. | |
| ::: | |
| Here are some invalid reasons for reporting a review: | |
| - To only rate the Actor, use the star rating. | ||
| - To rate and review the Actor, select **Write review**. | ||
|
|
||
| If you have a problem with the Actor that you're reviewing, consider also [opening an issue](/platform/actors/running/actors-in-store#report-issues-with-actors). |
Contributor
There was a problem hiding this comment.
also feels redundant here
Suggested change
| If you have a problem with the Actor that you're reviewing, consider also [opening an issue](/platform/actors/running/actors-in-store#report-issues-with-actors). | |
| If you have a problem with the Actor that you're reviewing, consider [opening an issue](/platform/actors/running/actors-in-store#report-issues-with-actors). |
|
|
||
| 1. On a review, select **Options** > **Report**. | ||
| 1. In **Reason for reporting**, select the right [category from a dropdown list](#reason-for-reporting). | ||
| 1. _(Optional)_ In **Additional details**, add a comment to the report. |
Contributor
There was a problem hiding this comment.
nit: If that is optional, wouldn't making it a sub-item in 2nd item be better than completely separate point?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #20981.