docs: update v0.27.0 release prep

- Fix broken link (config/reference.md → reference/configuration.md)
- Add Website Permissions section to getting-started with WebKitGTK limitation notice
- Add Crash Reporting section to getting-started with CLI commands
- Add Permissions & Session Exit Classification links to main index
- Document installer env vars (DUMBER_VERSION, DUMBER_PRERELEASE)
- Document screen sharing limitation (not working on WebKitGTK 2.50.x, fixed in 2.52+)
- Reference upstream WebKit bug #306440 for screen sharing issue

commit: dcb4c51ef498b4ad6f53d804a688de173d28b74d
author: bnema · 8mo ago · 2026-02-12 20:52 UTC
parent: 041cf3d
signature: GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email
refs: tag: v0.27.0

4 files · +58 -1

M docs/getting-started.md +33 -1


@@ -61,8 +61,40 @@ Use with rofi or fuzzel:
61	61		dumber dmenu \| rofi -dmenu -show-icons \| dumber dmenu --select
62	62		```
63	63
	64	+	## Website Permissions
	65	+
	66	+	Dumber includes a built-in permissions system for camera, microphone, and screen sharing:
	67	+
	68	+	- Custom dialog - Clean permission prompts replace native GTK dialogs
	69	+	- Persistent choices - "Always Allow" and "Always Deny" are saved per-origin
	70	+	- Privacy-focused - All permissions stored locally
	71	+	- Camera & Microphone - Fully working on Wayland/PipeWire
	72	+
	73	+	> ⚠️ Note: Screen sharing does not currently work on Wayland with WebKitGTK 6.0. This is a known WebKitGTK limitation.
	74	+
	75	+	When a website requests camera or microphone access, you'll see a permission dialog with options to allow once, always allow, deny, or always deny.
	76	+
	77	+	See [Website Permissions](./reference/permissions.md) for details.
	78	+
	79	+	## Crash Reporting
	80	+
	81	+	If Dumber exits unexpectedly, crash reports are automatically generated:
	82	+
	83	+	```bash
	84	+	# List all crash reports
	85	+	dumber crashes
	86	+
	87	+	# View the latest crash report
	88	+	dumber crashes show latest
	89	+
	90	+	# Generate GitHub issue payload
	91	+	dumber crashes issue latest
	92	+	```
	93	+
	94	+	See [Session Exit Classification](./reference/session-exit-classification-runbook.md) for troubleshooting.
	95	+
64	96		## Next Steps
65	97
66		-	- [Configuration Reference](./config/reference.md) - All settings
	98	+	- [Configuration Reference](./reference/configuration.md) - All settings
67	99		- [Keybindings](./reference/keybindings.md) - Full keyboard shortcuts
68	100		- [CLI Commands](./cli/index.md) - Command-line tools


@@ -61,8 +61,40 @@ Use with rofi or fuzzel:
61		dumber dmenu \| rofi -dmenu -show-icons \| dumber dmenu --select	61		dumber dmenu \| rofi -dmenu -show-icons \| dumber dmenu --select
62		```	62		```
63			63
			64	+	## Website Permissions
			65	+
			66	+	Dumber includes a built-in permissions system for camera, microphone, and screen sharing:
			67	+
			68	+	- Custom dialog - Clean permission prompts replace native GTK dialogs
			69	+	- Persistent choices - "Always Allow" and "Always Deny" are saved per-origin
			70	+	- Privacy-focused - All permissions stored locally
			71	+	- Camera & Microphone - Fully working on Wayland/PipeWire
			72	+
			73	+	> ⚠️ Note: Screen sharing does not currently work on Wayland with WebKitGTK 6.0. This is a known WebKitGTK limitation.
			74	+
			75	+	When a website requests camera or microphone access, you'll see a permission dialog with options to allow once, always allow, deny, or always deny.
			76	+
			77	+	See [Website Permissions](./reference/permissions.md) for details.
			78	+
			79	+	## Crash Reporting
			80	+
			81	+	If Dumber exits unexpectedly, crash reports are automatically generated:
			82	+
			83	+	```bash
			84	+	# List all crash reports
			85	+	dumber crashes
			86	+
			87	+	# View the latest crash report
			88	+	dumber crashes show latest
			89	+
			90	+	# Generate GitHub issue payload
			91	+	dumber crashes issue latest
			92	+	```
			93	+
			94	+	See [Session Exit Classification](./reference/session-exit-classification-runbook.md) for troubleshooting.
			95	+
64		## Next Steps	96		## Next Steps
65			97
66	-	- [Configuration Reference](./config/reference.md) - All settings	98	+	- [Configuration Reference](./reference/configuration.md) - All settings
67		- [Keybindings](./reference/keybindings.md) - Full keyboard shortcuts	99		- [Keybindings](./reference/keybindings.md) - Full keyboard shortcuts
68		- [CLI Commands](./cli/index.md) - Command-line tools	100		- [CLI Commands](./cli/index.md) - Command-line tools

M docs/index.md +2 -0


@@ -34,6 +34,8 @@ A browser designed for Wayland compositors that works like your favorite termina
34	34		- [Dependencies](./reference/dependencies.md) - System dependencies for Arch and Debian/Ubuntu
35	35		- [Keybindings](./reference/keybindings.md) - Keyboard shortcuts reference
36	36		- [Floating Pane](./reference/floating-pane.md) - Floating pane behavior, shortcuts, and profiles
	37	+	- [Website Permissions](./reference/permissions.md) - Camera, microphone, and screen sharing permissions
	38	+	- [Session Exit Classification](./reference/session-exit-classification-runbook.md) - Understanding crash reports
37	39		- [Troubleshooting](./reference/troubleshooting.md) - Common issues and solutions
38	40
39	41		## Requirements


@@ -34,6 +34,8 @@ A browser designed for Wayland compositors that works like your favorite termina
34	- [Dependencies](./reference/dependencies.md) - System dependencies for Arch and Debian/Ubuntu	34		- [Dependencies](./reference/dependencies.md) - System dependencies for Arch and Debian/Ubuntu
35	- [Keybindings](./reference/keybindings.md) - Keyboard shortcuts reference	35		- [Keybindings](./reference/keybindings.md) - Keyboard shortcuts reference
36	- [Floating Pane](./reference/floating-pane.md) - Floating pane behavior, shortcuts, and profiles	36		- [Floating Pane](./reference/floating-pane.md) - Floating pane behavior, shortcuts, and profiles
		37	+	- [Website Permissions](./reference/permissions.md) - Camera, microphone, and screen sharing permissions
		38	+	- [Session Exit Classification](./reference/session-exit-classification-runbook.md) - Understanding crash reports
37	- [Troubleshooting](./reference/troubleshooting.md) - Common issues and solutions	39		- [Troubleshooting](./reference/troubleshooting.md) - Common issues and solutions
38		40
39	## Requirements	41		## Requirements

M docs/installation.md +20 -0


@@ -8,6 +8,26 @@ curl -fsSL https://dumber.bnema.dev/install \| bash
8	8
9	9		Installs to `~/.local/bin` if available, otherwise `/usr/local/bin` (requires sudo).
10	10
	11	+	### Advanced Installation Options
	12	+
	13	+	Install a specific version:
	14	+
	15	+	```bash
	16	+	DUMBER_VERSION=v0.26.2 curl -fsSL https://dumber.bnema.dev/install \| bash
	17	+	```
	18	+
	19	+	Install the latest prerelease:
	20	+
	21	+	```bash
	22	+	DUMBER_PRERELEASE=1 curl -fsSL https://dumber.bnema.dev/install \| bash
	23	+	```
	24	+
	25	+	Combine both to install a specific prerelease:
	26	+
	27	+	```bash
	28	+	DUMBER_VERSION=v0.27.0-rc.1 DUMBER_PRERELEASE=1 curl -fsSL https://dumber.bnema.dev/install \| bash
	29	+	```
	30	+
11	31		## Flatpak
12	32
13	33		```bash


@@ -8,6 +8,26 @@ curl -fsSL https://dumber.bnema.dev/install \| bash
8		8
9	Installs to `~/.local/bin` if available, otherwise `/usr/local/bin` (requires sudo).	9		Installs to `~/.local/bin` if available, otherwise `/usr/local/bin` (requires sudo).
10		10
		11	+	### Advanced Installation Options
		12	+
		13	+	Install a specific version:
		14	+
		15	+	```bash
		16	+	DUMBER_VERSION=v0.26.2 curl -fsSL https://dumber.bnema.dev/install \| bash
		17	+	```
		18	+
		19	+	Install the latest prerelease:
		20	+
		21	+	```bash
		22	+	DUMBER_PRERELEASE=1 curl -fsSL https://dumber.bnema.dev/install \| bash
		23	+	```
		24	+
		25	+	Combine both to install a specific prerelease:
		26	+
		27	+	```bash
		28	+	DUMBER_VERSION=v0.27.0-rc.1 DUMBER_PRERELEASE=1 curl -fsSL https://dumber.bnema.dev/install \| bash
		29	+	```
		30	+
11	## Flatpak	31		## Flatpak
12		32
13	```bash	33		```bash

M docs/reference/permissions.md +3 -0


@@ -9,6 +9,9 @@ Dumber handles website permission requests for media access (microphone, camera,
9	9		These permissions are automatically granted without user interaction:
10	10
11	11		- Display Capture (screen sharing) - The XDG Desktop Portal handles the UI
	12	+
	13	+	> ⚠️ Known Issue: Screen sharing does not work on Wayland with WebKitGTK 2.50.x due to a GStreamer caps negotiation failure ([WebKit bug #306440](https://bugs.webkit.org/show_bug.cgi?id=306440)). This was fixed on January 29, 2026 and backported to the 2.52 stable branch. Workaround: Upgrade to WebKitGTK 2.52+ when available from your distribution. Camera and microphone permissions work correctly.
	14	+
12	15		- Device Enumeration (listing microphones/cameras) - Low security risk
13	16
14	17		### User-Confirmed


@@ -9,6 +9,9 @@ Dumber handles website permission requests for media access (microphone, camera,
9	These permissions are automatically granted without user interaction:	9		These permissions are automatically granted without user interaction:
10		10
11	- Display Capture (screen sharing) - The XDG Desktop Portal handles the UI	11		- Display Capture (screen sharing) - The XDG Desktop Portal handles the UI
		12	+
		13	+	> ⚠️ Known Issue: Screen sharing does not work on Wayland with WebKitGTK 2.50.x due to a GStreamer caps negotiation failure ([WebKit bug #306440](https://bugs.webkit.org/show_bug.cgi?id=306440)). This was fixed on January 29, 2026 and backported to the 2.52 stable branch. Workaround: Upgrade to WebKitGTK 2.52+ when available from your distribution. Camera and microphone permissions work correctly.
		14	+
12	- Device Enumeration (listing microphones/cameras) - Low security risk	15		- Device Enumeration (listing microphones/cameras) - Low security risk
13		16
14	### User-Confirmed	17		### User-Confirmed