docs: Update Quickstart

Author: szaganek

docs/quick-start.md

@@ -1,84 +1,94 @@
 ---
 title: Quick start
-description: Learn how to create, run, and manage Actors using Apify CLI.
+description: Learn how to create, run, and deploy Actors using Apify CLI.
 ---
 
-Learn how to create, run, and manage Actors using Apify CLI.
+Learn how to create, run, and deploy [Actors](https://docs.apify.com/actors) using Apify CLI.
 
-## Prerequisites
+## Before you start
 
-Before you begin, make sure you have the Apify CLI installed on your system. If you haven't installed it yet, follow the [installation guide](./installation.md).
+- [Install Apify CLI](./installation.md).
+- [Create an Apify account](https://console.apify.com/sign-up).
 
-## Step 1: Create your Actor
+## 1. Create an Actor
 
-Run the following command in your terminal. It will guide you step by step through the creation process.
+To create an Actor, run the following command in your terminal:
 
 ```bash
 apify create
 ```
 
-:::info Explore Actor templates
+The CLI then asks you for the following:
 
-The Apify CLI will prompt you to choose a template. Browse the [full list of templates](https://apify.com/templates) to find the best fit for your Actor.
+1. Name your Actor. Use lowercase letters, numbers, and hyphens.
+1. Select a type of Actor to create:  web scraper, AI agent, API and data pipeline, or browser automation. Let's choose **web scraper**.
+1. Choose the programming language: JavaScript, TypeScript, or Python. Let's choose **JavaScript**.
+1. Based on your choice, the CLI suggests Actor templates. For this tutorial, let's choose **Crawlee and Cheerio**.
+
+:::tip Explore Actor templates
+
+To find a template that best suits your needs, browse the [full list of templates](https://apify.com/templates).
 
 :::
 
-## Step 2: Run your Actor
+The CLI creates a new directory with the boilerplate code and installs all project dependencies.
 
-Once the Actor is initialized, you can run it:
+## 2. Run your Actor
 
-```bash
-apify run
-```
+You can run the code locally, with simulated Apify [environment variables](https://docs.apify.com/actors/development/environment-variables). The results of the Actor run are saved to your disk.
 
-You'll see output similar to this in your terminal:
+1. Navigate to the Actor directory:
 
-```bash
-INFO  System info {"apifyVersion":"3.4.3","apifyClientVersion":"2.12.6","crawleeVersion":"3.13.10","osType":"Darwin","nodeVersion":"v22.17.0"}
-Extracted heading { level: 'h1', text: 'Your full‑stack platform for web scraping' }
-Extracted heading { level: 'h3', text: 'TikTok Scraper' }
-Extracted heading { level: 'h3', text: 'Google Maps Scraper' }
-Extracted heading { level: 'h3', text: 'Instagram Scraper' }
-```
+    ```bash
+    cd your-actor-name
+    ```
 
-## Step 3: Push your Actor
+1. Run your Actor:
 
-Once you are ready, you can push your Actor to the Apify platform, where you can schedule runs, or make the Actor public for other developers.
+    ```bash
+    apify run
+    ```
 
-### Login to Apify Console
+### View the results
 
-```bash
-apify login
-```
+Local runs store their data in the `storage` directory:
 
-:::note Create an Apify account
+| Path | Contents |
+| --- | --- |
+| `storage/datasets/default/` | Results the Actor added to its default dataset. One JSON file per item. |
+| `storage/key_value_stores/default/` | Records the Actor read or wrote, including its input. |
+| `storage/request_queues/default/` | Requests the Actor enqueued. |
 
-Before you can interact with the Apify Console, [create an Apify account](https://console.apify.com/).
-When you run `apify login`, you can choose one of the following methods:
 
-- Sign in via the Apify Console in your browser — recommended.
-- Provide an [Apify API token](https://console.apify.com/settings/integrations) — alternative method.
+## 3. Deploy your Actor
 
-The interactive prompt will guide you through either option.
+By deploying your Actor to the Apify platform, you can run your code on Apify's infrastructure, schedule runs, and monitor logs and stored data.
 
-:::
+### Log in to Apify Console
 
-### Push to Apify Console
+To log in, run:
 
 ```bash
-apify push
+apify login
 ```
 
-## Step 4: Call your Actor (optional)
+You can then choose one of the following methods:
 
-You can run your Actor on the Apify platform. In the following example, the command runs `apify/hello-world` on the Apify platform.
+- _(Recommended)_ Sign in through the Apify Console in your browser.
+- Provide an [Apify API token](https://console.apify.com/settings/integrations).
+
+### Push your Actor to Apify
+
+To upload your Actor's source code and build it on the Apify platform, run:
 
 ```bash
-apify call apify/hello-world
+apify push
 ```
 
+The CLI creates the Actor in your account, shows the build log, and prints a link to your Actor in Apify Console when the build succeeds.
+
 ## Next steps
 
-- Check the [command reference](./reference.md) for more information about individual commands.
-- If you have a problem with the Apify CLI, check the [troubleshooting](./troubleshooting.md) guide.
-- Learn more about [Actors](https://docs.apify.com/platform/actors).
+- For a full list of available commands, see the [command reference](./reference.md).
+- For details on how to automate the development process, see [Continuous integration](https://docs.apify.com/actors/development/deployment/continuous-integration).
+- Once your first Actor is ready, [publish it on Apify Store](https://docs.apify.com/actors/publishing) and set up monetization to start earning.