docs: add deep-dive cross-links and trim duplication

This commit is contained in:
Abhimanyu Saharan
2026-02-11 06:30:08 +00:00
parent a394ba4a48
commit 73d2966332
7 changed files with 33 additions and 20 deletions

View File

@@ -1,5 +1,9 @@
# Development # Development
## Deep dives
- [Testing guide](testing/README.md)
This is the contributor-focused dev workflow for the Mission Control repo. This is the contributor-focused dev workflow for the Mission Control repo.
## Prereqs ## Prereqs

View File

@@ -1,5 +1,10 @@
# Architecture # Architecture
## Deep dives
- [Architecture deep dive](architecture/README.md)
- [Gateway protocol](openclaw_gateway_ws.md)
Mission Control is the **web UI + HTTP API** for operating OpenClaw. Its where you manage boards, tasks, agents, approvals, and (optionally) gateway connections. Mission Control is the **web UI + HTTP API** for operating OpenClaw. Its where you manage boards, tasks, agents, approvals, and (optionally) gateway connections.
> Auth note: **Clerk is required for now** (current product direction). The codebase includes gating so CI/local can run with placeholders, but real deployments should configure Clerk. > Auth note: **Clerk is required for now** (current product direction). The codebase includes gating so CI/local can run with placeholders, but real deployments should configure Clerk.
@@ -49,11 +54,3 @@ Automation/agents can use the “agent API surface”:
- Auth via `X-Agent-Token`. - Auth via `X-Agent-Token`.
See: `backend/app/api/agent.py`, `backend/app/core/agent_auth.py`. See: `backend/app/api/agent.py`, `backend/app/core/agent_auth.py`.
## Links to deeper docs
- Existing deep-dive: `docs/architecture/README.md`
- Deployment: [docs/deployment/README.md](deployment/README.md)
- Production notes: [docs/production/README.md](production/README.md)
- Gateway protocol: [docs/openclaw_gateway_ws.md](openclaw_gateway_ws.md)

View File

@@ -1,5 +1,9 @@
# API reference (first pass) # API reference (first pass)
## Deep dives
- [Gateway WebSocket protocol (API-ish)](openclaw_gateway_ws.md)
This is a **map** of the Mission Control HTTP API surface. Its intentionally light-weight for the first pass. This is a **map** of the Mission Control HTTP API surface. Its intentionally light-weight for the first pass.
## Base ## Base

View File

@@ -1,5 +1,10 @@
# Agents & skills # Agents & skills
## Deep dives
- [Gateway protocol](openclaw_gateway_ws.md)
- [Gateway base config](openclaw_gateway_base_config.md)
This page explains the automation model as it appears in Mission Control. This page explains the automation model as it appears in Mission Control.
## Agent lifecycle (conceptual) ## Agent lifecycle (conceptual)
@@ -19,9 +24,5 @@ This page explains the automation model as it appears in Mission Control.
- required binaries/services - required binaries/services
- command patterns - command patterns
## Where this connects in the repo
- Gateway protocol: [docs/openclaw_gateway_ws.md](openclaw_gateway_ws.md)
- Gateway base config: [docs/openclaw_gateway_base_config.md](openclaw_gateway_base_config.md)
## Next ## Next
- Add repo-specific guidance for authoring skills and where they live (once standardized). - Add repo-specific guidance for authoring skills and where they live (once standardized).

View File

@@ -1,11 +1,12 @@
# Ops / runbooks # Ops / runbooks
This page is the operator/SRE entry point. It intentionally links to existing deeper docs to minimize churn. ## Deep dives
## Where to start - [Deployment](deployment/README.md)
- Deployment: [docs/deployment/README.md](deployment/README.md) - [Production](production/README.md)
- Production checklist/notes: [docs/production/README.md](production/README.md) - [Troubleshooting](troubleshooting/README.md)
- Troubleshooting: [docs/troubleshooting/README.md](troubleshooting/README.md)
This page is the operator/SRE entry point. It intentionally links to existing deeper docs to minimize churn.
## “First 30 minutes” incident checklist ## “First 30 minutes” incident checklist
@@ -34,4 +35,3 @@ This page is the operator/SRE entry point. It intentionally links to existing de
## Backups / restore (placeholder) ## Backups / restore (placeholder)
- Define backup cadence and restore steps once production deployment is finalized. - Define backup cadence and restore steps once production deployment is finalized.

View File

@@ -1,8 +1,10 @@
# Troubleshooting # Troubleshooting
This is the high-level troubleshooting entry point (minimal churn). ## Deep dives
- Deep-dive troubleshooting: [docs/troubleshooting/README.md](troubleshooting/README.md) - [Troubleshooting deep dive](troubleshooting/README.md)
This is the high-level troubleshooting entry point (minimal churn).
## Quick triage ## Quick triage

View File

@@ -1,5 +1,10 @@
# Contributing # Contributing
## Deep dives
- [Coverage policy](coverage-policy.md)
- [Testing guide](testing/README.md)
## How to contribute (first pass) ## How to contribute (first pass)
- Follow the repos existing PR and review conventions. - Follow the repos existing PR and review conventions.
- Prefer small PRs. - Prefer small PRs.