From 30b7d9ae4a2d36ecbca7a292e52b82120e5e66da Mon Sep 17 00:00:00 2001
From: Alexander Courtis <alex@courtis.org>
Date: Sat, 6 Apr 2024 12:00:06 +1100
Subject: [PATCH] docs: add server side decorations note to faq

---
 README.md                  | 15 +++++++++++++++
 doc/templ/40.man.readme.md | 14 ++++++++++++++
 man/wideriver.1            | 17 +++++++++++++++++
 3 files changed, 46 insertions(+)

diff --git a/README.md b/README.md
index dd74e08..4b41650 100644
--- a/README.md
+++ b/README.md
@@ -44,6 +44,7 @@ Tiling window manager for the [river](https://github.com/riverwm/river) wayland
   * [Wide Shuffling](#wide-shuffling)
 - [FAQ](#faq)
   * [Name Does Not Always Update](#name-does-not-always-update)
+  * [Borders Are Not Shown](#borders-are-not-shown)
 - [ISSUES](#issues)
   * [Problems](#problems)
   * [Ideas](#ideas)
@@ -442,6 +443,20 @@ The layout name will not update when there are no views for the selected tags. T
 
 This may be resolved with a river enhancement: [\#1004](https://github.com/riverwm/river/issues/1002)
 
+### Borders Are Not Shown
+
+Please ensure you have enabled server side decorations i.e. the borders:
+
+``` sh
+riverctl rule-add ssd
+```
+
+You can still use client side decorations for specific applications e.g.:
+
+``` sh
+riverctl rule-add -app-id audacity csd
+```
+
 ## ISSUES
 
 ### Problems
diff --git a/doc/templ/40.man.readme.md b/doc/templ/40.man.readme.md
index 30e9560..1741910 100644
--- a/doc/templ/40.man.readme.md
+++ b/doc/templ/40.man.readme.md
@@ -89,6 +89,20 @@ The layout name will not update when there are no views for the selected tags. T
 
 This may be resolved with a river enhancement: [#1004](https://github.com/riverwm/river/issues/1002)
 
+### Borders Are Not Shown
+
+Please ensure you have enabled server side decorations i.e. the borders:
+
+``` sh
+riverctl rule-add ssd
+```
+
+You can still use client side decorations for specific applications e.g.:
+
+``` sh
+riverctl rule-add -app-id audacity csd
+```
+
 ## ISSUES
 
 ### Problems
diff --git a/man/wideriver.1 b/man/wideriver.1
index 1c8298f..ea990a4 100644
--- a/man/wideriver.1
+++ b/man/wideriver.1
@@ -457,6 +457,23 @@ The layout name will not update when there are no views for the selected tags.
 This can occurs when setting a tag with no views or changing the layout for a tag with no views.
 .PP
 This may be resolved with a river enhancement: #1004 (https://github.com/riverwm/river/issues/1002)
+.SS Borders Are Not Shown
+.PP
+Please ensure you have enabled server side decorations i.e.\ the borders:
+.IP
+.nf
+\f[C]
+riverctl rule-add ssd
+\f[R]
+.fi
+.PP
+You can still use client side decorations for specific applications e.g.:
+.IP
+.nf
+\f[C]
+riverctl rule-add -app-id audacity csd
+\f[R]
+.fi
 .SH ISSUES
 .SS Problems
 .PP