2 files changed, 19 insertions, 0 deletions
diff --git a/docs/wiki/Accessibility.md b/docs/wiki/Accessibility.md
new file mode 100644
index 00000000..225093f3
--- /dev/null
+++ b/docs/wiki/Accessibility.md
@@ -0,0 +1,18 @@
+## Screen readers
+
+Niri has basic support for screen readers (specifically, [Orca](https://orca.gnome.org)).
+We implement the `org.freedesktop.a11y.KeyboardMonitor` D-Bus interface for Orca to listen and grab keyboard keys, and we expose the main niri UI elements via [AccessKit](https://accesskit.dev).
+
+Make sure [Xwayland](./Xwayland.md) works, then run `orca`.
+The default config binds <kbd>Super</kbd><kbd>Alt</kbd><kbd>S</kbd> to toggle Orca, which is the standard key binding.
+
+If you're shipping niri and would like to make it work better for screen readers out of the box, consider the following changes to the default niri config:
+
+- Change the default terminal from Alacritty to one that supports screen readers. For example, [GNOME Console](https://gitlab.gnome.org/GNOME/console) or [GNOME Terminal](https://gitlab.gnome.org/GNOME/gnome-terminal) should work well.
+- Change the default application launcher and screen locker to ones that support screen readers. Suggestions welcome! Likely, something GTK-based will work fine.
+- Add some `spawn-at-startup` command that plays a sound which will indicate to users that niri has finished loading.
+- Add `spawn-at-startup "orca"` to run Orca automatically at niri startup.
+
+## Desktop zoom
+
+There's no built-in zoom yet, but you can use third-party utilities like [wooz](https://github.com/negrel/wooz).
diff --git a/docs/wiki/_Sidebar.md b/docs/wiki/_Sidebar.md
index 4c25efec..5dcddf45 100644
--- a/docs/wiki/_Sidebar.md
+++ b/docs/wiki/_Sidebar.md
@@ -14,6 +14,7 @@
 * [Xwayland](./Xwayland.md)
 * [Gestures](./Gestures.md)
 * [Packaging niri](./Packaging-niri.md)
+* [Accessibility](./Accessibility.md)
 * [FAQ](./FAQ.md)
 
 ## Configuration