diff --git a/documentation/docs/getting-started/installation.md b/documentation/docs/getting-started/installation.md
index d6a71c77452..ac67d4960e1 100644
--- a/documentation/docs/getting-started/installation.md
+++ b/documentation/docs/getting-started/installation.md
@@ -29,7 +29,7 @@ import { PanelLeft } from 'lucide-react';
           2. Run the executable file to launch the goose Desktop application.
 
           :::tip Updating goose
-          It's best to keep goose updated by periodically running the installation steps again.
+          It's best to periodically [update goose](/docs/guides/updating-goose).
           :::
         </div>
         <h3>Option 2: Install via Homebrew</h3>
@@ -99,7 +99,7 @@ import { PanelLeft } from 'lucide-react';
           4. Launch goose from the app menu
 
           :::tip Updating goose
-          It's best to keep goose updated by periodically running the installation steps again.
+          It's best to periodically [update goose](/docs/guides/updating-goose).
           :::
         </div>
       </TabItem>
@@ -142,7 +142,7 @@ import { PanelLeft } from 'lucide-react';
           2. Run the executable file to launch the goose Desktop application.
 
           :::tip Updating goose
-          It's best to keep goose updated by periodically running the installation steps again.
+          It's best to periodically [update goose](/docs/guides/updating-goose).
           :::
         </div>
       </TabItem>
diff --git a/documentation/docs/guides/updating-goose.md b/documentation/docs/guides/updating-goose.md
index ad37a6ffee3..25199a8a45a 100644
--- a/documentation/docs/guides/updating-goose.md
+++ b/documentation/docs/guides/updating-goose.md
@@ -6,6 +6,7 @@ sidebar_label: Updating goose
 
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
+import { DesktopAutoUpdateSteps } from '@site/src/components/DesktopAutoUpdateSteps';
 import MacDesktopInstallButtons from '@site/src/components/MacDesktopInstallButtons';
 import WindowsDesktopInstallButtons from '@site/src/components/WindowsDesktopInstallButtons';
 import LinuxDesktopInstallButtons from '@site/src/components/LinuxDesktopInstallButtons';
@@ -16,16 +17,16 @@ The goose CLI and desktop apps are under active and continuous development. To g
   <TabItem value="mac" label="macOS" default>
     <Tabs groupId="interface">
       <TabItem value="ui" label="goose Desktop" default>
-        :::info
-        To update goose to the latest stable version, reinstall using the instructions below
-        :::
-        <div style={{ marginTop: '1rem' }}>
-          1. <MacDesktopInstallButtons/>
-          2. Unzip the downloaded zip file.
-          3. Run the executable file to launch the goose Desktop application.
-          4. Overwrite the existing goose application with the new version.
-          5. Run the executable file to launch the goose Desktop application.
-        </div>
+        Update goose to the latest stable version.
+
+        <DesktopAutoUpdateSteps />
+        
+        **To manually download and install updates:**
+        1. <MacDesktopInstallButtons/>
+        2. Unzip the downloaded zip file
+        3. Drag the extracted `Goose.app` file to the `Applications` folder to overwrite your current version
+        4. Launch goose Desktop
+
       </TabItem>
       <TabItem value="cli" label="goose CLI">
         You can update goose by running:
@@ -62,19 +63,17 @@ The goose CLI and desktop apps are under active and continuous development. To g
   <TabItem value="linux" label="Linux">
     <Tabs groupId="interface">
       <TabItem value="ui" label="goose Desktop" default>
-        :::info
-        To update goose to the latest stable version, reinstall using the instructions below
-        :::
-        <div style={{ marginTop: '1rem' }}>
-          1. <LinuxDesktopInstallButtons/>
-          
-          **For Debian/Ubuntu-based distributions:**
-          2. Download the DEB file
-          3. Navigate to the directory where it is saved in a terminal
-          4. Run `sudo dpkg -i (filename).deb`
-          5. Launch goose from the app menu
-
-        </div>
+        Update goose to the latest stable version.
+
+        <DesktopAutoUpdateSteps />
+        
+        **To manually download and install updates:**
+        1. <LinuxDesktopInstallButtons/>
+
+        #### For Debian/Ubuntu-based distributions
+        2. In a terminal, navigate to the downloaded DEB file
+        3. Run `sudo dpkg -i (filename).deb`
+        4. Launch goose from the app menu
       </TabItem>
       <TabItem value="cli" label="goose CLI">
         You can update goose by running:
@@ -111,16 +110,14 @@ The goose CLI and desktop apps are under active and continuous development. To g
   <TabItem value="windows" label="Windows">
     <Tabs groupId="interface">
       <TabItem value="ui" label="goose Desktop" default>
-        :::info
-        To update goose to the latest stable version, reinstall using the instructions below
-        :::
-        <div style={{ marginTop: '1rem' }}>
-          1. <WindowsDesktopInstallButtons/>
-          2. Unzip the downloaded zip file.
-          3. Run the executable file to launch the goose Desktop application.
-          4. Overwrite the existing goose application with the new version.
-          5. Run the executable file to launch the goose Desktop application.
-        </div>
+        Update goose to the latest stable version.
+
+        <DesktopAutoUpdateSteps />
+        
+        **To manually download and install updates:**
+        1. <WindowsDesktopInstallButtons/>
+        2. Unzip the downloaded zip file
+        3. Run the executable file to launch the goose Desktop app
       </TabItem>
       <TabItem value="cli" label="goose CLI">
         You can update goose by running:
@@ -164,4 +161,4 @@ The goose CLI and desktop apps are under active and continuous development. To g
       </TabItem>
     </Tabs>
   </TabItem>
-</Tabs>
\ No newline at end of file
+</Tabs>
diff --git a/documentation/src/components/CLIExtensionInstructions.tsx b/documentation/src/components/CLIExtensionInstructions.tsx
index f99adfbce28..6ab4168a7f6 100644
--- a/documentation/src/components/CLIExtensionInstructions.tsx
+++ b/documentation/src/components/CLIExtensionInstructions.tsx
@@ -162,7 +162,7 @@ ${
 
       <ol start={5}>
         <li>
-          Enter the number of seconds Goose should wait for actions to complete before timing out. Default is{' '}
+          Enter the number of seconds goose should wait for actions to complete before timing out. Default is{' '}
           <code>300</code> seconds.
         </li>
       </ol>
diff --git a/documentation/src/components/DesktopAutoUpdateSteps.js b/documentation/src/components/DesktopAutoUpdateSteps.js
new file mode 100644
index 00000000000..f001b965552
--- /dev/null
+++ b/documentation/src/components/DesktopAutoUpdateSteps.js
@@ -0,0 +1,23 @@
+import React from "react";
+import { PanelLeft } from "lucide-react";
+
+export const DesktopAutoUpdateSteps = () => {
+  return (
+    <>
+      <p><strong>To automatically download and install updates:</strong></p>
+      <ol>
+        <li>Click the <PanelLeft className="inline" size={16} /> button in the top-left to open the sidebar</li>
+        <li>Click <code>Settings</code> in the sidebar</li>
+        <li>Click <code>App</code></li>
+        <li>Scroll down to the <code>Updates</code> section:
+          <ul>
+            <li>Check if your current version is "up to date" or if a newer version is available</li>
+            <li>To automatically download the newer version, click <code>Check for Updates</code></li>
+          </ul>
+        </li>
+        <li>Click <code>Install & Restart</code> to immediately relaunch goose Desktop and apply the update<br />
+            <strong>Note:</strong> If the app can't be automatically updated, you'll be prompted to manually install the downloaded version</li>
+      </ol>
+    </>
+  );
+};
diff --git a/documentation/src/components/LinuxDesktopInstallButtons.js b/documentation/src/components/LinuxDesktopInstallButtons.js
index 3de0445d109..c249b402214 100644
--- a/documentation/src/components/LinuxDesktopInstallButtons.js
+++ b/documentation/src/components/LinuxDesktopInstallButtons.js
@@ -57,7 +57,7 @@ const LinuxDesktopInstallButtons = () => {
 
   return (
     <div>
-      <p>To download Goose Desktop for Linux, click one of the buttons below:</p>
+      <p>Click one of the buttons below to download goose Desktop for Linux:</p>
       <div className="pill-button" style={{ display: 'flex', gap: '0.5rem', flexWrap: 'wrap' }}>
         <Link
           className="button button--primary button--lg"
diff --git a/documentation/src/components/MacDesktopInstallButtons.js b/documentation/src/components/MacDesktopInstallButtons.js
index e9aae272b14..00f2ae10768 100644
--- a/documentation/src/components/MacDesktopInstallButtons.js
+++ b/documentation/src/components/MacDesktopInstallButtons.js
@@ -4,7 +4,7 @@ import { IconDownload } from "@site/src/components/icons/download";
 const DesktopInstallButtons = () => {
   return (
     <div>
-      <p>To download Goose Desktop for macOS, click one of the buttons below:</p>
+      <p>Click one of the buttons below to download goose Desktop for macOS:</p>
       <div className="pill-button">
         <Link
           className="button button--primary button--lg"
diff --git a/documentation/src/components/ModelSelectionTip.js b/documentation/src/components/ModelSelectionTip.js
index bb424f60224..c7445235a57 100644
--- a/documentation/src/components/ModelSelectionTip.js
+++ b/documentation/src/components/ModelSelectionTip.js
@@ -2,6 +2,6 @@ import React from "react";
 
 export const ModelSelectionTip = () => {
   return (
-    <p>Goose relies heavily on tool calling capabilities and currently works best with Claude 4 models.</p>
+    <p>goose relies heavily on tool calling capabilities and currently works best with Claude 4 models.</p>
   );
 };
diff --git a/documentation/src/components/OnboardingProviderSetup.js b/documentation/src/components/OnboardingProviderSetup.js
index c515d089da9..58fae0c6440 100644
--- a/documentation/src/components/OnboardingProviderSetup.js
+++ b/documentation/src/components/OnboardingProviderSetup.js
@@ -18,7 +18,7 @@ export const OnboardingProviderSetup = () => {
               </h5>
             </div>
             <div className="admonition-content" style={{paddingBottom: '1rem'}}>
-              <p style={{marginBottom: '0'}}>You'll receive $10 in free credits the first time you automatically authenticate with Tetrate through Goose. This offer is available to both new and existing Tetrate users.</p>
+              <p style={{marginBottom: '0'}}>You'll receive $10 in free credits the first time you automatically authenticate with Tetrate through goose. This offer is available to both new and existing Tetrate users.</p>
             </div>
           </div>
         </li>
diff --git a/documentation/src/components/RateLimits.js b/documentation/src/components/RateLimits.js
index 5a996e209fc..6a28b14197d 100644
--- a/documentation/src/components/RateLimits.js
+++ b/documentation/src/components/RateLimits.js
@@ -21,7 +21,7 @@ export const RateLimits = () => {
       <a href="/goose/docs/guides/handling-llm-rate-limits-with-goose" target="_blank">
         Handling Rate Limits
       </a>{" "}
-      guide to learn how to efficiently manage these limits while using Goose.
+      guide to learn how to efficiently manage these limits while using goose.
     </Admonition>
   );
 };
diff --git a/documentation/src/components/SupportedEnvironments.js b/documentation/src/components/SupportedEnvironments.js
index b1645cee987..6b6166d07f5 100644
--- a/documentation/src/components/SupportedEnvironments.js
+++ b/documentation/src/components/SupportedEnvironments.js
@@ -4,8 +4,8 @@ import Admonition from "@theme/Admonition";
 const SupportedEnvironments = () => {
   return (
     <Admonition type="info" title="Supported Environments">
-      The Goose CLI currently works on <strong>macOS</strong> and <strong>Linux</strong> systems and supports both <strong>ARM</strong> and <strong>x86</strong> architectures. 
-      On <strong>Windows</strong>, Goose CLI can run via WSL, and Goose Desktop is natively supported. If you'd like to request support for additional operating systems, please{" "}
+      The goose CLI currently works on <strong>macOS</strong> and <strong>Linux</strong> systems and supports both <strong>ARM</strong> and <strong>x86</strong> architectures. 
+      On <strong>Windows</strong>, goose CLI can run via WSL, and goose Desktop is natively supported. If you'd like to request support for additional operating systems, please{" "}
       <a
         href="https://github.com/block/goose/discussions/867"
         target="_blank"
diff --git a/documentation/src/components/WindowsDesktopInstallButtons.js b/documentation/src/components/WindowsDesktopInstallButtons.js
index f33cf5f2434..34f26ee3814 100644
--- a/documentation/src/components/WindowsDesktopInstallButtons.js
+++ b/documentation/src/components/WindowsDesktopInstallButtons.js
@@ -4,7 +4,7 @@ import { IconDownload } from "@site/src/components/icons/download";
 const WindowsDesktopInstallButtons = () => {
   return (
     <div>
-      <p>To download Goose Desktop for Windows, click the button below:</p>
+      <p>Click one of the buttons below to download goose Desktop for Windows:</p>
       <div className="pill-button">
         <Link
           className="button button--primary button--lg"
diff --git a/documentation/src/components/recipe-card.tsx b/documentation/src/components/recipe-card.tsx
index eafb78cc424..8808cdb48c5 100644
--- a/documentation/src/components/recipe-card.tsx
+++ b/documentation/src/components/recipe-card.tsx
@@ -103,7 +103,7 @@ export function RecipeCard({ recipe }: { recipe: Recipe }) {
               rel="noopener noreferrer"
               onClick={(e) => e.stopPropagation()}
             >
-              Launch in Goose Desktop →
+              Launch in goose Desktop →
             </a>
 
             <div className="relative group">
@@ -177,7 +177,7 @@ export function RecipeCard({ recipe }: { recipe: Recipe }) {
                 onClick={handleSubmitParams}
                 className="bg-purple-600 text-white px-4 py-2 rounded text-sm hover:bg-purple-700"
               >
-                Copy Goose CLI Command
+                Copy goose CLI Command
               </button>
             </div>
           </div>