docs: Update cli docs (#880)

Co-authored-by: Vlad Frangu <[email protected]>
Co-authored-by: Michał Olender <[email protected]>

Author: 3 people

docs/index.md

@@ -1,5 +1,5 @@
 ---
-title: Apify CLI
+title: Overview
 ---
 
 Apify command-line interface (Apify CLI) helps you create, develop, build and run
@@ -14,6 +14,10 @@ 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.
 
-Note that Actors running on the Apify platform are executed in Docker containers, so with an appropriate `Dockerfile`
+:::note Run Actors in Docker
+
+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, for which we provide most libraries and support.
+However, we recommend using JavaScript/Node.js and Python, for which we provide most libraries and support.
+
+:::

docs/installation.md

@@ -1,189 +1,67 @@
 ---
 title: Installation
-description: Learn how to install Apify CLI, and how to create, run, and manage Actors through it.
-sidebar_label: Installation
+description: Learn how to install Apify CLI using installation scripts, Homebrew, or NPM.
 ---
 
-## Installation
+Learn how to install Apify CLI using installation scripts, Homebrew, or NPM.
 
-You can install Apify CLI either using [Homebrew package manager](https://brew.sh) on macOS or Linux or using NPM on all platforms including Windows.
-
-### Via Homebrew
-
-Run the following command:
-
-```bash showLineNumbers
-brew install apify-cli
-```
-
-### Via NPM
-
-First, make sure you have [Node.js](https://nodejs.org) version 18 or higher with NPM installed on your computer:
-
-```bash showLineNumbers
-node --version
-npm --version
-```
-
-Install or upgrade Apify CLI by running:
-
-```bash showLineNumbers
-npm -g install apify-cli
-```
-
-If you receive a permission error, read npm's [official guide](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally) on installing packages globally.
+---
 
-Alternatively, you can use [Node Version Manager (nvm)](https://github.com/nvm-sh/nvm) and install Apify CLI only into a selected user-level Node version without requiring root privileges:
+The recommended way to install Apify CLI is by using our installation scripts. This means you don't need to install Node.js to use the CLI, which is useful for Python users or anyone who doesn't want to manage Node.js dependencies.
 
-```bash showLineNumbers
-nvm install 18
-nvm use 18
-npm -g install apify-cli
-```
+## Preferred methods
 
-After using either of these methods , verify that Apify CLI was installed correctly by running:
+### MacOS / Unix
 
-```bash showLineNumbers
-apify --version
+```bash
+curl -fsSL https://apify.com/install-cli.sh | bash
 ```
 
-which should print something like:
+### Windows
 
-```bash showLineNumbers
-apify-cli/0.19.1 linux-x64 node-v18.17.0
+```powershell
+irm https://apify.com/install-cli.ps1 | iex
 ```
 
-## Basic Usage
-
-The following examples demonstrate the basic usage of Apify CLI.
+## Other methods
 
-### Create a New Actor from Scratch
+### Homebrew
 
-```bash showLineNumbers
-apify create my-hello-world
+```bash
+brew install apify-cli
 ```
 
-First, you will be prompted to select a template with the boilerplate for the Actor, to help you get started quickly.
-The command will create a directory called `my-hello-world` that contains a Node.js project
-for the Actor and a few configuration files.
+### NPM
 
-### Create a New Actor from Existing Project
-
-:::tip Automatic Actor directory initialization
-When you create an Actor using the `apify create` command, the directory will already be initialized.
-:::
+First, make sure you have [Node.js](https://nodejs.org) version 22 or higher with NPM installed on your computer:
 
 ```bash showLineNumbers
-cd ./my/awesome/project
-apify init
-```
-
-This command will only set up local Actor development environment in an existing directory,
-i.e. it will create the `.actor/actor.json` file and `apify_storage` directory.
-
-Before you can run your project locally using `apify run`, you have to set up the right start command in `package.json` under scripts.start. For example:
-
-```json showLineNumbers
-{
-    ...
-    "scripts": {
-        "start": "node your_main_file.js",
-    },
-    ...
-}
+node --version
+npm --version
 ```
 
-You can find more information about by running `apify help run`.
-
-### Run the Actor Locally
+Install or upgrade Apify CLI by running:
 
-```bash showLineNumbers
-cd my-hello-world
-apify run
+```bash
+npm install -g apify-cli
 ```
 
-This command runs the Actor on your local machine.
-Now's your chance to develop the logic - or magic :smirk:
-
-### Login with your Apify account
+:::tip Troubleshooting
 
-```bash showLineNumbers
-apify login
-```
-
-Before you can interact with the Apify cloud, you need to [create an Apify account](https://console.apify.com/)
-and log in to it using the above command. You will be prompted for
-your [Apify API token](https://console.apify.com/settings/integrations).
+If you receive a permission error, read npm's [official guide](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally) on installing packages globally.
 
-:::note API token save directory
-The command will store the API token and other sensitive information to `~/.apify`.
 :::
 
-### Push the Actor to the Apify Cloud
-
-```bash showLineNumbers
-apify push
-```
-
-This command uploads your project to the Apify cloud and builds an Actor from it. On the platform, Actor needs to be built before it can be run.
+## Verify installation
 
-### Run an Actor on the Apify Cloud
+You can verify the installation process by running the following command:
 
-```bash showLineNumbers
-apify call
+```bash
+apify --version
 ```
 
-Runs the Actor corresponding to the current directory on the Apify Platform.
-
-This command can also be used to run other Actors, for example:
-
-```bash showLineNumbers
-apify call apify/hello-world
-```
+The output should resemble the following (exact details like version or platform may vary):
 
-### So what's in this `.actor/actor.json` File?
-
-This file associates your local development project with an Actor on the Apify Platform.
-It contains information such as Actor name, version, build tag and environment variables.
-Make sure you commit this file to the Git repository.
-
-For example, `.actor/actor.json` file can look as follows:
-
-```json showLineNumbers
-{
-  "actorSpecification": 1,
-  "name": "name-of-my-scraper",
-  "version": "0.0",
-  "buildTag": "latest",
-  "environmentVariables": {
-    "MYSQL_USER": "my_username",
-    "MYSQL_PASSWORD": "@mySecretPassword"
-  },
-  "dockerfile": "./Dockerfile",
-  "readme": "./ACTOR.md",
-  "input": "./input_schema.json",
-  "storages": {
-    "dataset": "./dataset_schema.json"
-  }
-}
+```bash
+apify-cli/1.0.1 (0dfcfd8) running on darwin-arm64 with bun-1.2.19 (emulating node 24.3.0), installed via bundle
 ```
-
-**`Dockerfile` field**
-
-If you specify the path to your Docker file under the `dockerfile` field, this file will be used for Actor builds on the platform. If not specified, the system will look for Docker files at `.actor/Dockerfile` and `Dockerfile` in this order of preference.
-
-**`Readme` field**
-
-If you specify the path to your readme file under the `readme` field, the readme at this path will be used on the platform. If not specified, readme at `.actor/README.md` and `README.md` will be used in this order of preference.
-
-**`Input` field**
-
-You can embed your [input schema](https://docs.apify.com/actors/development/input-schema#specification-version-1) object directly in `actor.json` under `input` field. Alternatively, you can provide a path to a custom input schema. If not provided, the input schema at `.actor/INPUT_SCHEMA.json` and `INPUT_SCHEMA.json` is used in this order of preference.
-
-**`Storages.dataset` field**
-
-You can define the schema of the items in your dataset under the `storages.dataset` field. This can be either an embedded object or a path to a JSON schema file. You can read more about the schema of your Actor output [here](https://docs.apify.com/actors/development/output-schema#specification-version-1).
-
-:::note Migration from deprecated config "apify.json"
-Note that previously, Actor config was stored in the `apify.json` file that has been deprecated. You can find the (very slight) differences and migration info in [migration guidelines](https://github.com/apify/apify-cli/blob/master/MIGRATIONS.md).
-:::

docs/integrating-scrapy.md

@@ -6,29 +6,15 @@ sidebar_label: Integrating Scrapy projects
 
 [Scrapy](https://scrapy.org/) is a widely used open-source web scraping framework for Python. Scrapy projects can now be executed on the Apify platform using our dedicated wrapping tool. This tool allows users to transform their Scrapy projects into [Apify Actors](https://docs.apify.com/platform/actors) with just a few simple commands.
 
-## Getting started
+## Prerequisites
 
-### Install Apify CLI
-
-To run the migration tool, you need to have the Apify CLI installed. You can install it using Homebrew with the following command:
-
-```bash showLineNumbers
-brew install apify-cli
-```
-
-Alternatively, you can install it using NPM with the following command:
-
-```bash showLineNumbers
-npm i -g apify-cli
-```
-
-In case of any issues, please refer to the [installation guide](./installation.md).
+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).
 
 ## Actorization of your existing Scrapy spider
 
 Assuming your Scrapy project is set up, navigate to the project root where the `scrapy.cfg` file is located.
 
-```bash showLineNumbers
+```bash
 cd your_scraper
 ```
 
@@ -48,7 +34,7 @@ your_spider.py  __init__.py
 
 To convert your Scrapy project into an Apify Actor, initiate the wrapping process by executing the following command:
 
-```bash showLineNumbers
+```bash
 apify init
 ```
 
@@ -70,25 +56,25 @@ For example, here is a [source code](https://github.com/apify/actor-scrapy-books
 
 Create a Python virtual environment by running:
 
-```bash showLineNumbers
+```bash
 python -m virtualenv .venv
 ```
 
 Activate the virtual environment:
 
-```bash showLineNumbers
+```bash
 source .venv/bin/activate
 ```
 
 Install Python dependencies using the provided requirements file named `requirements_apify.txt`. Ensure these requirements are installed before executing your project as an Apify Actor locally. You can put your own dependencies there as well.
 
-```bash showLineNumbers
+```bash
 pip install -r requirements-apify.txt [-r requirements.txt]
 ```
 
 Finally execute the Apify Actor.
 
-```bash showLineNumbers
+```bash
 apify run [--purge]
 ```
 
@@ -98,7 +84,7 @@ If [ActorDatasetPushPipeline](https://github.com/apify/apify-sdk-python/blob/mas
 
 The project remains executable as a Scrapy project.
 
-```bash showLineNumbers
+```bash
 scrapy crawl your_spider -o books.json
 ```
 
@@ -108,15 +94,15 @@ scrapy crawl your_spider -o books.json
 
 You will need to provide your [Apify API Token](https://console.apify.com/settings/integrations) to complete this action.
 
-```bash showLineNumbers
+```bash
 apify login
 ```
 
 ### Deploy your Actor
 
 This command will deploy and build the Actor on the Apify platform. You can find your newly created Actor under [Actors -> My Actors](https://console.apify.com/actors?tab=my).
 
-```bash showLineNumbers
+```bash
 apify push
 ```
 
@@ -166,9 +152,8 @@ it is recommended to use Apify's instance of the nested event loop. Refer to the
 inspiration from Apify's Scrapy components, such as the
 [ApifyScheduler](https://github.com/apify/apify-sdk-python/blob/v1.5.0/src/apify/scrapy/scheduler.py#L114).
 
-```python showLineNumbers
+```python
 from apify.scrapy.utils import nested_event_loop
-
 ...
 
 # Coroutine execution inside a spider