Skip to content

docs: index all docs and add a Tutorials section#310

Merged
cyfyifanchen merged 1 commit into
mainfrom
docs/index-add-missing-entries
Jun 25, 2026
Merged

docs: index all docs and add a Tutorials section#310
cyfyifanchen merged 1 commit into
mainfrom
docs/index-add-missing-entries

Conversation

@dani1005

Copy link
Copy Markdown
Collaborator

What

docs/index.md only linked 12 of the 19 docs under docs/. Anyone entering the documentation through the index page silently missed 7 files — including core usage docs like configuration and multimodal.

This PR makes the index complete and adds the missing Diátaxis quadrant.

Changes

Section Added
Tutorials (new — Diátaxis 4th quadrant, was absent) everos-demo.md, use-cases.md
Reference configuration.md, multimodal.md
How-to locomo_benchmark.md, migration-to-1.0.0.md
See also release-notes-1.1.0.md

After this change, every docs/*.md (excluding the generated openapi.json artifact and index.md itself) is linked from the index.

Notes / judgment calls for reviewers

  • use-cases.md is a product showcase rather than a strict guided tutorial; placed under Tutorials as the least-bad fit (learning/exploration oriented). Move to See also if you prefer.
  • multimodal.md straddles Reference/How-to; filed under Reference since it documents modalities + payload formats.
  • Categorization is easy to shuffle — happy to adjust.

Scope

Docs only. No code, no API, no test changes.

🤖 Generated with Claude Code

index.md only linked 12 of the 19 docs under docs/. Readers entering
from the index missed configuration, multimodal, demo, use-cases,
benchmark, migration, and release notes.

- Add a Tutorials section (Diátaxis 4th quadrant): everos-demo, use-cases
- Reference: + configuration, + multimodal
- How-to: + locomo_benchmark, + migration-to-1.0.0
- See also: + release-notes-1.1.0

Every docs/*.md (excluding the openapi.json artifact) is now linked.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@dani1005 dani1005 changed the title 📝 docs: index all docs — add Tutorials section + missing entries docs: index all docs and add a Tutorials section Jun 24, 2026
@dani1005 dani1005 force-pushed the docs/index-add-missing-entries branch from 3be37a7 to 5381ddd Compare June 24, 2026 21:07
@dani1005 dani1005 requested a review from cyfyifanchen June 24, 2026 21:09
@cyfyifanchen cyfyifanchen merged commit e14e9a5 into main Jun 25, 2026
7 checks passed
@cyfyifanchen cyfyifanchen deleted the docs/index-add-missing-entries branch June 25, 2026 00:01
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.

2 participants