docs: restructure documentation into audience-based portals

BREAKING CHANGE: Documentation URLs have changed

New structure:
- user/ - End-user documentation (device setup, sync guides, frontend)
- developer/ - Developer documentation (API reference, protocols, specs)
- operations/ - Operations documentation (deployment, troubleshooting)
- contributing/ - Contribution guides

Changes:
- Created portal INDEX.md files for each audience section
- Moved device guides to user/devices/ (kobo-setup.md, koreader-setup.md)
- Moved API docs to developer/ (api-reference.md, collections-api.md)
- Moved sync guide to user/sync-guide.md
- Moved troubleshooting to operations/troubleshooting.md
- Moved all split API docs to developer/api/
- Renamed protocol files (kobo-protocol.md, koreader-protocol.md)
- Added placeholder user guides (frontend, user-areas, settings, admin)
- Updated all internal links to new paths
- Updated Go code (http_handler.go, navigation.go) for new paths
- Updated main INDEX.md for audience-based navigation

Benefits:
- Clear separation of user and developer documentation
- Scalable structure for future user guide expansion
- Better organization and discoverability
- Audience-specific landing pages

Related to DOCS_IMPLEMENTATION_PLAN.md Phase 2 completion

docs/developer/api/devices/get_devices.md

@@ -0,0 +1,62 @@
+# Get Device / Check Registration Status
+
+Check device registration status or get device details.
+
+**Endpoint**: `POST /api/devices/auth/status` or `GET /api/devices/{device_id}`
+**Auth**: Not required for status check, Required for device details
+**Content-Type**: `application/json` (for status check)
+
+## Request Body (Status Check)
+
+| Field | Type | Required | Description |
+|--------|------|-----------|-------------|
+| registration_id | string | Yes | Registration UUID |
+
+### Example Request (Status Check)
+
+```json
+{
+  "registration_id": "registration-uuid"
+}
+```
+
+## Response (200 OK)
+
+```json
+{
+  "status": "pending|approved|expired",
+  "auth_token": "device-bearer-token...",
+  "device_id": "uuid",
+  "sync_endpoints": {
+    "progress": "https://bookhoard.com/api/sync/progress",
+    "metadata": "https://bookhoard.com/api/sync/metadata",
+    "annotations": "https://bookhoard.com/api/sync/annotations"
+  }
+}
+```
+
+## Response (200 OK) - Device Details
+
+```json
+{
+  "id": "uuid",
+  "device_name": "My Kobo Clara",
+  "device_type": "kobo",
+  "last_sync": "2026-01-31T10:00:00Z",
+  "last_seen": "2026-01-31T10:05:00Z",
+  "sync_enabled": true,
+  "auto_sync": true,
+  "sync_frequency_minutes": 5
+}
+```
+
+## Error Responses
+
+| Code | Description |
+|------|-------------|
+| 401 | Invalid or expired token (for device details) |
+| 404 | Device or registration not found |
+
+## Try It Out
+
+<!-- API Explorer will be inserted here in Phase 3 -->

docs/developer/api/devices/list_devices.md

@@ -0,0 +1,48 @@
+# List User Devices
+
+Retrieve all devices registered to the current user.
+
+**Endpoint**: `GET /api/devices`
+**Auth**: Required
+
+## Request Headers
+
+| Header | Type | Required | Description |
+|--------|------|-----------|-------------|
+| Authorization | string | Yes | Bearer token |
+
+### Example Request
+
+```http
+GET /api/devices
+Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
+```
+
+## Response (200 OK)
+
+```json
+{
+  "devices": [
+    {
+      "id": "uuid",
+      "device_name": "My Kobo Clara",
+      "device_type": "kobo",
+      "last_sync": "2026-01-31T10:00:00Z",
+      "last_seen": "2026-01-31T10:05:00Z",
+      "sync_enabled": true,
+      "auto_sync": true,
+      "sync_frequency_minutes": 5
+    }
+  ]
+}
+```
+
+## Error Responses
+
+| Code | Description |
+|------|-------------|
+| 401 | Invalid or expired token |
+
+## Try It Out
+
+<!-- API Explorer will be inserted here in Phase 3 -->

docs/developer/api/devices/register_device.md

@@ -0,0 +1,48 @@
+# Register Device
+
+Register a new device for sync.
+
+**Endpoint**: `POST /api/devices/register`
+**Auth**: Not required (device registration flow)
+**Content-Type**: `application/json`
+
+## Request Body
+
+| Field | Type | Required | Description |
+|--------|------|-----------|-------------|
+| device_name | string | Yes | Device name |
+| device_type | string | Yes | Device type: kobo, koreader, web, mobile |
+| device_identifier | string | Yes | Hardware-specific ID |
+
+### Example Request
+
+```json
+{
+  "device_name": "My Kobo Clara",
+  "device_type": "kobo",
+  "device_identifier": "hardware-specific-id"
+}
+```
+
+## Response (201 Created)
+
+```json
+{
+  "device_id": "uuid",
+  "registration_id": "registration-uuid",
+  "auth_url": "https://bookhoard.com/devices/auth/confirm/abc123",
+  "qr_code": "data:image/png;base64,iVBORw0KG...",
+  "expires_in": 300
+}
+```
+
+## Error Responses
+
+| Code | Description |
+|------|-------------|
+| 400 | Invalid device data |
+| 409 | Device already registered |
+
+## Try It Out
+
+<!-- API Explorer will be inserted here in Phase 3 -->

docs/developer/api/devices/revoke_device.md

@@ -0,0 +1,41 @@
+# Revoke Device
+
+Revoke access to a device.
+
+**Endpoint**: `DELETE /api/devices/{device_id}`
+**Auth**: Required
+
+## Path Parameters
+
+| Parameter | Type | Required | Description |
+|-----------|------|-----------|-------------|
+| device_id | string | Yes | Device UUID |
+
+## Request Headers
+
+| Header | Type | Required | Description |
+|--------|------|-----------|-------------|
+| Authorization | string | Yes | Bearer token |
+
+### Example Request
+
+```http
+DELETE /api/devices/uuid
+Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
+```
+
+## Response (204 No Content)
+
+Device revoked successfully.
+
+## Error Responses
+
+| Code | Description |
+|------|-------------|
+| 401 | Invalid or expired token |
+| 403 | User does not own this device |
+| 404 | Device not found |
+
+## Try It Out
+
+<!-- API Explorer will be inserted here in Phase 3 -->