# Raydo Book Full Context

Raydo Book is the official operating manual for installing, using, and understanding Raydo Desktop.

Primary domain: https://book.raydo.ai

Repository: https://github.com/RaydoAI/raydo-book

## Positioning

Raydo Book should document:

- how users install, update, and troubleshoot Raydo Desktop;
- how users operate Raydo through Chat, Projects, App Connections, previews, and deliverables;
- how users understand privacy, permissions, local-first behavior, diagnostics, and recovery;
- how contributors improve user-facing documentation through focused pull requests;
- how release behavior changes over time.
- how developers use Raydo's intentionally public plugin SDK, scaffolder, package, installation, and lifecycle contracts.

Raydo Book should not be positioned as a secondary development manual or a guide for unsupported customization.

## Information architecture

English documentation lives under `/docs`.

Chinese documentation lives under `/zh/docs`.

Start here:
The shortest path into Raydo Desktop.

Installation:
macOS, Windows, updates, portable builds, and setup troubleshooting.

User Guide:
Chat, projects, app connections, previews, deliverables, and daily workflows.

Developer Guide:
The supported Plugin Developer Preview, including project scaffolding, validation, deterministic packaging, archive distribution, local installation, review, App Connections, grants, enablement, capability discovery, and Marketplace boundaries.

How-to Guides:
Step-by-step guides for common Raydo tasks.

Privacy & Safety:
Local-first behavior, permissions, provider boundaries, side effects, and diagnostics.

Concepts:
Product concepts explained for users, not internal architecture or secondary development.

Release Notes:
Product and documentation changes that readers should know about.

Contributing:
Documentation improvements, issue reports, and translation fixes within the public docs boundary.

## Maintenance model

Every substantive page should include frontmatter:

```yaml
owner: docs
status: draft
lastVerified: 2026-07-13
sourceLocale: en
```

Status values:

- draft
- stable
- needs-review

English and Chinese pages should stay aligned for shared product behavior. Installation and user-operation pages are the priority; developer content is limited to contracts Raydo intentionally publishes and supports.