Enviorment setup refactor (#1414)

* refactore env setup

* minor fix

* minor fix

* minor fix

* code review

* minor fix

Author: LandauRaz

components/Starknet/modules/quick-start/pages/environment-setup.adoc

@@ -1,71 +1,73 @@
 [id="setup"]
 = Setting up your environment
 
-In order to interact with Starknet and compile Cairo code, you need to install several tools.
+== Overview
 
-The following tools are recommended to begin developing on Starknet:
+In order to use Starknet, you need to install several tools. This section will walk you through installing the three most recommended tools to begin developing on Starknet:
 
-[cols="1,1,1,1"]
-[%autowidth.stretch]
-|===
-|Tool name | Description | Documentation |Code Repository
+* xref:tools:devtools/clis.adoc#starkli[Starkli], a command-line interface that allows you to interact with Starknet.
 
-|Starkli
-|A command-line interface that allows you to interact with Starknet.
-|https://book.starkli.rs/[book.starkli.rs]
-|https://github.com/xJonathanLEI/starkli[github.com/xJonathanLEI/starkli]
+* xref:tools:devtools/smart-contract-tools.adoc#scarb[Scarb], a build toolchain and package manager for Cairo and Starknet ecosystems.
 
-|Scarb
-|A build toolchain and package manager for Cairo and Starknet ecosystems.
-|https://docs.swmansion.com/scarb/[docs.swmansion.com/scarb]
-|https://github.com/software-mansion/scarb[github.com/software-mansion/scarb]
+* xref:tools:devtools/smart-contract-tools.adoc#starknet_foundry[Starknet Foundry], the go-to framework for building and testing Starknet Smart Contracts
 
-|Starknet Foundry
-|The go to framework for building, and testing Starknet Smart Contracts.
-|https://foundry-rs.github.io/starknet-foundry/[foundry-rs.github.io/starknet-foundry]
-|https://github.com/foundry-rs/starknet-foundry[github.com/foundry-rs/starknet-foundry]
-
-
-|===
+To review all Starknet developer tools, check out the xref:tools:devtools/overview.adoc[tools and resources section].
 
 [#installing_starkli]
-== Installing Starkli
+== Setting up Starkli
+
+=== MacOS and Linux installation
 
-The steps for installing Starkli and upgrading Starkli are identical.
+It is highly recommended to install Starkli on MacOS and Linux using the link:https://get.starkli.sh[`starkliup` portable script]. `starkliup` manages shell configuration for you, and using any other installation method requires to link:https://book.starkli.rs/shell-completions[manually set up shell completions].
 
 .Procedure
 
-. Install Starkliup, the installer for the Starkli environment:
+. Download `starkliup`:
 +
 [source,shell]
 ----
 curl https://get.starkli.sh | sh
 ----
+
+. Restart the terminal and install Starkli:
 +
-Starkliup should now be installed.
+[source,shell]
+----
+starkliup
+----
 
-. Restart the terminal.
+. Restart the terminal and verify that Starkli is installated correctly:
++
+[source,shell]
+----
+starkli --version
+----
+
+=== Windows installation
+
+Starknet Foundry's installation on Windows requires manually setting up shell completions.
+
+.Procedure
 
 . Install Starkli:
 +
 [source,shell]
 ----
-starkliup
+cargo install --locked --git https://github.com/xJonathanLEI/starkli
 ----
-+
-Starkli should now be installed.
 
-. Restart the terminal and run the following command to verify the installation:
+. Restart the terminal and verify that Starkli is installated correctly:
 +
 [source,shell]
 ----
 starkli --version
 ----
 +
-Starkli prints the current version.
+
+. Set up Starkli's shell completions by following the instructions in the link:https://book.starkli.rs/shell-completions[Starkli documentation].
 
 [#setting_environment_variables_for_starkli]
-== Setting environment variables for Starkli
+=== Environment variables setup
 
 For the majority of flags available on Starkli you can set environment variables to make the commands shorter and easier to manage.
 
@@ -77,7 +79,7 @@ The two primary environment variables that are vital for effective usage of Star
 `STARKNET_ACCOUNT`:: The location of the xref:set-up-an-account.adoc#creating_an_account_descriptor[Account Descriptor] file.
 `STARKNET_KEYSTORE`:: The location of the keystore file for the xref:set-up-an-account.adoc#creating_a_signer[Signer].
 
-Set these environment variables as follows:
+The following sections assume these environment variables are set as follows:
 
 [source,bash]
 ----
@@ -86,85 +88,72 @@ export STARKNET_KEYSTORE=~/.starkli-wallets/deployer/keystore.json
 ----
 
 [#installing_scarb]
-== Installing Scarb
-
-Scarb is compatible with macOS, Linux, and Windows operating systems.
-
+== Setting up Scarb
 
 === MacOS and Linux installation
 
-It is highly recommended to install Scarb via the link:https://asdf-vm.com/[`asdf`] version manager.
-
-Installing Scarb with `asdf` seamlessly integrates with the Cairo xref:tools:devtools/vscode.adoc[Cairo VSCode extension], and allows to easily switch between different versions of Scarb, globally or per project.
+It is highly recommended to install Scarb on MacOS and Linux via the link:https://asdf-vm.com/[`asdf` version manager]. Installing Scarb with `asdf` seamlessly integrates with the Cairo xref:tools:devtools/vscode.adoc[Cairo VSCode extension], and allows to easily switch between different versions of Scarb, both globally and per project (see full details in the link:https://asdf-vm.com/manage/commands.html[`asdf` documentation] or by running `asdf --help`).
 
 .Procedure
 
-. Follow the installation steps of `asdf` on the link:https://asdf-vm.com/guide/getting-started.html[official website].
+. Verify that `asdf` is installed:
 +
+[source, bash]
+----
+asdf --version
+----
++
+or install it by following the instructions in the link:https://asdf-vm.com/guide/getting-started.html[`asdf` documentation].
 
-. Install the Scarb plugin:
+. Install the `asdf` Scarb plugin:
 +
 [source, bash]
 ----
 asdf plugin add scarb
 ----
 
-. Install the latest version of Scarb
+. Install the latest version of Scarb:
 +
 [source, bash]
 ----
 asdf install scarb latest
 ----
 
-
-. Set a global version for Scarb
+. Restart the terminal and verify that Scarb is installed correctly:
 +
 [source, bash]
 ----
-asdf global scarb latest
+scarb --version
 ----
 
-
-. Check if Scarb is installed correctly
+. Set a global version for Scarb (need for using `scarb init`):
 +
 [source, bash]
 ----
-scarb --version
+asdf global scarb latest
 ----
 
-You should see the version of Scarb, Cairo and Sierra.
-
-[TIP]
-====
-See additional commands for updating Scarb and switching between versions in the link:https://asdf-vm.com/manage/commands.html[`asdf` documentation], or by running `asdf --help`.
-====
-
-
-
 === Windows installation
 
 Scarb's installation on Windows requires manual setup.
 
 .Procedure
 
-. Follow the steps in the link:https://docs.swmansion.com/scarb/download.html#windows[Scarb documentation].
-. Restart the terminal and run the following command to verify the installation:
+. Follow the instructions in the link:https://docs.swmansion.com/scarb/download.html#windows[Scarb documentation].
+
+. Restart the terminal and verify that Scarb is installed correctly:
 +
 [source, bash]
 ----
 scarb --version
 ----
 
-Scarb should now be installed.
-
 [#starknet_foundry_setup]
 == Setting up Starknet Foundry
 
-// Starknet Foundry is the go to framework for building, and testing Starknet Smart Contracts.
-
-=== Installing Starknet Foundry on MacOS and Linux
+=== MacOS and Linux installation
 
-Although other options are possible, it is highly recommended to install Starknet Foundry using the link:https://asdf-vm.com/[`asdf` version manager]. Installing Starknet Foundry with `asdf` allows to easily switch between different versions of Starknet Foundry, both globally and per project.
+It is highly recommended to install Starknet Foundry on MacOS and Linux using the link:https://asdf-vm.com/[`asdf` version manager]. Installing Starknet Foundry with `asdf` allows to easily switch between different versions of Starknet Foundry, both globally and per project (see full details in the link:https://asdf-vm.com/manage/commands.html[`asdf` documentation] or by running `asdf --help`).
 
 .Procedure
 
@@ -174,7 +163,7 @@ Although other options are possible, it is highly recommended to install Starkne
 +
 [source, bash]
 ----
-asdf plugin-add starknet-foundry
+asdf plugin add starknet-foundry
 ----
 
 . Install the latest version of Starknet Foundry:
@@ -184,29 +173,28 @@ asdf plugin-add starknet-foundry
 asdf install starknet-foundry latest
 ----
 
-// . Set a global version for Starknet Foundry using `asdf`:
-// +
-// [source, bash]
-// ----
-// asdf global starknet-foundry latest
-// ----
-
+. Set a global version for Starknet Foundry using `asdf` (need for using `scarb init`):
++
+[source, bash]
+----
+asdf global starknet-foundry latest
+----
 
-. Verify that Starknet Foundry is installed correctly:
+. Restart the terminal and verify that Starknet Foundry is installed correctly:
 +
 [source, bash]
 ----
 snforge --version
 sncast --version
 ----
 
-=== Installing Starknet Foundry on Windows
+=== Windows installation
 
 Starknet Foundry's installation on Windows requires manual setup.
 
 .Procedure
 
-. Follow the steps in the link:https://foundry-rs.github.io/starknet-foundry/getting-started/installation.html#installation-on-windows[Starknet Foundry documentation].
+. Follow the instructions in the link:https://foundry-rs.github.io/starknet-foundry/getting-started/installation.html#installation-on-windows[Starknet Foundry documentation].
 . Restart the terminal and verify that Starknet Foundry is installed correctly:
 +
 [source, bash]