Skip to content

Commit 559e12a

Browse files
committed
docs: Delete Conslusions section from concepts
1 parent 4b2220d commit 559e12a

24 files changed

Lines changed: 28 additions & 144 deletions

docs/02_concepts/01_actor_lifecycle.mdx

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -103,7 +103,3 @@ Before triggering a reboot, persist any essential state externally (e.g., to the
103103
Update the status only when the user's understanding of progress changes - avoid frequent updates for every processed item. Detailed information should go to logs or storages (dataset, key-value store) instead.
104104

105105
<RunnableCodeBlock className="language-python" language="python">{StatusMessageExample}</RunnableCodeBlock>
106-
107-
## Conclusion
108-
109-
This page has presented the full Actor lifecycle: initialization, execution, error handling, rebooting, shutdown and status messages. You've seen how the SDK supports both context-based and manual control patterns. For deeper dives, explore the <ApiLink to="class/Actor">`Actor`</ApiLink> API reference, [guides](../guides/beautifulsoup-httpx), and [platform documentation](https://docs.apify.com/platform).

docs/02_concepts/02_actor_input.mdx

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -37,9 +37,3 @@ Actors commonly receive a list of URLs to process via their input. The <ApiLink
3737
The Apify platform supports [secret input fields](https://docs.apify.com/platform/actors/development/secret-input) that are encrypted before being stored. When you mark an input field as `"isSecret": true` in your Actor's [input schema](https://docs.apify.com/platform/actors/development/input-schema), the platform encrypts the value with the Actor's public key.
3838

3939
No special handling is needed in your code — when you call <ApiLink to="class/Actor#get_input">`Actor.get_input`</ApiLink>, encrypted fields are automatically decrypted using the Actor's private key, which is provided by the platform via environment variables. You receive the plaintext values directly.
40-
41-
## Conclusion
42-
43-
This page has shown how to read Actor input with <ApiLink to="class/Actor#get_input">`Actor.get_input`</ApiLink>, how to load URL sources with <ApiLink to="class/ApifyRequestList">`ApifyRequestList`</ApiLink>, and how secret input fields are decrypted automatically when you read them.
44-
45-
For more details on Actor input and how to define input schemas, see the [Actor input](https://docs.apify.com/platform/actors/running/input) and [input schema](https://docs.apify.com/platform/actors/development/input-schema) documentation on the Apify platform.

docs/02_concepts/03_storages.mdx

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,10 @@ import KvsIteratingExample from '!!raw-loader!roa-loader!./code/03_kvs_iterating
1717
import KvsPublicRecordExample from '!!raw-loader!roa-loader!./code/03_kvs_public_url.py';
1818
import RqExample from '!!raw-loader!roa-loader!./code/03_rq.py';
1919

20-
The `Actor` class provides methods to work either with the default storages of the Actor, or with any other storage, named or unnamed.
20+
The <ApiLink to="class/Actor">`Actor`</ApiLink> class provides methods to work either with the default storages of the Actor, or with any other storage, named or unnamed.
21+
22+
For details on storage types, see [Storage](https://docs.apify.com/platform/storage).
23+
2124

2225
## Types of storages
2326

@@ -186,9 +189,3 @@ To check if all the requests in the queue are handled, you can use the <ApiLink
186189
## Storage clients
187190

188191
Behind the scenes, the SDK uses storage clients to communicate with the storage backend. The appropriate client is selected automatically based on the runtime environment. On the Apify platform, data is persisted via the Apify API, while local runs use the filesystem. For most use cases, you don't need to think about storage clients at all. To learn about the available implementations, how to switch between a single and shared request queue, or how to configure a custom client, see [Storage clients](./storage-clients). For a deeper look at how storage clients work internally, see the [Crawlee storage clients guide](https://crawlee.dev/python/docs/guides/storage-clients).
189-
190-
## Conclusion
191-
192-
This page has covered the three storage types (datasets, key-value stores, and request queues): how they are emulated on the local filesystem, how to open named and unnamed storages, and how to read from and write to each through the `Actor` shortcuts and the storage classes. When multiple Actor runs need to process the same request queue, choose between a [single and shared request queue](./storage-clients#single-vs-shared-request-queue).
193-
194-
For comprehensive information about storage on the Apify platform, see the [storage documentation](https://docs.apify.com/platform/storage), including the pages on [datasets](https://docs.apify.com/platform/storage/dataset), [key-value stores](https://docs.apify.com/platform/storage/key-value-store), and [request queues](https://docs.apify.com/platform/storage/request-queue).

docs/02_concepts/04_actor_events.mdx

Lines changed: 3 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
id: actor-events
3-
title: Actor events & state persistence
3+
title: Actor events and state persistence
44
description: Handle platform events like state persistence and graceful shutdown in your Actors.
55
---
66

@@ -12,6 +12,8 @@ import ApiLink from '@theme/ApiLink';
1212

1313
During its runtime, the Actor receives Actor events sent by the Apify platform or generated by the Apify SDK itself.
1414

15+
For details, see also [System events](https://docs.apify.com/platform/actors/development/programming-interface/system-events) and [State persistence](https://docs.apify.com/platform/actors/development/state-persistence).
16+
1517
## Event types
1618

1719
A listener can optionally receive a single argument, a Pydantic model with the event's data. The following table lists the events, the type of that data object, and when each event is emitted.
@@ -102,9 +104,3 @@ You can optionally specify a `key` (the key-value store key under which the stat
102104
<RunnableCodeBlock className="language-python" language="python">
103105
{UseStateExample}
104106
</RunnableCodeBlock>
105-
106-
## Conclusion
107-
108-
This page has described the events emitted during a run (`SYSTEM_INFO`, `MIGRATING`, `ABORTING`, `PERSIST_STATE`, and `EXIT`): how to handle them with <ApiLink to="class/Actor#on">`Actor.on`</ApiLink>, and how to persist state automatically with <ApiLink to="class/Actor#use_state">`Actor.use_state`</ApiLink>.
109-
110-
For more details on platform events and state persistence, see the [system events](https://docs.apify.com/platform/actors/development/programming-interface/system-events) and [state persistence](https://docs.apify.com/platform/actors/development/state-persistence) documentation on the Apify platform.

docs/02_concepts/05_proxy_management.mdx

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -121,9 +121,3 @@ Make sure you have the `httpx` library installed:
121121
```bash
122122
pip install httpx
123123
```
124-
125-
## Conclusion
126-
127-
This page has explained how to manage proxies with the <ApiLink to="class/ProxyConfiguration">`ProxyConfiguration`</ApiLink> class: using Apify Proxy or your own servers, keeping sessions sticky across requests, configuring tiered proxy rotation, and feeding proxy settings from Actor input.
128-
129-
For full details on proxy configuration options, see the <ApiLink to="class/ProxyConfiguration">`ProxyConfiguration`</ApiLink> API reference and the [Apify Proxy documentation](https://docs.apify.com/proxy).

docs/02_concepts/06_interacting_with_other_actors.mdx

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,9 @@ import ApiLink from '@theme/ApiLink';
1515

1616
The Apify SDK lets you start, call, and transform (metamorph) other Actors directly from your Actor code. This is useful for composing complex workflows from smaller, reusable Actors.
1717

18+
For the full list of methods for interacting with other Actors, see the <ApiLink to="class/Actor">`Actor`</ApiLink> class in the API reference. For details on running Actors and Actor tasks on the platform, see [Actors](https://docs.apify.com/platform/actors) and [Actor tasks](https://docs.apify.com/platform/actors/tasks).
19+
20+
1821
## Actor start
1922

2023
The <ApiLink to="class/Actor#start">`Actor.start`</ApiLink> method starts another Actor on the Apify platform, and immediately returns the details of the started Actor run.
@@ -62,9 +65,3 @@ When you set `gracefully=True`, the platform sends `ABORTING` and `PERSIST_STATE
6265
<RunnableCodeBlock className="language-python" language="python">
6366
{InteractingAbortExample}
6467
</RunnableCodeBlock>
65-
66-
## Conclusion
67-
68-
This page has shown how to interact with other Actors from your code: starting a run with <ApiLink to="class/Actor#start">`Actor.start`</ApiLink>, waiting for it to finish with <ApiLink to="class/Actor#call">`Actor.call`</ApiLink> or <ApiLink to="class/Actor#call_task">`Actor.call_task`</ApiLink>, transforming a run with <ApiLink to="class/Actor#metamorph">`Actor.metamorph`</ApiLink>, and stopping one with <ApiLink to="class/Actor#abort">`Actor.abort`</ApiLink>.
69-
70-
For the full list of methods for interacting with other Actors, see the <ApiLink to="class/Actor">`Actor`</ApiLink> API reference. For more details on running Actors and Actor tasks on the platform, see the [Actors](https://docs.apify.com/platform/actors) and [Actor tasks](https://docs.apify.com/platform/actors/tasks) documentation.

docs/02_concepts/07_webhooks.mdx

Lines changed: 1 addition & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,7 @@ import ApiLink from '@theme/ApiLink';
1010
import WebhookExample from '!!raw-loader!roa-loader!./code/07_webhook.py';
1111
import WebhookPreventingExample from '!!raw-loader!roa-loader!./code/07_webhook_preventing.py';
1212

13-
Webhooks allow you to configure the Apify platform to perform an action when a certain event occurs. For example, you can use them to start another Actor when the current run finishes or fails.
14-
15-
You can learn more in the [documentation for webhooks](https://docs.apify.com/platform/integrations/webhooks).
13+
[Webhooks](https://docs.apify.com/platform/integrations/webhooks) allow you to configure the Apify platform to perform an action when a certain event occurs. For example, you can use them to start another Actor when the current run finishes or fails.
1614

1715
## Creating an ad-hoc webhook dynamically
1816

@@ -31,9 +29,3 @@ To ensure that duplicate ad-hoc webhooks won't get created in a case of Actor re
3129
<RunnableCodeBlock className="language-python" language="python">
3230
{WebhookPreventingExample}
3331
</RunnableCodeBlock>
34-
35-
## Conclusion
36-
37-
This page has shown how to create ad-hoc webhooks dynamically with <ApiLink to="class/Actor#add_webhook">`Actor.add_webhook`</ApiLink> and how to avoid creating duplicates across Actor restarts using the `idempotency_key` parameter.
38-
39-
For more information about webhooks, including event types and payloads, see the [Apify webhooks documentation](https://docs.apify.com/platform/integrations/webhooks).

docs/02_concepts/08_access_apify_api.mdx

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,3 @@ To create a completely new instance of the client (for example, to use a differe
3535
</RunnableCodeBlock>
3636

3737
This is useful when the Actor's own token is not the right one, for instance when acting on behalf of another user, or when you want different retry and timeout behavior than the shared `Actor.apify_client` instance.
38-
39-
## Conclusion
40-
41-
This page has shown how to reach the Apify API directly for platform features the SDK does not wrap. You can use the built-in client exposed by <ApiLink to="class/Actor#apify_client">`Actor.apify_client`</ApiLink>, or a freshly configured one created with <ApiLink to="class/Actor#new_client">`Actor.new_client`</ApiLink>.
42-
43-
For the full API client documentation, see the [Apify API Client for Python](https://docs.apify.com/api/client/python).

docs/02_concepts/09_logging.mdx

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -113,7 +113,3 @@ You can further decide whether you want to redirect just new logs of the ongoing
113113
<RunnableCodeBlock className="language-python" language="python">
114114
{RedirectLogExistingRun}
115115
</RunnableCodeBlock>
116-
117-
## Conclusion
118-
119-
This page has covered how the SDK logs through the `apify` logger: setting the log level, formatting output with <ApiLink to="class/ActorLogFormatter">`ActorLogFormatter`</ApiLink>, using the logger at each level, and redirecting logs from other Actor runs back into the parent run. For more on the underlying logging machinery, see Python's standard [`logging`](https://docs.python.org/3/library/logging.html) module documentation.

docs/02_concepts/10_configuration.mdx

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ import ApiLink from '@theme/ApiLink';
1313

1414
The <ApiLink to="class/Actor">`Actor`</ApiLink> class is configured through the <ApiLink to="class/Configuration">`Configuration`</ApiLink> class, which reads its settings from environment variables. When running on the Apify platform or through the Apify CLI, configuration is automatic — manual setup is only needed for custom requirements.
1515

16-
If you need some special configuration, you can adjust it either through the `Configuration` class directly, or by setting environment variables when running the Actor locally.
16+
If you need some special configuration, you can adjust it either through the `Configuration` class directly, or by setting [environment variables](https://docs.apify.com/platform/actors/development/programming-interface/environment-variables) when running the Actor locally.
1717

1818
To see the full list of configuration options, check the `Configuration` class or the list of environment variables that the Actor understands.
1919

@@ -65,9 +65,3 @@ The <ApiLink to="class/Actor#is_at_home">`Actor.is_at_home`</ApiLink> method ret
6565
<RunnableCodeBlock className="language-python" language="python">
6666
{PlatformDetectionExample}
6767
</RunnableCodeBlock>
68-
69-
## Conclusion
70-
71-
This page has shown how to configure an Actor through the <ApiLink to="class/Configuration">`Configuration`</ApiLink> class or environment variables, which options you are most likely to set yourself, and how to inspect the runtime environment with <ApiLink to="class/Actor#get_env">`Actor.get_env`</ApiLink> and <ApiLink to="class/Actor#is_at_home">`Actor.is_at_home`</ApiLink>.
72-
73-
For the full list of configuration options, see the <ApiLink to="class/Configuration">`Configuration`</ApiLink> API reference. For a complete list of environment variables available on the platform, see the [environment variables](https://docs.apify.com/platform/actors/development/programming-interface/environment-variables) documentation.

0 commit comments

Comments
 (0)