docs: create dependencies page (#2124)

Author: Stratus3D

docs/.vitepress/sidebars.ts

@@ -25,6 +25,7 @@ const en = [
     items: [
       { text: "Configuration", link: "/manage/configuration" },
       { text: "All Commands", link: "/manage/commands" },
+      { text: "Dependencies", link: "/manage/dependencies" },
       {
         text: "Plugin Shortname Index",
         link: "https://github.com/asdf-vm/asdf-plugins",

docs/guide/upgrading-to-v0-16.md

@@ -113,7 +113,8 @@ lines you removed or commented out.
 your new asdf installation is working correctly!** After upgrade there are
 various files you can remove from the old Bash-script based versions of asdf.
 Most of the files in your data directory (typically `~/.asdf/`) can be removed.
-The only directories that must be **kept** are:
+Note that you don't have to do this. There is no harm in keeping the files from
+old versions of asdf around. The only directories that must be **kept** are:
 
 * `downloads/`
 * `installs/`

docs/manage/dependencies.md

@@ -0,0 +1,30 @@
+# Dependencies
+
+This list is for asdf version 0.16.0 and greater. Older versions of asdf have
+additional dependencies.
+
+asdf itself requires the following to be installed:
+
+* Bash version `3.2.48`
+* Git version `1.7.7.2`
+
+::: tip Note
+
+Note that asdf plugins may require additional programs to be installed before
+they can be used. Read the plugin's documentation and verify you have all of
+the plugin's dependencies installed before installing it.
+
+:::
+
+## Install
+
+If you need to manually install dependencies for asdf run the command for your
+OS below.
+
+<!--@include: @/parts/install-dependencies-cmds.md-->
+
+::: tip Note
+
+`sudo` may be required depending on your system configuration.
+
+:::

docs/parts/install-dependencies-cmds.md

@@ -0,0 +1,8 @@
+| OS    | Package Manager | Command                            |
+| ----- | --------------- | ---------------------------------- |
+| linux | Aptitude        | `apt install git bash`             |
+| linux | DNF             | `dnf install git bash`             |
+| linux | Pacman          | `pacman -S git bash`               |
+| linux | Zypper          | `zypper install git bash`          |
+| macOS | Homebrew        | `brew install coreutils git bash`  |
+| macOS | Spack           | `spack install coreutils git bash` |

docs/parts/install-dependencies.md

@@ -2,17 +2,12 @@
 
 asdf primarily requires `git`. Here is a _non-exhaustive_ list of commands to run for _your_ package manager (some might automatically install these tools in later steps).
 
-| OS    | Package Manager | Command                            |
-| ----- | --------------- | ---------------------------------- |
-| linux | Aptitude        | `apt install git`             |
-| linux | DNF             | `dnf install git`             |
-| linux | Pacman          | `pacman -S git`               |
-| linux | Zypper          | `zypper install git`          |
-| macOS | Homebrew        | `brew install coreutils git`  |
-| macOS | Spack           | `spack install coreutils git` |
+<!--@include: @/parts/install-dependencies-cmds.md-->
 
 ::: tip Note
 
 `sudo` may be required depending on your system configuration.
 
 :::
+
+Please see the [Dependencies page](/manage/dependencies) for more information.