fixes #137

Author: kiwicopple

docs/install-cli.md renamed to docs/cli.md

@@ -1,4 +1,8 @@
-The dbdev CLI is required to publish your TLE to [database.dev](https://database.dev/).
+The `dbdev` CLI can be used for:
+
+- Installing TLEs from [database.dev] or your local machine.
+- Updating TLEs from [database.dev] or your local machine.
+- Publishing TLEs to [database.dev](https://database.dev/).
 
 ## Installation
 
@@ -37,6 +41,42 @@ Installation is available through a native package, binary download or building
     scoop install dbdev
     ```
 
+## Upgrading
+
+Use `dbdev --version` to check if you are on the latest version of the CLI.
+
+### Native Package
+
+=== "macOS"
+
+    Upgrade the CLI with [Homebrew](https://brew.sh/):
+    ```
+    brew upgrade dbdev
+    ```
+
+=== "Linux"
+
+    Install the CLI with [Homebrew](https://brew.sh/):
+    ```
+    brew upgrade dbdev
+    ```
+
+    #### Linux packages
+
+    Debian Linux packages are provided in [Releases](https://github.com/supabase/dbdev/releases).
+    To upgrade, download the `.deb` file and run the following:
+
+    ```
+    sudo dpkg -i <...>.deb
+    ```
+
+=== "Windows"
+
+    Update the CLI with [Scoop](https://scoop.sh/).
+    ```
+    scoop update dbdev
+    ```
+
 ### Binary Download
 
 Binaries for dbdev CLI are available for Linux, Windows and macOS platforms. Visit the [dbdev releases page](https://github.com/supabase/dbdev/releases) to download a binary for your OS. The downloaded binary should be placed in a folder which is in your [PATH](<https://en.wikipedia.org/wiki/PATH_(variable)>).

mkdocs.yaml

@@ -7,7 +7,7 @@ repo_url: https://github.com/supabase/dbdev
 
 nav:
     - Welcome: 'index.md'
-    - Install CLI: 'install-cli.md'
+    - Using the CLI: 'cli.md'
     - Publish a Package: 'publish-extension.md'
     - Install a Package: 'install-in-db-client.md'
     - Structure of a Postgres Extension: 'extension_structure.md'