docs(manual)

Author: xero

README.md

@@ -1,6 +1,6 @@
 # teXt.0w.nz
 
-**Your browser is the canvas**. Draw, edit, and collaborate on ANSI, ASCII, NFO, and XBIN art in a retro text art editor rebooted for the modern web. Offline-first with auto-save/restore and local storage, plus optional real-time sessions. Crafted for keyboard-centric artists and creators using mouse or touch, _on any device_. Built with modern tools and automated testing for a seamless experience.
+**Your browser is the canvas**. Draw, edit, and collaborate on ANSI, ASCII, NFO, and XBIN art in a retro text art editor rebooted for the modern web. Offline-first with auto-save/restore and local storage, plus optional real-time sessions. Crafted for keyboard-centric artists and creators using mouse or touch, _on any device_. Built with modern tools and automated testing for a seamless experience for text artists and developers.
 
 ![preview](https://raw.githubusercontent.com/wiki/xero/text0wnz/img/preview.png)
 
@@ -101,6 +101,7 @@
 - [Architecture](docs/architecture.md) - System architecture and design overview
 - [PWA Install](docs/install-pwa.md) - Guide to installing the app on multiple platforms
 - [Privacy Policy](docs/privacy.md) - Privacy and data handling policy
+- [Security Policy](docs/security.md) - Vulnerability reporting & threat modeling
 
 **Development Guides**
 
@@ -143,7 +144,7 @@
 ## Key Bindings & Mouse/Touch Controls
 
 > [!NOTE]
-> See: [docs/manual.md](docs/manual.md) for more info.
+> See: [docs/manual.md](docs/manual.md#key-bindings-summary) for more info.
 
 ### Main Shortcuts
 
@@ -456,7 +457,7 @@ All tests run automatically in [CI/CD](https://github.com/xero/text0wnz/tree/mai
 - Port in use: Change server port or stop other process
 - SSL fails: Check cert/key files and permissions
 - Client can't connect: Check server, proxy, firewall settings
-- WebSocket drops: Validate nginx headers, trailing slash in proxy_pass
+- WebSocket drops: Validate webserver headers, note trailing slash in proxy_pass
 - Session not saving: Check write permissions, save interval
 - Permissions: Confirm systemd user access
 - Wrong port: Sync client/server configs

docs/README.md

@@ -1,24 +1,26 @@
 # teXt0wnz Documentation
 
+![preview](https://raw.githubusercontent.com/wiki/xero/text0wnz/img/preview.png)
+
 This directory contains comprehensive guides for using, developing, testing, and deploying the **teXt0wnz** editor.
 
 ## Quick Links
 
 ### For Users / Artists
 
-- Start here: "[The Manual](manual.md)"
+- Start here: **[The Editor Manual](manual.md)**
 - [PWA Install](install-pwa.md): Installation guide for multiple platforms
 - [Fonts](fonts.md) - Complete font reference and previews
 
 ### For Developers
 
-- Start here: [Building and Developing](building-and-developing.md)
+- Start here: **[Building and Developing](building-and-developing.md)**
 - Testing: [Testing Guide](testing.md)
 - Code quality: [Building and Developing - Linting and Formatting](building-and-developing.md#linting-and-formatting)
 
 ### For System Administrators
 
-- Start here: [Webserver Configuration](webserver-configuration.md)
+- Start here: **[Webserver Configuration](webserver-configuration.md)**
 - Collaboration server: [Collaboration Server](collaboration-server.md)
 - Containerization: [Docker Containerization](docker.md)
 - Monitoring: [Other Tools - Monitoring Tools](other-tools.md#monitoring-tools)
@@ -27,7 +29,7 @@ This directory contains comprehensive guides for using, developing, testing, and
 
 ### Application Guides
 
-- **[The Manual](manual.md)** - Visual guide to the Frontend text art editor
+- **[Client Editor Manual](manual.md)** - Visual guide to the Frontend text art editor
   - Drawing tools and features
   - Keyboard shortcuts and mouse controls
   - Color management and palettes

docs/manual.md

@@ -1,57 +1,48 @@
-# teXt0wnz Manual
+# teXt0wnz Editor Manual
 
 ## Table of Contents
 
 - [Visual Reference](#visual-reference)
 - [Top Bar](#top-bar)
-  - [Editor Menus](#editor-menus)
+  - [Editor Menus](#-editor-menus)
     - [File Menu](#file-menu)
     - [Edit Menu](#edit-menu)
     - [Sauce Editor](#sauce-editor)
-  - [Status Display](#status-display)
+  - [Status Display](#-status-display)
   - [Canvas Resolution / Size](#canvas-resolution--size)
 - [Color Management](#color-management)
   - [Current Colors](#current-colors)
   - [Color Palette](#color-palette)
 - [Toolbar & Drawing Tools](#toolbar--drawing-tools)
-  - [Keyboard Mode](#keyboard-mode)
+  - [Keyboard Mode](#-keyboard-mode)
     - [Screen-Aware Navigation](#screen-aware-navigation)
-  - [Brushes](#brushes)
+  - [Brushes](#-brushes)
     - [Block / Freehand Brush](#block--freehand-brush)
     - [Shading Brush](#shading-brush)
     - [Character Brush](#character-brush)
     - [Colorize/Attribute Brush](#colorizeattribute-brush)
-  - [Fill Tool](#fill-tool)
-  - [Shapes](#shapes)
+  - [Fill Tool](#-fill-tool)
+  - [Shapes](#-shapes)
     - [Line Tool](#line-tool)
     - [Square/Circle Tool](#squarecircle-tool)
-  - [Selection Tool](#selection-tool)
-  - [Sample Tool](#sample-tool)
-  - [Mirror Mode](#mirror-mode)
-  - [History](#history)
-  - [Fonts](#fonts)
+  - [Selection Tool](#-selection-tool)
+  - [Sample Tool](#-sample-tool)
+  - [Mirror Mode](#-mirror-mode)
+  - [History](#-history)
+  - [Fonts](#-fonts)
     - [Font Select](#font-select)
     - [iCE Colors](#ice-colors)
     - [9pt Font](#9pt-font)
       - [Font Examples](#font-examples)
-  - [Viewport Options](#viewport-options)
+  - [Viewport Options](#-viewport-options)
     - [Zoom](#zoom)
-    - [Light/Dark Mode](#lightdark-mode)
-    - [Grid Overlay](#grid-overlay)
+    - [Light/Dark Mode](#-lightdark-mode)
+    - [Grid Overlay](#-grid-overlay)
 - [Collaboration Features](#collaboration-features)
   - [Chat Window](#chat-window)
     - [Features](#features)
     - [Usage](#usage)
 - [Key Bindings Summary](#key-bindings-summary)
-  - [Main Tool Shortcuts](#main-tool-shortcuts)
-  - [Color & Character](#color--character)
-  - [File & Canvas](#file--canvas)
-  - [Navigation (Keyboard Mode)](#navigation-keyboard-mode)
-  - [Advanced Editing (`alt` + key)](#advanced-editing-alt--key)
-  - [Selection Operations](#selection-operations)
-  - [Selection Navigation](#selection-navigation)
-  - [Function Keys (`F1`–`F12`)](#function-keys-f1f12)
-  - [Mouse Controls](#mouse-controls)
 - [Tips & Workflow](#tips--workflow)
   - [How to draw?](#how-to-draw)
 
@@ -167,7 +158,7 @@ The color system uses the classic 16-color ANSI palette with optional iCE colors
 - iCE colors (extended 16 background colors)
 - Custom palettes in XBIN format
 
-> See [xb-format.md](xb-format.md) for information on custom palettes and [architecture.md](architecture.md) for technical color handling details.
+> See [xb-format.md](xb-format.md) for information on custom palettes
 
 # Toolbar & Drawing Tools
 
@@ -603,8 +594,6 @@ The chat window is available when connected to a collaboration server. It provid
 
 > See [collaboration-server.md](collaboration-server.md) for details on setting up and using the collaboration server.
 
----
-
 # Key Bindings Summary
 
 **Main Tool Shortcuts:**
@@ -707,8 +696,6 @@ The chat window is available when connected to a collaboration server. It provid
 - **alt click:** Sample colors (any tool)
 - **right click:** Context menu
 
----
-
 # Tips & Workflow
 
 1. Start with Keyboard Mode for layout and text