Document screen sharing across the website and handbook

site/README.md

@@ -18,7 +18,8 @@ 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}.md`: source guides.
+- `docs/{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/app.js`: handbook search and code copying. Reading and navigation work

site/content/index.md

@@ -43,6 +43,13 @@ If you prefer a text editor, your configuration lives at:
 
 Ferese reloads changes as you make them. An invalid edit keeps the last working configuration. Settings also preserves a backup of your previous save. See [Saving and validation](configuration.md#saving-and-validation).
 
+## Share your screen
+
+Use Ferese’s native display picker to share a monitor with a portal-compatible
+recording or conferencing app. The app handles saving or sending video; Ferese
+does not yet have a Record button in the shell. See [Screen sharing and
+recording](screen-sharing.md) for setup, stopping a session, and supported sources.
+
 ## Keep a recovery path
 
 Keep another desktop session available while testing hardware behavior. Save your work before logging out: `feresectl exit` and **Super + Shift + E** end the current session immediately.
@@ -59,5 +66,3 @@ cargo fmt --all --check
 ```
 
 The [source repository](https://github.com/ferese-wm/ferese) is the place to explore implementation details and report issues. When reporting a problem, include how to reproduce it, whether you used the nested or DRM backend, and relevant logs.
-
-[Screen sharing](screen-sharing.md) covers display consent, PipeWire streams, and recording support.

site/index.html

@@ -112,6 +112,12 @@
           <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 current capabilities.
+        </p>
         <p>
           Built in Rust on Smithay. Development happens
           <a href="https://github.com/ferese-wm/ferese">on GitHub</a>.