From 7a8f3f54bc20b6a22870ee327cc5cebcbf62abf6 Mon Sep 17 00:00:00 2001
From: Jessie Mongeon <133128541+jessiemongeon1@users.noreply.github.com>
Date: Mon, 5 May 2025 17:06:24 -0500
Subject: [PATCH 01/13] Update dfxvm.mdx
---
docs/cli-reference/dfxvm/dfxvm.mdx | 42 +++++++++++++++++++++++++++++-
1 file changed, 41 insertions(+), 1 deletion(-)
diff --git a/docs/cli-reference/dfxvm/dfxvm.mdx b/docs/cli-reference/dfxvm/dfxvm.mdx
index b860c23..2f1566a 100644
--- a/docs/cli-reference/dfxvm/dfxvm.mdx
+++ b/docs/cli-reference/dfxvm/dfxvm.mdx
@@ -4,4 +4,44 @@ import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-When invoked as `dfxvm`, manages dfx versions or itself.
+`dfxvm` is the version manager for the command-line tool `dfx`.
+
+When invoked as `dfxvm`, manages `dfx` versions or itself.
+
+To set the default `dfx` version, use the `dfxvm default` command:
+
+```
+dfxvm default 0.25.1
+```
+
+Or, to set the `dfx` version for a single command:
+
+```
+dfx +0.25.1 --version
+```
+
+The `dfx` version can be set manually in a project's `dfx.json` file:
+
+```json
+{
+ "dfx": "0.25.0"
+}
+```
+
+## Subcommands
+
+Available subcommands are:
+
+- `dfxvm default`
+
+- `dfxvm install`
+
+- `dfxvm list`
+
+- `dfxvm self uninstall`
+
+- `dfxvm self update`
+
+- `dfxvm uninstall`
+
+- `dfxvm update`
From 251bf0ae0adae62d9fc009495af1d817a265db61 Mon Sep 17 00:00:00 2001
From: Jessie Mongeon <133128541+jessiemongeon1@users.noreply.github.com>
Date: Mon, 5 May 2025 17:10:45 -0500
Subject: [PATCH 02/13] Update dfxvm-default.mdx
---
docs/cli-reference/dfxvm/dfxvm-default.mdx | 9 ++++-----
1 file changed, 4 insertions(+), 5 deletions(-)
diff --git a/docs/cli-reference/dfxvm/dfxvm-default.mdx b/docs/cli-reference/dfxvm/dfxvm-default.mdx
index d8bee78..c7534e3 100644
--- a/docs/cli-reference/dfxvm/dfxvm-default.mdx
+++ b/docs/cli-reference/dfxvm/dfxvm-default.mdx
@@ -1,19 +1,18 @@
# dfxvm default
-Sets or displays the dfx version to use by default.
+Sets or displays the `dfx` version that should be used by default.
-When setting the default version, installs the specified version
-if it is not already installed.
+When setting the default version, `dfxvm default` installs the specified version if it is not already installed.
## Usage
-Set the dfx version to use by default:
+Set the `dfx` version to be used by default:
```bash
dfxvm default
```
-Display the default dfx version:
+Display the currently configured default `dfx` version:
```bash
dfxvm default
From 18bca4faace9541b16d8af175e718bc49044005b Mon Sep 17 00:00:00 2001
From: Jessie Mongeon <133128541+jessiemongeon1@users.noreply.github.com>
Date: Mon, 5 May 2025 17:11:52 -0500
Subject: [PATCH 03/13] Update dfxvm-install.mdx
---
docs/cli-reference/dfxvm/dfxvm-install.mdx | 8 +-------
1 file changed, 1 insertion(+), 7 deletions(-)
diff --git a/docs/cli-reference/dfxvm/dfxvm-install.mdx b/docs/cli-reference/dfxvm/dfxvm-install.mdx
index e43cbb4..9801edc 100644
--- a/docs/cli-reference/dfxvm/dfxvm-install.mdx
+++ b/docs/cli-reference/dfxvm/dfxvm-install.mdx
@@ -1,12 +1,6 @@
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
# dfxvm install
-
-
-Installs a version of dfx.
-
-## Usage
+Installs a version of `dfx`. Can be used for official release versions and beta releases.
```bash
dfxvm install
From b60bdf2756bfe16d087e292af51e3760c239626d Mon Sep 17 00:00:00 2001
From: Jessie Mongeon <133128541+jessiemongeon1@users.noreply.github.com>
Date: Mon, 5 May 2025 17:14:23 -0500
Subject: [PATCH 04/13] Update dfxvm-list.mdx
---
docs/cli-reference/dfxvm/dfxvm-list.mdx | 8 +-------
1 file changed, 1 insertion(+), 7 deletions(-)
diff --git a/docs/cli-reference/dfxvm/dfxvm-list.mdx b/docs/cli-reference/dfxvm/dfxvm-list.mdx
index de46c2b..b33f4db 100644
--- a/docs/cli-reference/dfxvm/dfxvm-list.mdx
+++ b/docs/cli-reference/dfxvm/dfxvm-list.mdx
@@ -1,12 +1,6 @@
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
# dfxvm list
-
-
-List installed or available versions of dfx.
-
-## Usage
+List the currently installed or available versions of `dfx`.
```bash
dfxvm list [OPTIONS]
From c0d2437999124fe48a214fdf8dc95db4b5ed8b70 Mon Sep 17 00:00:00 2001
From: Jessie Mongeon <133128541+jessiemongeon1@users.noreply.github.com>
Date: Mon, 5 May 2025 17:15:43 -0500
Subject: [PATCH 05/13] Update dfxvm-self-uninstall.mdx
---
docs/cli-reference/dfxvm/dfxvm-self-uninstall.mdx | 10 +---------
1 file changed, 1 insertion(+), 9 deletions(-)
diff --git a/docs/cli-reference/dfxvm/dfxvm-self-uninstall.mdx b/docs/cli-reference/dfxvm/dfxvm-self-uninstall.mdx
index 8616f00..91de9e4 100644
--- a/docs/cli-reference/dfxvm/dfxvm-self-uninstall.mdx
+++ b/docs/cli-reference/dfxvm/dfxvm-self-uninstall.mdx
@@ -1,12 +1,6 @@
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
# dfxvm self uninstall
-
-
-Uninstalls dfxvm and all versions of dfx.
-
-## Usage
+Uninstalls `dfxvm` and all versions of `dfx` with the opportunity to confirm or cancel.
```bash
dfxvm self uninstall [--yes]
@@ -20,8 +14,6 @@ dfxvm self uninstall [--yes]
## Examples
-Uninstall dfxvm and all versions of dfx, with an opportunity to confirm or cancel.
-
```bash
dfxvm self uninstall
```
From 50cc7dc6e637764d6573cfcf1bef0b38507e9978 Mon Sep 17 00:00:00 2001
From: Jessie Mongeon <133128541+jessiemongeon1@users.noreply.github.com>
Date: Mon, 5 May 2025 17:16:24 -0500
Subject: [PATCH 06/13] Update dfxvm-self-update.mdx
---
docs/cli-reference/dfxvm/dfxvm-self-update.mdx | 8 +-------
1 file changed, 1 insertion(+), 7 deletions(-)
diff --git a/docs/cli-reference/dfxvm/dfxvm-self-update.mdx b/docs/cli-reference/dfxvm/dfxvm-self-update.mdx
index 162f664..624fef5 100644
--- a/docs/cli-reference/dfxvm/dfxvm-self-update.mdx
+++ b/docs/cli-reference/dfxvm/dfxvm-self-update.mdx
@@ -1,12 +1,6 @@
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
# dfxvm self update
-
-
-Updates to the newest version of dfxvm.
-
-## Usage
+Updates to the newest version of `dfxvm`. Does not update to the latest version of `dfx`.
```bash
dfxvm self update
From 0d49abf50ff6941fec484340db24bcaed2d3abe0 Mon Sep 17 00:00:00 2001
From: Jessie Mongeon <133128541+jessiemongeon1@users.noreply.github.com>
Date: Mon, 5 May 2025 17:17:04 -0500
Subject: [PATCH 07/13] Update dfxvm-uninstall.mdx
---
docs/cli-reference/dfxvm/dfxvm-uninstall.mdx | 12 ++----------
1 file changed, 2 insertions(+), 10 deletions(-)
diff --git a/docs/cli-reference/dfxvm/dfxvm-uninstall.mdx b/docs/cli-reference/dfxvm/dfxvm-uninstall.mdx
index 82e1657..33e0cb7 100644
--- a/docs/cli-reference/dfxvm/dfxvm-uninstall.mdx
+++ b/docs/cli-reference/dfxvm/dfxvm-uninstall.mdx
@@ -1,20 +1,12 @@
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
# dfxvm uninstall
-
-
-Uninstalls a version of dfx.
-
-## Usage
+Uninstalls a specific version of `dfx`. Does not uninstall `dfxvm` itself.
```bash
dfxvm uninstall
```
-## Examples
-
-Uninstall a beta that you don't want anymore:
+## Example
```bash
dfxvm uninstall 0.15.1-beta.0
From 10ee1a790a79a3f32313209df70f79d0de8b5bfd Mon Sep 17 00:00:00 2001
From: Jessie Mongeon <133128541+jessiemongeon1@users.noreply.github.com>
Date: Mon, 5 May 2025 17:17:34 -0500
Subject: [PATCH 08/13] Update dfxvm-update.mdx
---
docs/cli-reference/dfxvm/dfxvm-update.mdx | 9 +--------
1 file changed, 1 insertion(+), 8 deletions(-)
diff --git a/docs/cli-reference/dfxvm/dfxvm-update.mdx b/docs/cli-reference/dfxvm/dfxvm-update.mdx
index 2c53cf2..38f3221 100644
--- a/docs/cli-reference/dfxvm/dfxvm-update.mdx
+++ b/docs/cli-reference/dfxvm/dfxvm-update.mdx
@@ -1,13 +1,6 @@
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
# dfxvm update
-
-
-Looks up the latest dfx version, installs it if not already installed, and
-sets it as the default version.
-
-## Usage
+Looks up the latest `dfx` version, installs it if not already installed, then sets it as the default version.
```bash
dfxvm update
From 5ee6f30881087c0f2cdc759e575015abe9e6c832 Mon Sep 17 00:00:00 2001
From: Jessie Mongeon <133128541+jessiemongeon1@users.noreply.github.com>
Date: Mon, 5 May 2025 17:18:14 -0500
Subject: [PATCH 09/13] Update dfxvm.mdx
---
docs/cli-reference/dfxvm/dfxvm.mdx | 4 ----
1 file changed, 4 deletions(-)
diff --git a/docs/cli-reference/dfxvm/dfxvm.mdx b/docs/cli-reference/dfxvm/dfxvm.mdx
index 2f1566a..8078aad 100644
--- a/docs/cli-reference/dfxvm/dfxvm.mdx
+++ b/docs/cli-reference/dfxvm/dfxvm.mdx
@@ -1,9 +1,5 @@
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
# dfxvm
-
-
`dfxvm` is the version manager for the command-line tool `dfx`.
When invoked as `dfxvm`, manages `dfx` versions or itself.
From f12f9d3b518ab89bf6a20df80a887e9837af6fac Mon Sep 17 00:00:00 2001
From: Jessie Mongeon <133128541+jessiemongeon1@users.noreply.github.com>
Date: Mon, 5 May 2025 17:20:39 -0500
Subject: [PATCH 10/13] Update dfxvm-init.mdx
---
docs/cli-reference/dfxvm-init/dfxvm-init.mdx | 17 ++++-------------
1 file changed, 4 insertions(+), 13 deletions(-)
diff --git a/docs/cli-reference/dfxvm-init/dfxvm-init.mdx b/docs/cli-reference/dfxvm-init/dfxvm-init.mdx
index 3b0b276..f0dfc16 100644
--- a/docs/cli-reference/dfxvm-init/dfxvm-init.mdx
+++ b/docs/cli-reference/dfxvm-init/dfxvm-init.mdx
@@ -1,15 +1,8 @@
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
# dfxvm-init
-
-
When invoked as `dfxvm-init`, `dfxvm` performs one-time installation tasks.
-By default, installs the latest version of dfx, and gives you an opportunity
-to customize the installation.
-
-## Usage
+By default, installs the latest version of dfx, and gives you an opportunity to customize the installation.
```bash
dfxvm-init [--dfx-version ] [--yes]
@@ -25,19 +18,17 @@ dfxvm-init [--dfx-version ] [--yes]
## Examples
-Install dfxvm and the latest version of dfx, with an opportunity
-to customize the installation
-
```bash
dfxvm-init
```
-Install dfxvm and dfx 0.14.4, with an opportunity to customize the installation
+Install `dfxvm` and `dfx 0.14.4`, with an opportunity to customize the installation:
+
```bash
dfxvm-init --dfx-version 0.14.4
```
-Install dfxvm and the latest version of dfx without prompting for confirmation
+Install `dfxvm` and the latest version of `dfx` without prompting for confirmation:
```bash
dfxvm-init --yes
From 3ee759acbb07c54aa5b0ae0c4ba4b3ecbd5029b8 Mon Sep 17 00:00:00 2001
From: Jessie Mongeon <133128541+jessiemongeon1@users.noreply.github.com>
Date: Tue, 6 May 2025 10:12:24 -0500
Subject: [PATCH 11/13] Update dfx.mdx
---
docs/cli-reference/dfx/dfx.mdx | 69 ++++++++++++----------------------
1 file changed, 25 insertions(+), 44 deletions(-)
diff --git a/docs/cli-reference/dfx/dfx.mdx b/docs/cli-reference/dfx/dfx.mdx
index a68c00f..eae55cc 100644
--- a/docs/cli-reference/dfx/dfx.mdx
+++ b/docs/cli-reference/dfx/dfx.mdx
@@ -1,82 +1,63 @@
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
+# Determining `dfx` version
-# dfx
+When invoked as `dfx`, `dfxvm` determines which version of `dfx` to use for execution by checking these criteria in order:
-
+1. `+` parameter from command line.
+2. `DFX_VERSION` environment variable.
+3. `dfx` setting in the current project's `dfx.json`.
+4. `default_version` in `$HOME/.config/dfx/version-manager.json`.
+#### 1. Command line
-When invoked as `dfx`, `dfxvm` determines which version of dfx to use
-and dispatches execution to it.
-
-## dfx version determination
-
-`dfxvm` determines which version of dfx to use by checking these criteria
-in order:
-
-1. `+` parameter from command line
-2. `DFX_VERSION` environment variable
-3. `dfx` in the current project's `dfx.json`
-4. `default_version` in `$HOME/.config/dfx/version-manager.json`
-
-### Command Line
-
-You can specify the version of dfx to use on the command line by passing
-`+` as the first parameter. For example, the following will deploy
-using dfx 0.15.0:
+You can specify the version of `dfx` on the command line by passing `+` as the first parameter. For example, the following will deploy using `dfx v0.26.0`:
```bash
-dfx +0.15.0 deploy
+dfx +0.26.0 deploy
```
-### DFX_VERSION environment variable
+#### 2. `DFX_VERSION` environment variable
-You can specify the version of dfx to use by setting the `DFX_VERSION`
-environment variable. For example, the following will start the replica using
-dfx 0.15.0:
+You can specify the version of `dfx` by setting the `DFX_VERSION` environment variable. For example, the following will start the local developer environment using `dfx v0.26.0`:
```bash
-DFX_VERSION=0.15.0 dfx start --clean --background
+DFX_VERSION=0.26.0 dfx start --clean --background
```
-### dfx field in the current project's dfx.json
+#### 3. `dfx` field in the current project's `dfx.json`
-If running dfxvm as dfx in a dfx project, and the project's dfx.json contains a
-top-level field "dfx", then dfxvm will use the version specified in that field.
+A project's `dfx.json` file can contain a top-level field "dfx". If specified, then `dfxvm` will use that version.
-Like dfx, dfxvm looks for dfx.json in the current directory and then in
-parent directories until it finds one or reaches the root directory.
+Like `dfx`, `dfxvm` looks for `dfx.json` in the current directory and then in parent directories until it finds one or reaches the root directory.
For example:
```json
{
- "dfx": "0.14.4",
+ "dfx": "0.26.1",
"canisters": { }
}
```
-If the above dfx.json were in the current directory or any parent directory,
-then any dfx command would use dfx 0.14.4.
+If the above `dfx.json` were in the current directory or any parent directory, then any `dfx` command would use `dfx v0.26.1`.
-### default_version in $HOME/.config/dfx/version-manager.json
+#### 4. `default_version` in `$HOME/.config/dfx/version-manager.json`
-If none of the above criteria are met, then dfxvm will use the version specified
-in `$HOME/.config/dfx/version-manager.json`. For example:
+If none of the above criteria are met, then `dfxvm` will use the version specified in `$HOME/.config/dfx/version-manager.json`. For example:
```json
{
- "default_version": "0.15.0"
+ "default_version": "0.26.0"
}
```
To configure the default dfx version, use the `dfxvm default` command:
```bash
-dfxvm default 0.15.1
+dfxvm default 0.26.1
```
-## Environment Variables
+## Environment variables
-When proxying to dfx, dfxvm alters the environment in two ways:
-- Sets `DFX_VERSION` to the version of dfx being used.
-- Prepends the bin directory for the dfx version to `PATH`.
+When proxying to `dfx`, `dfxvm` alters the environment in two ways:
+- Sets `DFX_VERSION` to the version of `dfx` being used.
+- Prepends the `bin` directory for the `dfx` version to `PATH`.
From cc456a5bb73da88472f8ffddd0bb49729c9d9bfa Mon Sep 17 00:00:00 2001
From: Jessie Mongeon <133128541+jessiemongeon1@users.noreply.github.com>
Date: Tue, 6 May 2025 11:09:11 -0500
Subject: [PATCH 12/13] Update and rename index.mdz to index.md
---
docs/cli-reference/{index.mdz => index.md} | 4 ----
1 file changed, 4 deletions(-)
rename docs/cli-reference/{index.mdz => index.md} (88%)
diff --git a/docs/cli-reference/index.mdz b/docs/cli-reference/index.md
similarity index 88%
rename from docs/cli-reference/index.mdz
rename to docs/cli-reference/index.md
index 313a840..b335a6d 100644
--- a/docs/cli-reference/index.mdz
+++ b/docs/cli-reference/index.md
@@ -1,9 +1,5 @@
-import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
-
# Command-line reference
-
-
The dfxvm binary is a chimera, changing its behavior based on
the name of the binary.
From a6b45d30c55af65d7cc181596824d93b0799b211 Mon Sep 17 00:00:00 2001
From: Jessie Mongeon
Date: Tue, 6 May 2025 12:51:08 -0500
Subject: [PATCH 13/13] fix chips
---
docs/cli-reference/dfx/dfx.mdx | 4 ++++
docs/cli-reference/dfxvm-init/dfxvm-init.mdx | 4 ++++
docs/cli-reference/dfxvm/dfxvm-default.mdx | 4 ++++
docs/cli-reference/dfxvm/dfxvm-install.mdx | 4 ++++
docs/cli-reference/dfxvm/dfxvm-list.mdx | 4 ++++
docs/cli-reference/dfxvm/dfxvm-self-uninstall.mdx | 4 ++++
docs/cli-reference/dfxvm/dfxvm-self-update.mdx | 4 ++++
docs/cli-reference/dfxvm/dfxvm-uninstall.mdx | 4 ++++
docs/cli-reference/dfxvm/dfxvm-update.mdx | 4 ++++
docs/cli-reference/dfxvm/dfxvm.mdx | 4 ++++
10 files changed, 40 insertions(+)
diff --git a/docs/cli-reference/dfx/dfx.mdx b/docs/cli-reference/dfx/dfx.mdx
index eae55cc..c7cb1e4 100644
--- a/docs/cli-reference/dfx/dfx.mdx
+++ b/docs/cli-reference/dfx/dfx.mdx
@@ -1,5 +1,9 @@
+import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
+
# Determining `dfx` version
+
+
When invoked as `dfx`, `dfxvm` determines which version of `dfx` to use for execution by checking these criteria in order:
1. `+` parameter from command line.
diff --git a/docs/cli-reference/dfxvm-init/dfxvm-init.mdx b/docs/cli-reference/dfxvm-init/dfxvm-init.mdx
index f0dfc16..5a5e1ea 100644
--- a/docs/cli-reference/dfxvm-init/dfxvm-init.mdx
+++ b/docs/cli-reference/dfxvm-init/dfxvm-init.mdx
@@ -1,5 +1,9 @@
+import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
+
# dfxvm-init
+
+
When invoked as `dfxvm-init`, `dfxvm` performs one-time installation tasks.
By default, installs the latest version of dfx, and gives you an opportunity to customize the installation.
diff --git a/docs/cli-reference/dfxvm/dfxvm-default.mdx b/docs/cli-reference/dfxvm/dfxvm-default.mdx
index c7534e3..1e2a52a 100644
--- a/docs/cli-reference/dfxvm/dfxvm-default.mdx
+++ b/docs/cli-reference/dfxvm/dfxvm-default.mdx
@@ -1,5 +1,9 @@
+import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
+
# dfxvm default
+
+
Sets or displays the `dfx` version that should be used by default.
When setting the default version, `dfxvm default` installs the specified version if it is not already installed.
diff --git a/docs/cli-reference/dfxvm/dfxvm-install.mdx b/docs/cli-reference/dfxvm/dfxvm-install.mdx
index 9801edc..2aea9a3 100644
--- a/docs/cli-reference/dfxvm/dfxvm-install.mdx
+++ b/docs/cli-reference/dfxvm/dfxvm-install.mdx
@@ -1,5 +1,9 @@
+import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
+
# dfxvm install
+
+
Installs a version of `dfx`. Can be used for official release versions and beta releases.
```bash
diff --git a/docs/cli-reference/dfxvm/dfxvm-list.mdx b/docs/cli-reference/dfxvm/dfxvm-list.mdx
index b33f4db..d52a3fa 100644
--- a/docs/cli-reference/dfxvm/dfxvm-list.mdx
+++ b/docs/cli-reference/dfxvm/dfxvm-list.mdx
@@ -1,5 +1,9 @@
+import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
+
# dfxvm list
+
+
List the currently installed or available versions of `dfx`.
```bash
diff --git a/docs/cli-reference/dfxvm/dfxvm-self-uninstall.mdx b/docs/cli-reference/dfxvm/dfxvm-self-uninstall.mdx
index 91de9e4..71d1127 100644
--- a/docs/cli-reference/dfxvm/dfxvm-self-uninstall.mdx
+++ b/docs/cli-reference/dfxvm/dfxvm-self-uninstall.mdx
@@ -1,5 +1,9 @@
+import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
+
# dfxvm self uninstall
+
+
Uninstalls `dfxvm` and all versions of `dfx` with the opportunity to confirm or cancel.
```bash
diff --git a/docs/cli-reference/dfxvm/dfxvm-self-update.mdx b/docs/cli-reference/dfxvm/dfxvm-self-update.mdx
index 624fef5..f2dabdf 100644
--- a/docs/cli-reference/dfxvm/dfxvm-self-update.mdx
+++ b/docs/cli-reference/dfxvm/dfxvm-self-update.mdx
@@ -1,5 +1,9 @@
+import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
+
# dfxvm self update
+
+
Updates to the newest version of `dfxvm`. Does not update to the latest version of `dfx`.
```bash
diff --git a/docs/cli-reference/dfxvm/dfxvm-uninstall.mdx b/docs/cli-reference/dfxvm/dfxvm-uninstall.mdx
index 33e0cb7..67cd9a3 100644
--- a/docs/cli-reference/dfxvm/dfxvm-uninstall.mdx
+++ b/docs/cli-reference/dfxvm/dfxvm-uninstall.mdx
@@ -1,5 +1,9 @@
+import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
+
# dfxvm uninstall
+
+
Uninstalls a specific version of `dfx`. Does not uninstall `dfxvm` itself.
```bash
diff --git a/docs/cli-reference/dfxvm/dfxvm-update.mdx b/docs/cli-reference/dfxvm/dfxvm-update.mdx
index 38f3221..2ef6db1 100644
--- a/docs/cli-reference/dfxvm/dfxvm-update.mdx
+++ b/docs/cli-reference/dfxvm/dfxvm-update.mdx
@@ -1,5 +1,9 @@
+import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
+
# dfxvm update
+
+
Looks up the latest `dfx` version, installs it if not already installed, then sets it as the default version.
```bash
diff --git a/docs/cli-reference/dfxvm/dfxvm.mdx b/docs/cli-reference/dfxvm/dfxvm.mdx
index 8078aad..2f1566a 100644
--- a/docs/cli-reference/dfxvm/dfxvm.mdx
+++ b/docs/cli-reference/dfxvm/dfxvm.mdx
@@ -1,5 +1,9 @@
+import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
+
# dfxvm
+
+
`dfxvm` is the version manager for the command-line tool `dfx`.
When invoked as `dfxvm`, manages `dfx` versions or itself.