Skip to content

docs: update README - #860

Merged
andyne13 merged 1 commit into
developfrom
docs/reposition-readme
Aug 26, 2026
Merged

docs: update README#860
andyne13 merged 1 commit into
developfrom
docs/reposition-readme

Conversation

@andyne13

@andyne13 andyne13 commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

Updated README file.

Summary by CodeRabbit

  • Documentation
    • Updated the README and documentation homepage to position OpenRag as a production-grade, configurable, and sovereign RAG framework.
    • Added context that OpenRag powers Twake.ai.
    • Reworked project goals to emphasize production deployment, interchangeable components, verifiable citations, and open development.

The README and documentation homepage described OpenRag as a framework
"to explore and test advanced RAG techniques", "designed for
experimentation". That is the first thing an evaluator reads, and it
frames everything after it — while the project ships role-based access
control, single sign-on, a Kubernetes chart, database migrations, rate
limiting and two consecutive security-hardening releases.

Header and intro now lead with production and sovereignty. Modularity
is kept, but reframed as tuning a pipeline to a corpus rather than as a
laboratory activity.

Also in the intro:

- drop "lightweight", which undersells a Ray, Milvus and PostgreSQL
  stack and is not accurate
- replace "focused on experimentation, not lock-in", which opposes two
  unrelated things, with "no black boxes, no lock-in"
- fix "Built by the Linagora"

The Goals section is updated to match. A production-first header above
research-first goals would only move the contradiction down the page;
the community goal stays, it simply stops being the primary purpose.

The table-of-contents anchor follows the new heading. The old wording
survives in tests/resources/test_file.txt, which is frozen sample input
for text-extraction tests rather than a mirror of the README.
@coderabbitai

coderabbitai Bot commented Aug 26, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: a6123c7d-6c55-4806-8f1e-866f04f78efb

📥 Commits

Reviewing files that changed from the base of the PR and between 17f6100 and 05688a3.

📒 Files selected for processing (2)
  • README.md
  • docs/content/docs/index.mdx

Included review availability: Your plan provides up to 2 included reviews per hour; 1 remains after this review.


📝 Walkthrough

Walkthrough

The README and documentation landing page now present OpenRag as a sovereign, open-source, production-grade RAG framework. The content describes configurable, self-hosted components, verifiable citations, open development, and OpenRag’s role in Twake.ai.

Changes

Documentation positioning

Layer / File(s) Summary
Production-oriented project positioning
README.md, docs/content/docs/index.mdx
Updated titles and introductions to describe OpenRag as a sovereign, production-grade RAG framework. The README now lists production goals and notes that OpenRag powers Twake.ai.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Merge Risk: ⚪ Minimal · up to 05688

This PR only updates documentation, and no actionable merge-blocking risk remains beyond normal checks and review.

Suggested reviewers: ahmath-gadji

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title identifies the README update, which is part of the changes. It does not describe the broader repositioning of OpenRag as a production-grade, sovereign RAG framework or the documentation page…
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Full details: Title check

Explanation

The title identifies the README update, which is part of the changes. It does not describe the broader repositioning of OpenRag as a production-grade, sovereign RAG framework or the documentation page update.

Full details: Docstring Coverage

Explanation

No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0 files. (2 skipped: 2 unsupported.)

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/reposition-readme

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@andyne13
andyne13 merged commit 427be03 into develop Aug 26, 2026
6 checks passed
@andyne13
andyne13 deleted the docs/reposition-readme branch August 26, 2026 12:20
@Ahmath-Gadji Ahmath-Gadji added the documentation Improvements or additions to documentation label Sep 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants