feat: Various improvements (#1820)

This PR bundles a number of improvements to the docs, in various places,
that I've done over time.

---------

Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Author: jancurn

apify-api/openapi/openapi.yaml

@@ -122,7 +122,7 @@ info:
     ```
 
     However, there are a few explicitly described exceptions, such as
-    Dataset [Get items](#/reference/datasets/item-collection/get-items) or
+    [Get dataset items](#/reference/datasets/item-collection/get-items) or
     Key-value store [Get record](#/reference/key-value-stores/record/get-record)
     API endpoints, which return data in other formats.
     In case of an error, the response has the HTTP status code in the range of

apify-api/openapi/paths/actor-tasks/actor-tasks@{actorTaskId}@runs.yaml

@@ -153,7 +153,7 @@ post:
     To fetch the Actor run results that are typically stored in the default
     dataset, you'll need to pass the ID received in the `defaultDatasetId` field
     received in the response JSON to the
-    [Get items](#/reference/datasets/item-collection/get-items) API endpoint.
+    [Get dataset items](#/reference/datasets/item-collection/get-items) API endpoint.
   operationId: actorTask_runs_post
   parameters:
     - name: actorTaskId

apify-api/openapi/paths/actors/acts@{actorId}@runs.yaml

@@ -167,7 +167,7 @@ post:
 
     To fetch the Actor run results that are typically stored in the default
     dataset, you'll need to pass the ID received in the `defaultDatasetId` field
-    received in the response JSON to the [Get items](#/reference/datasets/item-collection/get-items)
+    received in the response JSON to the [Get dataset items](#/reference/datasets/item-collection/get-items)
     API endpoint.
   operationId: act_runs_post
   parameters:

apify-api/openapi/paths/datasets/datasets@{datasetId}@items.yaml

@@ -1,7 +1,7 @@
 get:
   tags:
     - Storage/Datasets
-  summary: Get items
+  summary: Get dataset items
   description: |
     Returns data stored in the dataset in a desired format.
 

sources/academy/build-and-publish/actor-ideas/what_software_an_actor_can_be.md

@@ -36,14 +36,21 @@ Examples:
 
 ### SaaS API wrappers
 
-These Actors wrap existing SaaS services as Actors to make them accessible through the Apify platform and its many integrations.
+These Actors wrap existing SaaS services as Actors to make them accessible through the Apify platform and its many integrations, potentially with additional services built on top.
 
-Examples:
+Example Actors:
 
 - [OpenRouter](https://apify.com/apify/openrouter)
 - [Parsera](https://apify.com/parsera-labs/parsera)
 - [Super Scraper API](https://apify.com/apify/super-scraper-api)
 
+For inspiration, see:
+
+- [RapidAPI Hub](https://rapidapi.com/hub)
+- [Google Cloud APIs](https://cloud.google.com/apis)
+- [\{API\}Market](https://api.market/)
+- [openapi](https://openapi.com/products)
+
 ### Open-source libraries
 
 Many open-source automation or data processing tools do not have a presence in the cloud, and need to be installed locally in "just five easy steps". Wrap those tools as Actors and make it easy for users to try and integrate those tools.
@@ -117,10 +124,16 @@ Build Actors that use LLMs to perform complex tasks autonomously. These Actors c
 :::note Secure execution
 
 Actors are cloud-based sandboxes that can securely run any AI-generated code.
+As LLMs are [generally better](https://www.anthropic.com/engineering/code-execution-with-mcp)
+at generating code than selecting tools, one can use Actors to generate task-specific code and
+expose it using Actor interface to other apps and agents.
 
 :::
 
-For inspiration, check out the [Agents category](https://apify.com/store/categories/agents) in Apify Store.
+For inspiration, see:
+
+- [Agents category](https://apify.com/store/categories/agents) in Apify Store
+- [agent.ai marketplace](https://agent.ai/)
 
 ### Other
 
@@ -190,5 +203,6 @@ Beyond the [Actor ideas](https://apify.com/ideas) page, you can find new Actor i
 - Your experience: Draw from problems you've encountered in your work
 - Community discussions: Browse Reddit, Twitter, Stack Overflow, and forums for user pain points
 - Competitor analysis: Research existing tools and identify gaps
+- Other portals, such as [Indiehackers](https://www.indiehackers.com/), [Superframeworks](https://superframeworks.beehiiv.com/t/startup-ideas), etc.
 
 Once you get one, learn how to [validate your Actor idea](/academy/build-and-publish/actor-ideas/actor-validation).

sources/academy/index.mdx

@@ -1,5 +1,5 @@
 ---
-title: Web Scraping Academy
+title: Apify Academy
 description: Learn everything about web scraping and automation with our free courses that will turn you into an expert scraper developer.
 sidebar_position: 0
 slug: /

sources/academy/tutorials/api/run_actor_and_retrieve_data_via_api.md

@@ -254,7 +254,7 @@ The **run info** JSON also contains the IDs of the default [dataset](/platform/s
 
 > If you are scraping products, or any list of items with similar fields, the [dataset](/platform/storage/dataset) should be your storage of choice. Don't forget though, that dataset items are immutable. This means that you can only add to the dataset, and not change the content that is already inside it.
 
-To retrieve the data from a dataset, send a GET request to the [**Get items**](/api/v2/dataset-items-get) endpoint and pass the `defaultDatasetId` into the URL. For a GET request to the default dataset, no token is needed.
+To retrieve the data from a dataset, send a GET request to the [**Get dataset items**](/api/v2/dataset-items-get) endpoint and pass the `defaultDatasetId` into the URL. For a GET request to the default dataset, no token is needed.
 
 ```cURL
 https://api.apify.com/v2/datasets/DATASET_ID/items

sources/legal/index.mdx

@@ -10,7 +10,7 @@ hide_table_of_contents: true
 <!-- vale off -->
 <!-- markdownlint-disable -->
 
-## Company details (Impressum)
+## Legal info (Imprint)
 
 **Apify Technologies s.r.o.**<br/>
 Registered seat: Vodickova 704/36, 110 00 Prague 1, Czech Republic<br/>

sources/legal/sidebars.js

@@ -2,7 +2,7 @@ module.exports = {
     legal: [
         {
             type: 'link',
-            label: 'Company details (Impressum)',
+            label: 'Legal info (Imprint)',
             href: '/legal',
         },
         {

sources/platform/actors/development/actor_definition/input_schema/secret_input.md

@@ -69,7 +69,7 @@ If you read the `INPUT` key from the Actor run's default key-value store directl
 > await Actor.getValue('INPUT');
 {
     username: 'username',
-    password: 'ENCRYPTED_VALUE:Hw/uqRMRNHmxXYYDJCyaQX6xcwUnVYQnH4fWIlKZL2Vhtq1rZmtoGXQSnhIXmF58+DjKlMZpTlK2zN3YUXk1ylzU6LfXyysOG/PISAfwm27FUgy3IfdgMyQggQ4MydLzdlzefX0mPRyixBviRcFhRTC+K7nK9lkATt3wJpj91YAZm104ZYkcd5KmsU2JX39vxN0A0lX53NjIenzs3wYPaPYLdjKIe+nqG9fHlL7kALyi7Htpy91ZgnQJ1s9saJRkKfWXvmLYIo5db69zU9dGCeJzUc0ca154O+KYYP7QTebJxqZNQsC8EH6sVMQU3W0qYKjuN8fUm1fRzyw/kKFacQ==:VfQd2ZbUt3S0RZ2ciywEWYVBbTTZOTiy'
+    password: 'ENCRYPTED_VALUE:Hw/uqRMRNHmxXYYDJCyaQX6xcwUnVYQnH4fWIlKZL...'
 }
 ```