From 1b665f41573c0f4421c96835e1c8811a55ac7267 Mon Sep 17 00:00:00 2001
From: Samuel Onoja <samiodev@icloud.com>
Date: Wed, 30 Sep 2026 16:17:14 +0100
Subject: [PATCH] update document wordings

---
 README.md          |   6 +-
 docs/why-ferese.md |   4 +-
 site/index.html    | 237 +++++++++++++++++++++------------------------
 3 files changed, 115 insertions(+), 132 deletions(-)

diff --git a/README.md b/README.md
index 6bd1c4a..ffa7629 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
   <img src="docs/images/ferese-lockup.svg" width="300" alt="Ferese">
 </p>
 
-<p align="center"><strong>A Wayland desktop with scrolling layouts and a shared theme.</strong></p>
+<p align="center"><strong>A complete Wayland desktop built around personalization</strong></p>
 
 <p align="center">
   <a href="docs/installation.md">Install</a> ·
@@ -11,9 +11,7 @@
   <a href="docs/README.md">Documentation</a>
 </p>
 
-Ferese is a Linux desktop with scrolling columns, tree tiling, and floating
-windows. It includes a top bar, Settings, notifications, desktop widgets, a
-lock screen, and screen sharing. Change themes and settings without restarting.
+Ferese is a window manager and desktop shell built together and configured in one place, for people who want their desktop to be their own.
 
 ![Ferese Blue desktop with Settings and Control Center](docs/images/screenshots/ferese-main-hero.png)
 
diff --git a/docs/why-ferese.md b/docs/why-ferese.md
index 8dd30fb..c197162 100644
--- a/docs/why-ferese.md
+++ b/docs/why-ferese.md
@@ -1,8 +1,6 @@
 # Why Ferese
 
-Ferese combines window management and a desktop shell with one configuration.
-Settings, the bar, notifications, widgets, authentication prompts, and the lock
-screen share colors and fonts.
+Most Wayland desktops are assembled from separate programs such as a compositor, a bar, a notification daemon, a launcher, a lock screen with each having its own config and its own idea of how things should look. Ferese is built as one desktop. Window management and the shell share a single configuration, so personalizing it means changing one thing, not five.
 
 ## Choose how windows fit
 
diff --git a/site/index.html b/site/index.html
index 8d49990..5921ee5 100644
--- a/site/index.html
+++ b/site/index.html
@@ -1,134 +1,121 @@
 <!doctype html>
 <html lang="en">
-  <head>
-    <meta charset="utf-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <meta name="theme-color" content="#10151c" />
-    <meta
-      name="description"
-      content="Ferese is a Linux Wayland desktop with scrolling layouts, native Settings, and a shared theme."
-    />
-    <meta
-      property="og:title"
-      content="Ferese — Wayland desktop"
-    />
-    <meta
-      property="og:description"
-      content="A Wayland desktop with scrolling layouts and a shared theme."
-    />
-    <meta property="og:type" content="website" />
-    <meta
-      property="og:image"
-      content="https://ferese-wm.github.io/ferese/assets/screenshots/ferese-main-hero.png"
-    />
-    <meta name="twitter:card" content="summary_large_image" />
-    <title>Ferese — Wayland desktop</title>
-    <link rel="icon" href="assets/ferese.svg" type="image/svg+xml" />
-    <link rel="stylesheet" href="styles.css?v=jetbrains" />
-  </head>
-  <body>
-    <a class="skip" href="#main">Skip to content</a>
-    <header class="site-header">
-      <div class="header-inner">
-        <a class="wordmark" href="./" aria-label="Ferese home"
-          ><svg viewBox="0 0 24 24" aria-hidden="true">
-            <path d="M3 3h6v18H3zM11 3h10v6H11zM11 11h7v6h-7z" /></svg
-          >ferese</a
-        >
-        <nav aria-label="Main navigation">
-          <a href="./" aria-current="page">Overview</a
-          ><a href="docs/screenshots.html">Screenshots</a
-          ><a href="docs/">Documentation</a
-          ><a href="https://github.com/ferese-wm/ferese"
-            >GitHub <svg class="link-arrow" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M7 17 17 7M7 7h10v10"/></svg></a
-          >
-        </nav>
+
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <meta name="theme-color" content="#10151c" />
+  <meta name="description" content="Ferese is a Wayland desktop built around personalization." />
+  <meta property="og:title" content="Ferese — Wayland desktop" />
+  <meta property="og:description" content="A Wayland desktop built around personalization." />
+  <meta property="og:type" content="website" />
+  <meta property="og:image" content="https://ferese-wm.github.io/ferese/assets/screenshots/ferese-main-hero.png" />
+  <meta name="twitter:card" content="summary_large_image" />
+  <title>Ferese — Wayland desktop</title>
+  <link rel="icon" href="assets/ferese.svg" type="image/svg+xml" />
+  <link rel="stylesheet" href="styles.css?v=jetbrains" />
+</head>
+
+<body>
+  <a class="skip" href="#main">Skip to content</a>
+  <header class="site-header">
+    <div class="header-inner">
+      <a class="wordmark" href="./" aria-label="Ferese home"><svg viewBox="0 0 24 24" aria-hidden="true">
+          <path d="M3 3h6v18H3zM11 3h10v6H11zM11 11h7v6h-7z" />
+        </svg>ferese</a>
+      <nav aria-label="Main navigation">
+        <a href="./" aria-current="page">Overview</a><a href="docs/screenshots.html">Screenshots</a><a
+          href="docs/">Documentation</a><a href="https://github.com/ferese-wm/ferese">GitHub <svg class="link-arrow"
+            viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"
+            stroke-linejoin="round" aria-hidden="true" focusable="false">
+            <path d="M7 17 17 7M7 7h10v10" />
+          </svg></a>
+      </nav>
+    </div>
+  </header>
+  <main id="main" class="simple-home">
+    <section class="product-intro page-width">
+      <h1 class="product-tagline">
+        A Wayland desktop built around personalization.
+      </h1>
+      <p class="product-description">
+        Ferese is a window manager and desktop shell
+        built together and configured in one place,
+        for people who want their desktop to be their own.
+      </p>
+      <div class="product-links">
+        <a class="button" href="docs/installation.html">Install Ferese</a>
+        <a class="button secondary" href="docs/">Documentation</a>
+        <a class="source-link" href="https://github.com/ferese-wm/ferese">Source code <svg class="link-arrow"
+            viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"
+            stroke-linejoin="round" aria-hidden="true" focusable="false">
+            <path d="M7 17 17 7M7 7h10v10" />
+          </svg></a>
       </div>
-    </header>
-    <main id="main" class="simple-home">
-      <section class="product-intro page-width">
-        <h1 class="product-tagline">
-          A Wayland desktop with scrolling layouts and a shared theme.
-        </h1>
-        <p class="product-description">
-          A Linux desktop with a top bar, Settings,
-          scrolling and tiling layouts, and themes that update live.
-        </p>
-        <div class="product-links">
-          <a class="button" href="docs/installation.html">Install Ferese</a>
-          <a class="button secondary" href="docs/">Documentation</a>
-          <a class="source-link" href="https://github.com/ferese-wm/ferese"
-            >Source code <svg class="link-arrow" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M7 17 17 7M7 7h10v10"/></svg></a
-          >
-        </div>
-      </section>
-      <figure class="product-screenshot page-width">
-        <a
-          href="assets/screenshots/ferese-main-hero.png"
-          aria-label="View the full-resolution Ferese desktop screenshot"
-        >
-          <img
-            src="assets/screenshots/ferese-main-hero.png"
-            width="2880"
-            height="1800"
-            alt="Ferese Blue desktop with Settings, Control Center and the default wallpaper"
-            fetchpriority="high"
-          />
-        </a>
-        <figcaption>
-          Ferese Blue with Settings, Control Center, and the default wallpaper.
-        </figcaption>
-      </figure>
-      <section class="product-features page-width" aria-label="Features">
-        <article>
-          <h2>Flexible layouts</h2>
-          <p>
-            Scrolling columns, tree tiling, floating windows, and a workspace
-            overview. Use keyboard shortcuts or gestures to move around.
-          </p>
-          <a href="docs/configuration.html#layout">Configure layouts →</a>
-        </article>
-        <article>
-          <h2>A native desktop</h2>
-          <p>
-            A menu bar, Control Center, Settings, notifications, and desktop
-            widgets, designed to work together.
-          </p>
-          <a href="docs/why-ferese.html">Explore Ferese →</a>
-        </article>
-        <article>
-          <h2>Make it yours</h2>
-          <p>
-            Choose your theme, wallpaper, colors, and motion. Change settings
-            through the app or a KDL config, with live reload.
-          </p>
-          <a href="docs/configuration.html#appearance">Customize Ferese →</a>
-        </article>
-      </section>
-      <section class="product-getting-started page-width">
-        <h2>Getting started</h2>
+    </section>
+    <figure class="product-screenshot page-width">
+      <a href="assets/screenshots/ferese-main-hero.png" aria-label="View the full-resolution Ferese desktop screenshot">
+        <img src="assets/screenshots/ferese-main-hero.png" width="2880" height="1800"
+          alt="Ferese Blue desktop with Settings, Control Center and the default wallpaper" fetchpriority="high" />
+      </a>
+      <figcaption>
+        Ferese Blue with Settings, Control Center, and the default wallpaper.
+      </figcaption>
+    </figure>
+    <section class="product-features page-width" aria-label="Features">
+      <article>
+        <h2>Flexible layouts</h2>
         <p>
-          The <a href="docs/installation.html">installation guide</a> covers
-          dependencies, login, updates, and recovery. You can also
-          <a href="docs/installation.html#preview-and-logs">preview Ferese</a>
-          inside an existing Wayland session before installing.
+          Scrolling columns, tree tiling, floating windows, and a workspace
+          overview. Use keyboard shortcuts or gestures to move around.
         </p>
+        <a href="docs/configuration.html#layout">Configure layouts →</a>
+      </article>
+      <article>
+        <h2>A native desktop</h2>
         <p>
-          Share a display with recording and conferencing apps through Ferese’s
-          native screen-sharing portal. Choose what to share and stop at any time.
-          See <a href="docs/screen-sharing.html">screen sharing and recording</a>
-          for setup and limits.
+          A menu bar, Control Center, Settings, notifications, and desktop
+          widgets, designed to work together.
         </p>
+        <a href="docs/why-ferese.html">Explore Ferese →</a>
+      </article>
+      <article>
+        <h2>Make it yours</h2>
         <p>
-          Find <a href="docs/shortcuts.html">shortcuts and mouse actions</a> in the handbook. Development happens
-          <a href="https://github.com/ferese-wm/ferese">on GitHub</a>.
+          Choose your theme, wallpaper, colors, and motion. Change settings
+          through the app or a KDL config, with live reload.
         </p>
-      </section>
-    </main>
-    <footer class="site-footer page-width">
-      <a class="wordmark" href="./">ferese</a>
-      <p>A Wayland desktop with scrolling layouts.</p>
-      <a href="docs/">Read the handbook <svg class="link-arrow" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M7 17 17 7M7 7h10v10"/></svg></a>
-    </footer>
-  </body>
-</html>
+        <a href="docs/configuration.html#appearance">Customize Ferese →</a>
+      </article>
+    </section>
+    <section class="product-getting-started page-width">
+      <h2>Getting started</h2>
+      <p>
+        The <a href="docs/installation.html">installation guide</a> covers
+        dependencies, login, updates, and recovery. You can also
+        <a href="docs/installation.html#preview-and-logs">preview Ferese</a>
+        inside an existing Wayland session before installing.
+      </p>
+      <p>
+        Share a display with recording and conferencing apps through Ferese’s
+        native screen-sharing portal. Choose what to share and stop at any time.
+        See <a href="docs/screen-sharing.html">screen sharing and recording</a>
+        for setup and limits.
+      </p>
+      <p>
+        Find <a href="docs/shortcuts.html">shortcuts and mouse actions</a> in the handbook. Development happens
+        <a href="https://github.com/ferese-wm/ferese">on GitHub</a>.
+      </p>
+    </section>
+  </main>
+  <footer class="site-footer page-width">
+    <a class="wordmark" href="./">ferese</a>
+    <p>A Wayland desktop with scrolling layouts.</p>
+    <a href="docs/">Read the handbook <svg class="link-arrow" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+        stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">
+        <path d="M7 17 17 7M7 7h10v10" />
+      </svg></a>
+  </footer>
+</body>
+
+</html>
\ No newline at end of file