Skip to content

docs: add Context7 documentation indexing#575

Open
g-dumas wants to merge 6 commits into
hnaderi:mainfrom
beyond-scale-group:context7-indexing
Open

docs: add Context7 documentation indexing#575
g-dumas wants to merge 6 commits into
hnaderi:mainfrom
beyond-scale-group:context7-indexing

Conversation

@g-dumas
Copy link
Copy Markdown

@g-dumas g-dumas commented Mar 31, 2026

Summary

  • Adds context7.json configuration file to give maintainers explicit control over Context7 indexing
  • Edomata is already indexed at https://context7.com/hnaderi/edomata (17 pages, 148 snippets, trust score 8.4/10)
  • The config specifies which folders to index (docs/, core source, backend source, examples) and which to exclude (build artifacts)

Fixes #573

Test plan

  • Verify context7.json is valid JSON
  • Confirm indexing continues to work after merge

🤖 Generated with Claude Code

Guillaume DUMAS and others added 6 commits January 29, 2026 14:30
* Add CLAUDE.md with project guidance

Provides development setup, build commands, project structure, and module documentation for working with the Edomata codebase.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

* Enrich tutorials for non-expert developers

Add beginner-friendly explanations throughout all 5 tutorials:

- 0_getting_started: Problem statement, architecture diagram, aggregate
  and pure function explanations, Edomaton vs Stomaton decision guide
- 1-1_eventsourcing: Event sourcing intro, Decision analogy, Scala
  syntax notes, ValidatedNec and fold explanations, testing benefits
- 1-2_cqrs: CQRS intro, state diagrams, EitherNec vs Decision
  comparison, Stomaton vs Edomaton decision matrix
- 2_backends: Backend concept, program/interpreter pattern, persistence
  tables explained, outbox and idempotency, minimal setup example
- 3_processes: Process intro, outbox pattern diagram, stream
  explanation, process manager and saga patterns with examples

Each technical term now includes real-world analogies and practical
context for developers unfamiliar with Scala, event sourcing, DDD,
or CQRS concepts.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Convert ASCII diagrams to Mermaid in tutorials

Replace ASCII art diagrams with Mermaid for better rendering:

- 0_getting_started: Layer architecture flowchart
- 1-2_cqrs: Traditional vs CQRS comparison, order state diagram
- 2_backends: Pure/backend architecture, database ER diagram
- 3_processes: System architecture, outbox sequence diagram, saga flow

Mermaid diagrams render properly in GitHub, documentation sites,
and most modern markdown viewers.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

---------

Co-authored-by: GitHub Actions Bot <actions@github.com>
Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>
Adds fork-aware ticket workflow instructions so Claude Code
automatically detects fork vs root repo and targets PRs accordingly.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
docs: add contribution workflow to CLAUDE.md
Adds context7.json so Edomata can be indexed on Context7, enabling
AI coding assistants (Claude Code, Cursor, Copilot) to look up
Edomata documentation directly.

Fixes hnaderi#573

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@g-dumas
Copy link
Copy Markdown
Author

g-dumas commented Mar 31, 2026

How to submit Edomata to Context7 after merge

  1. Go to https://context7.com/add-library?tab=github
  2. Paste the repository URL: https://github.com/hnaderi/edomata
  3. Context7 will automatically discover the context7.json config and index the specified folders (docs/, core source, backend source, examples)
  4. Wait a few minutes for indexing to complete
  5. Verify by searching for "edomata" on https://context7.com — it should appear in results

Once indexed, AI coding assistants using Context7 (Claude Code, Cursor, Copilot, Windsurf) will be able to pull up Edomata documentation directly when developers ask for help.

@g-dumas
Copy link
Copy Markdown
Author

g-dumas commented Mar 31, 2026

Update: Edomata is actually already indexed on Context7 at https://context7.com/hnaderi/edomata (17 pages, 148 snippets, trust score 8.4/10).

This PR still adds a context7.json config file which gives maintainers control over which folders are indexed and excluded, but the core request in #573 is already fulfilled.

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.

docs: add Context7 documentation indexing for AI-assisted development

2 participants