docs: Improve Quick Start flow

Author: patrikbraborec

package-lock.json

@@ -1,53 +1,63 @@
 ---
 title: Quick start
 sidebar_position: 1
-description: Create your first Actor using the Apify Console IDE or locally.
+description: Create your first Actor using the Apify Web IDE or locally in your IDE.
 slug: /actors/development/quick-start
 ---
 
+import Card from "@site/src/components/Card";
+import CardGrid from "@site/src/components/CardGrid";
+
 # Development: Quick start
 
-**Create your first Actor using the Apify Console IDE or locally.**
+**Create your first Actor using the Apify Web IDE or locally in your IDE.**
 
 ---
 
-:::note
+:::info
 
 Before you start building your own Actor, try out a couple of existing Actors from [Apify Store](https://apify.com/store). See the [Running Actors](../../running/index.md) section for more information on running existing Actors.
 
 :::
 
-## Language
+## Technology Stack
 
 Any code that can run inside of a Docker container can be turned into Apify [Actor](../../index.mdx). This gives you freedom in choosing your technical stack, including programming language and technologies.
 
 But to fully benefit from running on top of the Apify platform, we recommend you choose either JavaScript/Node.js or Python, where Apify provides first-level support regarding its SDK, API clients, and learning materials.
 
-For these languages, you can also choose from many code templates that help you to kickstart your project quickly:
+For these languages, you can also [choose from many code templates](https://apify.com/templates) that help you to kickstart your project quickly:
 
 <a href="https://apify.com/templates" target="_blank">
     <img src={require("./images/templates.png").default} width="70%" />
 </a>
 
-## [](#local-development)Local development
+## Development Paths
 
-You can create Actor in two ways:
+You can develop Actor in two ways:
 
-- Using the **Web IDE** in [Apify Console](https://console.apify.com). This is the fastest way to kick-start your Actor development and try out the Apify platform.
-- Develop your Actor **locally** and only deploy to the Apify platform when it is production ready. This way, you benefit from your local setup for a better development and debugging experience. After you are done with the development, you can easily [deploy](./deployment) your Actor to Apify platform.
+### Option 1: local Development
 
-Now, let's start with:
+Develop your Actor locally in your IDE and only deploy to the Apify platform when it is production ready. 
 
-import Card from "@site/src/components/Card";
-import CardGrid from "@site/src/components/CardGrid";
+This way, you benefit from your local setup for a better development and debugging experience. After you are done with the development, you can easily [deploy](./deployment) your Actor to Apify platform.
 
 <CardGrid>
     <Card
-        title="Apify Console web IDE"
-        to="/platform/actors/development/quick-start/web-ide"
+        title="Start Locally in Your IDE"
+        to="/platform/actors/development/quick-start/locally"
     />
+</CardGrid>
+
+### Option 2: Web IDE
+
+Using the Web IDE in [Apify Console](https://console.apify.com). 
+
+This is the fastest way to kick-start your Actor development and try out the Apify platform.
+
+<CardGrid>
     <Card
-        title="Locally on your machine"
-        to="/platform/actors/development/quick-start/locally"
+        title="Start in Apify Web IDE"
+        to="/platform/actors/development/quick-start/web-ide"
     />
 </CardGrid>

sources/platform/actors/development/quick_start/index.mdx

@@ -9,54 +9,47 @@ slug: /actors/development/quick-start/locally
 
 ---
 
-:::info Prerequisites
+## What you'll learn
 
-You need to have [Node.js](https://nodejs.org/en/) version 16 or higher with `npm` installed on your computer.
+- tbd
 
-:::
-
-## Install Apify CLI
-
-### MacOS/Linux
-
-You can install the Apify CLI via the [Homebrew package manager](https://brew.sh/).
-
-```bash
-brew install apify-cli
-```
-
-### Other platforms
 
-Use [NPM](https://www.npmjs.com/) to install the Apify CLI.
+## Prerequisites
 
-```bash
-npm -g install apify-cli
-```
+- [Node.js](https://nodejs.org/en/) version 16 or higher with `npm` installed on your computer.
+- The [Apify CLI](/cli/docs/installation) installed.
+- Optional: If you want to deploy your Actor to the Apify platform, you need to [sign in](https://console.apify.com/sign-in).
 
-Visit [Apify CLI documentation](https://docs.apify.com/cli/) for more information regarding installation and advanced usage.
+---
 
-## Create your Actor
+## Step 1: Create your Actor
 
-To create a new Actor, use the following command:
+Use Apify CLI to create a new Actor using the following command:
 
 ```bash
 apify create
 ```
 
-The CLI will prompt you to:
+The Apify CLI will prompt you to:
 
 1. _Name your Actor_: Enter a descriptive name for your Actor, such as `your-actor-name`
 1. _Choose a programming language_: Select the language you want to use for your Actor (JavaScript, TypeScript, or Python).
 1. _Select a development template_: Choose a template from the list of available options.
 
-After selecting the template, the CLI will:
+:::info
 
-- Create a `your-actor-name` directory with the boilerplate code.
-- Install all project dependencies
+If you’re unsure which template to use, browse the [full list of templates]((https://apify.com/templates)) with descriptions to find the best fit for your Actor.
+
+:::
 
 ![Creation](./images/actor-create.gif)
 
-Navigate to the newly created Actor directory:
+After selecting the template, the Apify CLI will:
+
+- Create a `your-actor-name` directory with the boilerplate code.
+- Install all project dependencies
+
+Now, you can navigate to the newly created Actor directory:
 
 ```bash
 cd your-actor-name