Skip to content

Reframe README.md around U2U/U2I/I2I generalization#363

Open
em3s wants to merge 2 commits into
mainfrom
docs/readme-u2u-u2i-i2i-framing
Open

Reframe README.md around U2U/U2I/I2I generalization#363
em3s wants to merge 2 commits into
mainfrom
docs/readme-u2u-u2i-i2i-framing

Conversation

@em3s
Copy link
Copy Markdown
Contributor

@em3s em3s commented May 30, 2026

Summary

Reframes the README around the generalized interaction database angle. The main framing moves from listing use-cases (likes / views / follows) to the three axes that fall out of the same abstraction: User–User (U2U), User–Item (U2I), and Item–Item (I2I).

The underlying model — source → action → target — is unchanged. Only the lens shifts: likes and follows are no longer the headline, but one slice (U2I) of a more general shape.

This framing came out of conversations with @zipdoki and @eazyhozy on a walk.

Other adjustments along the way:

  • How It Works now lists the supported operations (GET, COUNT, SCAN/SEEK, AGG) and notes that multi-hop traversals are expressed by composing them.
  • Surfaces planned operations (Global TopK, Per-entity TopK).
  • When (Not) to Use ItWhen to Use It, matching common English OSS README conventions.

Changes

  • Reframe README.md around the U2U / U2I / I2I axes
  • Update the tagline from One database for likes, views, and follows to One database for U2U, U2I, and I2I interactions
  • Refresh the supported-operations list to GET / COUNT / SCAN (SEEK) / AGG, and add TopK under Planned
  • State the production timeline as since 2024 instead of for years

How to Test

Visual review via the GitHub README preview. No changes to external links (actionbase.io, blog, issue, stories) or to their targets.

AI Assistance

  • This PR was written largely with AI assistance.
    • Tool / model: Claude Code (Opus 4.7 1M)

Repo About suggestion (out of PR scope; needs a maintainer to update via the GitHub UI):

One database for U2U (follows), U2I (likes), and I2I (related items) interactions — precomputed, served in real-time

@dosubot dosubot Bot added size:M This PR changes 30-99 lines, ignoring generated files. documentation Improvements or additions to documentation labels May 30, 2026
@em3s em3s changed the title docs(readme): reframe around U2U/U2I/I2I generalization Reframe around U2U/U2I/I2I generalization May 30, 2026
@em3s em3s changed the title Reframe around U2U/U2I/I2I generalization Reframe README.md around U2U/U2I/I2I generalization May 30, 2026
@em3s em3s force-pushed the docs/readme-u2u-u2i-i2i-framing branch 2 times, most recently from 13ebfab to b723e22 Compare May 30, 2026 15:02
Move the main framing from listing use-cases (likes/views/follows) to
the three axes that fall out of the same source -> action -> target
model: User-User (U2U), User-Item (U2I), and Item-Item (I2I). The
underlying model is unchanged; only the lens shifts.

- Update tagline to "One database for U2U, U2I, and I2I interactions"
- Add a Why Actionbase section that introduces the three axes
- Refresh the supported-operations list (GET, COUNT, SCAN/SEEK, AGG)
  and note multi-hop traversals are expressed by composing them
- Surface planned operations (Global TopK, Per-entity TopK)
- Rename "When (Not) to Use It" to "When to Use It"
- State production timeline as "since 2024" instead of "for years"

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@em3s em3s force-pushed the docs/readme-u2u-u2i-i2i-framing branch from b723e22 to f395420 Compare May 30, 2026 15:04
Expand U2U/U2I/I2I abbreviations in the opening tagline so first-time
GitHub visitors understand the scope without scrolling. The abbreviations
are still introduced in the Why Actionbase section below.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
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 size:M This PR changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant