Skip to content

docs: fix outdated compatibility matrix and stale references#279

Merged
kacy merged 1 commit intomainfrom
docs/update-outdated-compatibility-and-references
Feb 25, 2026
Merged

docs: fix outdated compatibility matrix and stale references#279
kacy merged 1 commit intomainfrom
docs/update-outdated-compatibility-and-references

Conversation

@kacy
Copy link
Copy Markdown
Owner

@kacy kacy commented Feb 25, 2026

summary

  • compatibility.md: rewrote the full command compatibility matrix against the actual Command enum. 30+ commands added in phase 8 were still marked as (unsupported) when they're fully implemented — lists (LINDEX, LSET, LTRIM, LINSERT, LREM, LPOS), sets (SUNION, SINTER, SDIFF, SRANDMEMBER, SPOP, SMISMEMBER, SSCAN, and all *STORE variants), sorted sets (ZINCRBY, ZREVRANK, ZREVRANGE, ZRANGEBYSCORE, ZREVRANGEBYSCORE, ZCOUNT, ZPOPMIN, ZPOPMAX, ZSCAN), key lifecycle (COPY, TOUCH, RANDOMKEY, SORT, OBJECT), server (TIME, LASTSAVE, ROLE, MONITOR, CONFIG REWRITE, CLIENT ID/SETNAME/GETNAME/LIST), and transactions (WATCH, UNWATCH). also added a missing ACL section and removed the stale multi/exec entry from "commands out of scope."
  • README.md: updated feature bullet lists to include phase 8 commands across strings, lists, sorted sets, sets, and key commands.
  • ARCHITECTURE.md: updated command count from 114 to 135+.
  • migration-from-redis.md: fixed prometheus metric names (ember_commands_duration_seconds not ember_command_duration_seconds, ember_connections_active not ember_connected_clients).
  • CONTRIBUTING.md: removed stale "(wip)" from cluster module description.

what was tested

  • verified every command status change against the Command enum in crates/ember-protocol/src/command/mod.rs
  • verified prometheus metric names against crates/ember-server/src/metrics.rs

design considerations

compatibility.md was the worst offender — it actively undersells the project by telling users that 30+ implemented commands don't exist. this is the single most impactful doc fix for adoption since it's what people check when evaluating a Redis alternative.

compatibility.md was severely out of date — 30+ commands added in
phase 8 were still marked as unsupported (lists, sets, sorted sets,
key lifecycle, server/client, transactions). rewrote the full matrix
against the actual Command enum. also added an ACL section that was
missing entirely.

other fixes:
- README: update feature lists with phase 8 commands (GETRANGE,
  SETRANGE, LINDEX, LSET, LTRIM, LINSERT, LREM, LPOS, ZINCRBY,
  ZREVRANK, ZREVRANGE, ZRANGEBYSCORE, ZCOUNT, ZPOPMIN, ZPOPMAX,
  SUNION, SINTER, SDIFF, SRANDMEMBER, SPOP, COPY, TOUCH, etc.)
- ARCHITECTURE.md: update command count from 114 to 135+
- migration-from-redis.md: fix prometheus metric names
  (ember_commands_duration_seconds, ember_connections_active)
- CONTRIBUTING.md: remove stale "(wip)" from cluster description
@kacy kacy merged commit 1adf6ed into main Feb 25, 2026
6 of 7 checks passed
@kacy kacy deleted the docs/update-outdated-compatibility-and-references branch February 25, 2026 01:14
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