wiki/Accessibility: Expand info from feedback

1 files changed, 10 insertions, 1 deletions

diff --git a/docs/wiki/Accessibility.md b/docs/wiki/Accessibility.md
index 4e6eb7c7..9da301e2 100644
--- a/docs/wiki/Accessibility.md
+++ b/docs/wiki/Accessibility.md
@@ -2,12 +2,21 @@
 
 <sup>Since: next release</sup>
 
-Niri has basic support for screen readers (specifically, [Orca](https://orca.gnome.org)).
+Niri has basic support for screen readers (specifically, [Orca](https://orca.gnome.org)) when running as a full desktop session, i.e. not as a nested window.
 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).
+Specifically, niri will announce:
+
+- workspace switching, for example it'll say "Workspace 2";
+- the exit confirmation dialog (appears on <kbd>Super</kbd><kbd>Shift</kbd><kbd>E</kbd> by default);
+- entering the screenshot UI and the overview (niri will say when these are focused, nothing else for now);
+- whenever a config parse error occurs;
+- the important hotkeys list (for now, as one big announcement without tab navigation; appears on <kbd>Super</kbd><kbd>Shift</kbd><kbd>/</kbd> by default).
 
 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.
 
+Note that we don't have an Alt-Tab window switcher yet (it's in the works), and we also don't have a bind to move focus to layer-shell panels.
+
 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.