From 1c1d25ecdece62450a49b17477c6ee344dbe6b9c Mon Sep 17 00:00:00 2001
From: Steven Vandevelde <steven@tokono.ma>
Date: Fri, 24 Jul 2026 22:26:47 +0200
Subject: [PATCH] chore: a few copy updates to make it easier to grasp

---
 src/facets/data/file-manager/index.inline.js | 6 ++++++
 src/guide.vto                                | 2 +-
 src/index.vto                                | 6 +++---
 3 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/src/facets/data/file-manager/index.inline.js b/src/facets/data/file-manager/index.inline.js
index df47cc60..c55942cd 100644
--- a/src/facets/data/file-manager/index.inline.js
+++ b/src/facets/data/file-manager/index.inline.js
@@ -210,6 +210,12 @@ const { setLocalItems, setRemoteItems, setError } = setup({
   title: "File Manager",
   description: html`
     <p>Upload audio files to play them and optionally sync them with your cloud storage. These are automatically added as inputs (aka. sources).</p>
+
+    <p>
+      <small>
+        Got music stored elsewhere, or don't want Diffuse to manage your music? There's a bunch more options to <a href="../l/?path=facets%2Fconnect%2Findex.html">connect</a> to with just read-only access.
+      </small>
+    </p>
   `,
 
   leftContent: html`
diff --git a/src/guide.vto b/src/guide.vto
index e7142595..4365837b 100644
--- a/src/guide.vto
+++ b/src/guide.vto
@@ -97,7 +97,7 @@ title: Guide | Diffuse
 
     <ul class="flex" style="color: var(--accent-twist-2);">
       <li>
-        <a class="with-icon" href="{{ ('facets/connect/index.html') |> facetLoaderURL }}">
+        <a class="with-icon" href="{{ ('facets/data/file-manager/index.html') |> facetLoaderURL }}">
           <i class="ph-fill ph-number-circle-one" style="opacity: 0.25"></i>
           <i class="ph-fill ph-file-audio"></i>
           <span>Add some audio</span>
diff --git a/src/index.vto b/src/index.vto
index aa3b0859..3c4af392 100644
--- a/src/index.vto
+++ b/src/index.vto
@@ -104,14 +104,14 @@ styles:
       <h3>How does it work?</h3>
 
       <p>
-        The main idea is that you upload your audio files to your cloud storage and then consume those through Diffuse. It provides a malleable and cooperative platform along with a set of building blocks that allow you to shape your own (audio) software.</p>
+        The main idea is that you upload your audio files to your browser or cloud storage, and then consume those through Diffuse. It provides a malleable and cooperative platform along with a set of building blocks that allow you to shape your own audio-listening software.</p>
 
       <p>
-        The default setup is focused on playing that audio from various sources, browsing your collection through multiple diverse user interfaces, making playlists, adding items as favourites, etc. Besides the defaults, you can build and share your own interfaces and features.
+        The default setup is focused on playing your audio wherever it may be stored, browsing your collection through multiple diverse user interfaces, making playlists, adding items as favourites, etc. Besides the defaults, you can build and share your own interfaces and features.
       </p>
 
       <p>
-        It provides this using a web application that lives solely in your browser. If you're looking at this on the official <a href="https://elements.diffuse.sh">diffuse.sh</a> domain, you can pick the version of said web application. There's also the option to self-host. The code is <a href="https://tangled.org/tokono.ma/diffuse">open</a> <a href="https://tangled.org/tokono.ma/diffuse-artifacts">source</a>.
+        It provides all this using a web application that lives solely in your browser. If you're looking at this on the official <a href="https://elements.diffuse.sh">diffuse.sh</a> domain, you can pick the version of said web application. There's also the option to self-host. The code for both <a href="https://tangled.org/tokono.ma/diffuse">Diffuse</a> itself and the <a href="https://tangled.org/tokono.ma/diffuse-artifacts">version picker setup</a> is open-source.
       </p>
     </div>
 
-- 
2.51.2