Skip to content

docs: fix high and medium inaccuracies in collaboration and access pages#2728

Open
mtrunkat wants to merge 2 commits into
masterfrom
claude/docs-fix-collaboration-8g4myu
Open

docs: fix high and medium inaccuracies in collaboration and access pages#2728
mtrunkat wants to merge 2 commits into
masterfrom
claude/docs-fix-collaboration-8g4myu

Conversation

@mtrunkat

@mtrunkat mtrunkat commented Jul 2, 2026

Copy link
Copy Markdown
Member

Corrects high- and medium-severity discrepancies in the collaboration and access docs, verified against apify-core.

  • organization_account/index.md - organization limit is 10 per owner (not 5); added that Creator-plan accounts can't be converted to organizations.
  • list_of_permissions.md - added the missing Actor Build permission; renamed "Manage access keys" -> "Manage access tokens" and "Update subscription" -> "Manage billing" to match the code; removed the non-grantable "Reset password" row; added "View payouts" and "View monetization".
  • organization_account/setup.md - organization security settings live under the separate Security & Privacy tab, not the Account tab.
  • general-resource-access.md - storage access-level label is "Anyone with ID or name can read".

Generated by Claude Code

general-resource-access.md:
- Correct storage-only access level label to "Anyone with ID or name can read"

list_of_permissions.md:
- Add missing "Build" permission to the Actor table
- Rename "Manage access keys" to "Manage access tokens"
- Rename "Update subscription" to "Manage billing"
- Remove non-grantable "Reset password" user permission
- Add "View payouts" and "View monetization" user permissions

organization_account/index.md:
- Fix organization creation limit from 5 to 10
- Document that Creator-plan accounts can't be converted to organizations

organization_account/setup.md:
- Move security settings from the Account tab to the "Security & Privacy" tab
Copilot AI review requested due to automatic review settings July 2, 2026 20:01
@apify-service-account

apify-service-account commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

✅ Preview for this PR (commit 3b7fff7) is ready at https://pr-2728.preview.docs.apify.com (see action run).

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates Apify collaboration/access documentation to correct several high- and medium-severity factual inaccuracies (limits, UI locations, permission names/coverage, and storage access-level wording) to better match the current platform behavior.

Changes:

  • Corrected organization-account guidance (organization creation limit, conversion constraints, and where security settings live in Console).
  • Updated the permissions reference to include the missing Actor Build permission and align naming with the product (“access tokens”, “billing”, etc.).
  • Fixed the storage sharing access-level label for named storages.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 5 comments.

File Description
sources/platform/collaboration/organization_account/setup.md Updates where organization security settings are configured; minor wording cleanup needed.
sources/platform/collaboration/organization_account/index.md Updates org creation limit and adds Creator-plan conversion restriction; minor wording precision needed.
sources/platform/collaboration/list_of_permissions.md Adds Actor Build permission and updates organization/user permission labels to match product naming.
sources/platform/collaboration/general-resource-access.md Corrects the label for the named-storage extra access level; minor grammar cleanup needed.

Comment thread sources/platform/collaboration/organization_account/setup.md
Comment thread sources/platform/collaboration/organization_account/setup.md
Comment thread sources/platform/collaboration/organization_account/index.md
Comment thread sources/platform/collaboration/list_of_permissions.md Outdated
Comment thread sources/platform/collaboration/general-resource-access.md
@mtrunkat mtrunkat added the adhoc Ad-hoc unplanned task added during the sprint. label Jul 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

adhoc Ad-hoc unplanned task added during the sprint.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants