diff --git a/README.md b/README.md
index e3c50464..dfc3fdfa 100644
--- a/README.md
+++ b/README.md
@@ -159,6 +159,7 @@ shown below. Can't see yours? Have a look at the [extra platform instructions](h
    ```sh
    curl -fsSL https://starship.rs/install.sh | bash
    ```
+   To update the Starship itself, rerun the above script. It will replace the current version without touching Starship's configuration.
 
    #### Install via Package Manager
 
diff --git a/docs/README.md b/docs/README.md
index 2e63684b..35536654 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -37,6 +37,7 @@ description: Starship is the minimal, blazing fast, and extremely customizable p
    ```sh
    curl -fsSL https://starship.rs/install.sh | bash
    ```
+   To update the Starship itself, rerun the above script. It will replace the current version without touching Starship's configuration.
 
    #### Install via Package Manager
 
@@ -124,4 +125,3 @@ description: Starship is the minimal, blazing fast, and extremely customizable p
 
    eval `starship init tcsh`
    ```
-