Skip to content

DOC-6924 Remove AI-docs differentiator claim from Redis vs MongoDB - #3743

Open
andy-stark-redis wants to merge 1 commit into
mainfrom
DOC-6924-update-redis-vs-mongo-db-documentation
Open

DOC-6924 Remove AI-docs differentiator claim from Redis vs MongoDB#3743
andy-stark-redis wants to merge 1 commit into
mainfrom
DOC-6924-update-redis-vs-mongo-db-documentation

Conversation

@andy-stark-redis

@andy-stark-redis andy-stark-redis commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

Removes the "Documentation optimized for AI parsing" bullet from the Redis vs MongoDB section of the When to choose Redis page, plus the matching "Documentation optimized for AI agents" entry in the Decision matrix (the same claim, and the only other occurrence repo-wide).

Reported by Itay Tevel: the bullet cited structured Markdown, JSON feeds, and llms.txt as reasons to choose Redis over MongoDB, but MongoDB ships all of that — so it isn't a differentiator.

Verification

Checked against MongoDB rather than taking the report on trust:

Claim MongoDB status
llms.txt mongodb.com/docs/llms.txt — a docs-level index that fans out to per-product and per-driver llms.txt files, splits large sets into numbered parts, and instructs agents to prefer .md pages. Second company-level index at mongodb.com/llms.txt.
Structured Markdown Appending .md to any docs URL path returns raw Markdown — confirmed at mongodb.com/docs/manual/introduction.md.
Beyond parity MongoDB Agent Skills — installable skills for MCP setup, connection config, schema design, and query optimization, invocable as /<skill-name> in Claude Code. Ahead of what Redis docs ship.

Only "JSON feeds" is arguably still ours alone, which is too thin to carry a differentiator bullet — hence deletion rather than a reworded version.

Scope

The Redis vs MongoDB section keeps its four genuine differentiators (real-time patterns, in-memory performance, data structures + complex queries, horizontal scalability). The section's closing Example: paragraph never referenced the removed bullet and needed no change; the decision-tree block never asked about documentation. Pinecone and Postgres sections untouched.

Ticket: DOC-6924

🤖 Generated with Claude Code


Note

Low Risk
Documentation-only edits with no product or code impact.

Overview
Removes the “Documentation optimized for AI parsing” bullet from the Redis vs MongoDB section and the matching “Documentation optimized for AI agents” line in the Decision matrix on the When to choose Redis page.

The claim is dropped because MongoDB offers comparable llms.txt, Markdown, and agent-oriented docs, so it was not a valid reason to choose Redis over MongoDB. Pinecone, Postgres, examples, and the decision tree are unchanged.

Reviewed by Cursor Bugbot for commit 53e3f15. Bugbot is set up for automated code reviews on this repo. Configure here.

The "Documentation optimized for AI parsing" bullet on the When to choose
Redis page claimed structured Markdown, JSON feeds, and llms.txt as reasons
to pick Redis over MongoDB. MongoDB ships all of that, so the bullet is no
longer a differentiator. Removed it, plus the matching "Documentation
optimized for AI agents" entry in the decision matrix — the same claim, and
the only other occurrence repo-wide.

Verified against MongoDB rather than taking the report on trust:
- mongodb.com/docs/llms.txt is a real index that fans out to per-product and
  per-driver llms.txt files, splits large sets into numbered parts, and tells
  agents to prefer .md pages; a second company-level index is at
  mongodb.com/llms.txt
- appending .md to any docs URL path returns raw Markdown
  (mongodb.com/docs/manual/introduction.md)
- mongodb.com/docs/agent-skills/ ships installable Agent Skills (MCP setup,
  connection config, schema design, query optimizer), invocable as
  /<skill-name> in Claude Code — ahead of what Redis docs offer

Only "JSON feeds" is arguably still ours alone, which is too thin to carry a
differentiator bullet, hence deletion rather than a reworded version.

Learned: docs-format claims age badly on comparison pages — the industry
shipped llms.txt through 2025-26, so assume a competitor has it. When a
comparison claim goes stale, grep the whole page: this one had drifted into
the decision matrix as well, and fixing only the section the ticket named
would have left the page still recommending Redis for its docs.

Reported-by: Itay Tevel
Verified-by: WebFetch of mongodb.com llms.txt, .md path, and agent-skills
Ticket: DOC-6924

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@github-actions

github-actions Bot commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

@github-actions

github-actions Bot commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

DOC-6924

@github-actions

github-actions Bot commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

🧠 Redis Memory

Found 5 related items from repository history:

Memory updated at 53e3f15

@andy-stark-redis
andy-stark-redis requested a review from a team August 3, 2026 14:19
@andy-stark-redis andy-stark-redis self-assigned this Aug 3, 2026
@andy-stark-redis andy-stark-redis added the bug Something isn't working label Aug 3, 2026
@mich-elle-luna

Copy link
Copy Markdown
Collaborator

I think if you look at a page with a code example in their markdown it won't exist there (no postprocessing is done) and I don't see json feeds for theirs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants