Merge remote-tracking branch 'origin/main'

# Conflicts:
#	site/README.md

site/README.md

@@ -18,7 +18,7 @@ site sources or Markdown guides, then refresh the browser.
 
 - `site/index.html` and `site/styles.css`: homepage and shared visual design.
 - `site/content/index.md`: handbook introduction.
-- `docs/{installation,configuration,desktop-widgets,notifications,locking,screen-sharing}.md`:
+- `docs/{why-ferese,installation,configuration,desktop-widgets,notifications,locking,screen-sharing}.md`:
   source guides.
 - `scripts/build-site.py`: renders Markdown, resolves links, generates section
   navigation, previous/next links, and the search index.

site/content/index.md

@@ -4,6 +4,8 @@ Ferese is a complete Wayland desktop built around personalization. Its custom sh
 
 This handbook covers installing Ferese, finding your way around, and making the desktop your own.
 
+[Why Ferese](why-ferese.md) explains why the desktop is designed as one integrated system rather than assembled from separately configured tools.
+
 ## Start with your first session
 
 1. Read [Installation](installation.md) for dependencies, building, login-manager or TTY startup, and recovery.

site/index.html

@@ -93,7 +93,7 @@
             A menu bar, Control Center, Settings, notifications, and desktop
             widgets, designed to work together.
           </p>
-          <a href="docs/">Explore the handbook →</a>
+          <a href="docs/why-ferese.html">Why integration matters →</a>
         </article>
         <article>
           <h2>Make it yours</h2>