Skip to content

docs: Reorganize documentation into guide/, specification/, deployment/#46

Merged
marevol merged 1 commit into
mainfrom
docs/reorganize-documentation
Feb 15, 2026
Merged

docs: Reorganize documentation into guide/, specification/, deployment/#46
marevol merged 1 commit into
mainfrom
docs/reorganize-documentation

Conversation

@marevol

@marevol marevol commented Feb 15, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Reorganize docs from 2 categories (guides/, deployment/) into 3 clear categories with consistent depth and coverage
  • Add 20 new documentation files covering previously undocumented features
  • Update existing docs with simplified language for non-technical users
  • Fix all cross-reference links and update README.md doc index

guide/ — User-facing (11 files, 84 KB)

  • New: getting-started, projects, data-management, tuning, training, deployment-slots, user-management
  • Updated: api-keys, inference, ab-testing, retraining (simplified language, added "when to use" sections)

specification/ — Developer-facing (7 files, 106 KB)

  • New: architecture (from ONE_PAGER.md, updated for 7 services), data-model, api-reference, websocket-protocol, security-design, inference-service, task-system

deployment/ — Operations-facing (8 files, 60 KB)

  • New: management-commands (all 6 Django management commands documented)
  • Moved: standalone-inference from guides/

Root files

  • Updated: README.md (new doc index), CONTRIBUTING.md, CLAUDE.md (path references)
  • Deleted: ONE_PAGER.md (absorbed into specification/architecture.md)

Test plan

  • All internal doc links resolve correctly (no broken guides/, inference-api.md, or ONE_PAGER references)
  • docs/guides/ directory no longer exists
  • ONE_PAGER.md no longer exists at root
  • README.md doc index lists all 26 docs with correct paths
  • Each guide/ doc is readable without ML/Docker background knowledge

🤖 Generated with Claude Code

Restructure docs from 2 categories (guides/, deployment/) into 3 clear
categories with consistent depth and coverage:

- guide/ (11 files): User-facing tutorials for ML beginners
  - New: getting-started, projects, data-management, tuning, training,
    deployment-slots, user-management
  - Updated: api-keys, inference, ab-testing, retraining (simplified language)

- specification/ (7 files): Developer-facing technical reference
  - New: architecture, data-model, api-reference, websocket-protocol,
    security-design, inference-service, task-system

- deployment/ (8 files): Operations-facing procedural docs
  - New: management-commands
  - Moved: standalone-inference from guides/

Also: delete ONE_PAGER.md (absorbed into specification/architecture.md),
update README.md doc index, fix all cross-reference links.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@marevol marevol merged commit a33ef09 into main Feb 15, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant