From 3714924b1708a4dc2d8ae62bd74b88dc71da55a9 Mon Sep 17 00:00:00 2001
From: acheron <acheroncrypto@gmail.com>
Date: Thu, 24 Oct 2024 00:56:34 +0200
Subject: [PATCH] docs: Add "Missing dependencies" installation issue

---
 docs/src/pages/docs/installation.md | 22 ++++++++++------------
 1 file changed, 10 insertions(+), 12 deletions(-)

diff --git a/docs/src/pages/docs/installation.md b/docs/src/pages/docs/installation.md
index 6cfeaeb93a..2de335dbfd 100644
--- a/docs/src/pages/docs/installation.md
+++ b/docs/src/pages/docs/installation.md
@@ -35,12 +35,6 @@ Install `avm` using Cargo. Note this will replace your `anchor` binary if you ha
 cargo install --git https://github.com/coral-xyz/anchor avm --locked --force
 ```
 
-On Linux systems you may need to install additional dependencies if cargo install fails. E.g. on Ubuntu:
-
-```shell
-sudo apt-get update && sudo apt-get upgrade && sudo apt-get install -y pkg-config build-essential libudev-dev libssl-dev
-```
-
 Install the latest version of the CLI using `avm`:
 
 ```shell
@@ -65,12 +59,6 @@ We can also use Cargo to install the CLI directly. Make sure that the `--tag` ar
 cargo install --git https://github.com/coral-xyz/anchor --tag v0.30.1 anchor-cli --locked
 ```
 
-On Linux systems you may need to install additional dependencies if cargo install fails. On Ubuntu,
-
-```shell
-sudo apt-get update && sudo apt-get upgrade && sudo apt-get install -y pkg-config build-essential libudev-dev
-```
-
 Now verify the CLI is installed properly.
 
 ```shell
@@ -79,6 +67,16 @@ anchor --version
 
 ## Issues
 
+Installation might fail due to a variety of reasons. This section contains a list of the most common issues and their solutions.
+
+### Missing dependencies
+
+On Linux systems you may need to install additional dependencies. E.g. on Ubuntu:
+
+```shell
+sudo apt-get update && sudo apt-get upgrade && sudo apt-get install -y pkg-config build-essential libudev-dev libssl-dev
+```
+
 ### Incorrect `$PATH`
 
 Rust binaries, including `avm` and `anchor`, are installed to the `~/.cargo/bin` directory. Since this directory is required to be in the `PATH` environment variable, [Rust](#rust) installation tries to set it up automatically, but it might fail to do so in some platforms.