Simplify documentation and website; expand shortcut guides

docs/README.md

@@ -0,0 +1,29 @@
+# Documentation
+
+## Get started
+
+- [Installation](installation.md): dependencies, login, previews, updates, and recovery.
+- [Configuration](configuration.md): KDL syntax, layouts, input, shortcuts, and displays.
+- [Why Ferese](why-ferese.md): layouts and the shared desktop theme.
+
+## Use the desktop
+
+- [Shortcuts and gestures](shortcuts.md): keyboard navigation, Super-drag, resize, and window grouping.
+
+- [Desktop widgets](desktop-widgets.md): clocks and sticky notes.
+- [Notifications](notifications.md): popups, history, and Do Not Disturb.
+- [Lock screen](locking.md): appearance, automatic locking, and display sleep.
+- [Screen sharing and recording](screen-sharing.md): choosing sources and stopping a session.
+- [Desktop portals](portals.md): application integration and supported services.
+
+## Develop Ferese
+
+- [Development](development.md): builds, tests, and portal checks.
+- [Compositor architecture](ferese-window-manager-spec.md).
+- [Shell behavior](ferese-shell-design.md).
+- [Theme components](ferese-theme-ui-spec.md).
+- [Animation checks](animation-validation.md).
+- [Nested resize checks](nested-resize-testing.md).
+- [Client soak testing](native-soak-testing.md).
+- [Performance measurements](performance-baseline.md).
+- [Website development](../site/README.md).