docs: rebuild documentation from scratch with clean IA

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Justin Visser 2026-02-27 09:39:27 +01:00
parent 6c31b331f7
commit 0c5b199b76
30 changed files with 1647 additions and 649 deletions

View file

@ -1,8 +1,30 @@
# Operations Documentation
---
title: Operations Overview
sidebar_position: 1
---
Use this section for production operations and incident/runbook workflows.
# Operations Overview
- [Scrape Safety Runbook](./scrape-safety-runbook.md)
- [arXiv Runbook](./arxiv-runbook.md)
- [Database Runbook](./database-runbook.md)
- [Migration Rollout Checklist](./migration-checklist.md)
This section covers production deployment, database administration, and scrape safety operations.
## Quick Links
| Guide | Description |
|-------|-------------|
| [Deployment](deployment.md) | Production Docker setup, scaling, health checks |
| [Database Runbook](database-runbook.md) | Backup, restore, integrity checks, repair procedures |
| [Scrape Safety Runbook](scrape-safety-runbook.md) | Rate limiting, cooldowns, CAPTCHA handling |
| [arXiv Runbook](arxiv-runbook.md) | arXiv rate limits, cache tuning, query patterns |
## Health Check
The app exposes `GET /healthz` for container orchestration:
```bash
curl -fsS http://localhost:8000/healthz
```
Docker Compose healthcheck config:
- Interval: 10s
- Timeout: 5s
- Retries: 12