docs: improve intro page

Author: marcel-rbro

docs/index.md

@@ -1,23 +1,24 @@
 ---
-title: Overview
+title: Introduction
+description: An introduction to Apify CLI, a command-line interface for creating, developing, building, and running Apify Actors and managing the Apify cloud platform.
+sidebar_label: Introduction
 ---
 
-Apify command-line interface (Apify CLI) helps you create, develop, build and run
-[Apify Actors](https://apify.com/actors),
-and manage the Apify cloud platform from any computer.
+Apify command-line interface (Apify CLI) helps you create, develop, build and run [Apify Actors](https://apify.com/actors), and manage the Apify cloud platform from any computer.
 
-Apify Actors are cloud programs that can perform arbitrary web scraping, automation or data processing job.
-They accept input, perform their job and generate output.
-While you can develop Actors in an online IDE directly in the [Apify web application](https://console.apify.com/),
-for complex projects it is more convenient to develop Actors locally on your computer
-using <a href="https://github.com/apify/apify-sdk-js">Apify SDK</a>
-and only push the Actors to the Apify cloud during deployment.
-This is where the Apify CLI comes in.
+Apify Actors are cloud programs that can perform arbitrary web scraping, automation or data processing job. They accept input, perform their job and generate output. The Apify CLI enables you to develop Actors locally on your computer using your preferred code editor, version control system, and development tools. This approach gives you full control over your development environment, makes it easier to work on complex projects, and allows you to leverage the [Apify SDK](https://github.com/apify/apify-sdk-js) with all its powerful features. When you're ready, simply push your Actor to the Apify cloud for deployment.
 
-:::note Run Actors in Docker
+:::note Actor Development Environment
 
-Actors running on the Apify platform are executed in Docker containers, so with an appropriate `Dockerfile`
-you can build your Actors in any programming language.
-However, we recommend using JavaScript/Node.js and Python, for which we provide most libraries and support.
+Actors running on the Apify platform are executed in Docker containers, so with an appropriate `Dockerfile` you can build your Actors in any programming language. However, we recommend using JavaScript/Node.js and Python, for which we provide most libraries and support.
 
 :::
+
+## Learn more
+
+Learn everything you need to use the Apify CLI effectively:
+
+- Learn how to [install](./installation.md) the CLI on your system
+- Get started with your [first Actor project](./quick-start.md)
+- See the complete [reference of all CLI commands](./reference.md) and options
+- Find [solutions to common issues](./troubleshooting.md)