Skip to content

docs: fix medium-severity inaccuracies in Actors pages#2726

Open
mtrunkat wants to merge 3 commits into
masterfrom
claude/docs-fix-actors-medium-8g4myu
Open

docs: fix medium-severity inaccuracies in Actors pages#2726
mtrunkat wants to merge 3 commits into
masterfrom
claude/docs-fix-actors-medium-8g4myu

Conversation

@mtrunkat

@mtrunkat mtrunkat commented Jul 2, 2026

Copy link
Copy Markdown
Member

Corrects medium-severity discrepancies across 26 Actors pages found by auditing the docs against the platform source (apify-core, apify-worker). Highlights:

  • Labels/UI: Container URL -> Live view URL; Standby tab -> Endpoints tab; API tab flow; review menu labels; publish button label; task-limit wording.
  • Values: default Dockerfile (actor-node:20, simplified) and cache-example base image; aes-256-gcm -> aes-256-ctr for secret input; readme search order; PayPal/Wise payout thresholds.
  • Behavior/undocumented: dataset validation fieldStatistics in the 201 response; subscription-plan memory cap step; systemInfo event and persistState.isAborting; run/build origins (CI, MCP); resurrection terminal state SUCCEEDED; Standby default configuration in Settings.
  • New env-var rows: ACTOR_MAX_PAID_DATASET_ITEMS, APIFY_PROXY_HOSTNAME; new Web Unblocker unit-cost row; Insights dashboard replacing the removed Analytics tab.

Note: the high-severity card-link and pay-per-result fixes that also touch programming_interface/index.mdx and running/store/index.md are in the companion Actors high-severity PR.


Generated by Claude Code

Corrects labels, values, and descriptions across 26 Actors pages to match
platform behavior, and documents previously undocumented fields/behaviors
(e.g. ACTOR_MAX_PAID_DATASET_ITEMS, APIFY_PROXY_HOSTNAME, systemInfo event,
subscription-plan memory cap). High-severity card-link and pay-per-result
fixes on programming_interface/index.mdx and running/store/index.md are
handled in the Actors high-severity PR.
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 1670b7e) is ready at https://pr-2726.preview.docs.apify.com (see action run).

@mtrunkat mtrunkat added the adhoc Ad-hoc unplanned task added during the sprint. label Jul 2, 2026

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 Actors documentation pages to correct audited medium-severity inaccuracies, primarily aligning UI labels, platform behaviors, and technical details with the current Apify Console and runtime behavior.

Changes:

  • Updates Console/UI terminology and flows (e.g., Endpoints tab, Live view URL, API dropdown steps, review/report field labels).
  • Refreshes technical/platform specifics (run/build origins including CI and MCP, system events payloads, encryption cipher name, dataset validation response details, default Dockerfile example, new environment variables).
  • Aligns publishing/monetization docs (Insights dashboard naming/URL, payout thresholds, unit-cost table additions, deprecation automation timeline, task publishing limits).

Reviewed changes

Copilot reviewed 27 out of 27 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
sources/platform/actors/running/store/reviews.mdx Updates the review reporting UI field label.
sources/platform/actors/running/runs_and_builds.md Adds new Origin values and updates resurrection terminal status terminology.
sources/platform/actors/running/actor_standby.md Renames Standby UI references to Endpoints and documents default configuration behavior.
sources/platform/actors/publishing/testing.mdx Updates automated test expectations (status requirement).
sources/platform/actors/publishing/publish.mdx Updates the publish button label text to match Console.
sources/platform/actors/publishing/publish-task.mdx Clarifies the limit as “public tasks” rather than tasks in general.
sources/platform/actors/publishing/monetize/pricing_and_costs.mdx Adds Web Unblocker unit-cost row to the pricing table.
sources/platform/actors/publishing/monetize/index.mdx Updates payout thresholds and replaces Analytics wording with Insights dashboard info.
sources/platform/actors/publishing/index.mdx Updates monetization model wording and adds a rental sunsetting partial.
sources/platform/actors/publishing/actor-status.mdx Clarifies the automated deprecation timeline based on failing tests.
sources/platform/actors/publishing/actor-rating.mdx Updates “edit reply” UI action text.
sources/platform/actors/development/quick-start/start_locally.md Fixes cd command formatting in the quick start.
sources/platform/actors/development/programming_interface/system_events.md Updates/extends system event definitions and payload structure documentation.
sources/platform/actors/development/programming_interface/index.mdx Fixes the “Basic commands” card description to match its contents.
sources/platform/actors/development/programming_interface/environment_variables.md Adds new documented env vars for pay-per-result and proxy hostname.
sources/platform/actors/development/programming_interface/container_web_server.md Renames Container URL to Live view URL to match Console.
sources/platform/actors/development/performance.md Updates the caching example base image version.
sources/platform/actors/development/index.md Fixes an internal link to the Performance section.
sources/platform/actors/development/deployment/source_types.md Clarifies dockerContextDir behavior for monorepos.
sources/platform/actors/development/deployment/continuous_integration.md Updates Console navigation for finding API endpoints.
sources/platform/actors/development/actor_definition/web_server_schema/index.md Renames Standby tab references to Endpoints tab in schema docs.
sources/platform/actors/development/actor_definition/output_schema/index.md Corrects output schema API keying note and updates consoleRunUrl format.
sources/platform/actors/development/actor_definition/input_schema/secret_input.md Updates the documented cipher for secret input encryption.
sources/platform/actors/development/actor_definition/dynamic_actor_memory/index.md Documents subscription-plan max-memory capping behavior.
sources/platform/actors/development/actor_definition/docker.md Updates the documented default Dockerfile (base image + simplified steps).
sources/platform/actors/development/actor_definition/dataset_schema/validation.md Documents fieldStatistics presence in successful dataset validation responses.
sources/platform/actors/development/actor_definition/actor_json.md Updates README discovery order (adds .actor/ACTOR.md and README without extension).

|`SCHEDULER`|Using a schedule|
|`WEBHOOK`|Using a webhook|
|`ACTOR`|From another Actor run|
|`STANDBY`|From [Actor Standby](./standby)|
| Event name | Payload | Description |
| --- | --- | --- |
| `cpuInfo` | `{ isCpuOverloaded: Boolean }` | Emitted approximately every second, indicating whether the Actor is using maximum available CPU resources. |
| `systemInfo` | `{ memAvgBytes, memCurrentBytes, memMaxBytes, cpuAvgUsage, cpuMaxUsage, cpuCurrentUsage: Float, isCpuOverloaded: Boolean }` | Emitted approximately every second with the run's current memory and CPU usage statistics. |
claude added 2 commits July 2, 2026 20:20
Revert the code-point re-alignment of the emoji-headed table (markdownlint
MD060 measures visual width); keep only the prose fix on this page.
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