docs: align §1 thesis sentence + README with the pillar-#2 reframe - #204
Conversation
Resolves RFC 0012 §7's open question (maintainer-directed). The §1 thesis sentence (CLAUDE.md) and README's parallel both list "collapses … the compression layer …"; add a one-clause clarification to each that the compression collapsed is Parquet's byte codec plus the miner's *logical* reduction (query pruning), not on-disk bytes that beat a codec. The load-bearing thesis sentence itself is unchanged; only the clarifying clause is added. CLAUDE.md footer changelog extended to note §1; RFC 0012 §7 open-question marked resolved. Within RFC 0012's approved meta scope. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
Warning Review limit reached
More reviews will be available in 24 minutes and 35 seconds. Learn how PR review limits work. Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file). ⌛ How to resolve this issue?After more reviews become available, a review can be triggered using the We recommend that you space out your commits to avoid hitting the rate limit. 🚦 How do rate limits work?CodeRabbit enforces hourly rate limits for each developer per organization. Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available. Please see our Fair Usage Limits Policy for further information. ℹ️ Review info⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Pro Plus Run ID: 📒 Files selected for processing (3)
✨ Finishing Touches🧪 Generate unit tests (beta)
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. Comment |
There was a problem hiding this comment.
Pull request overview
This PR clarifies the meaning of “compression” in the project’s thesis sentences so readers don’t misinterpret template mining as a byte-level compressor; it aligns CLAUDE.md §1 and README.md with the pillar-#2 reframing documented in RFC 0012.
Changes:
- Add a one-clause clarification in
README.md’s thesis paragraph that “compression” refers to Parquet’s byte codec plus the miner’s logical reduction (query pruning), not better-than-codec byte savings. - Add the parallel clarification to
CLAUDE.md§1 and update the footer changelog entry to reflect both §2 and §1 updates. - Mark RFC 0012 §7’s open question about updating the §1 thesis sentence as resolved, documenting the enactment.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| README.md | Adds an explicit parenthetical clarifying “compression” in the thesis sentence to avoid bytes-vs-codec misreadings. |
| CLAUDE.md | Adds the same clarification to §1’s thesis sentence and updates the 2026-06-14 footer entry to mention §1. |
| docs/rfcs/0012-claude-md-pillar-2-wording.md | Updates §7 to mark the §1-thesis parallel touch as resolved and records the rationale. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
What
Resolves RFC 0012 §7's open question (maintainer-directed): aligns CLAUDE.md §1's thesis sentence and README's parallel with the pillar-#2 reframe.
Why
Both thesis sentences read "collapses … the compression layer … into one stack." That's accurate as architecture, but per RFC 0012 §7 it can be misread as template-mining-is-the-byte-compressor. A one-clause clarification removes the ambiguity without touching the load-bearing sentence.
Changes
Scope / verification
Within RFC 0012's approved meta scope (§7 explicitly: "in scope for the same enactment" at the maintainer's discretion). The framing-phrase grep (
before any byte-level codec/over a competent byte codec) still returns only RFC 0011 + RFC 0012 — the new clauses use "bytes that beat a codec", not the framing phrases.mdbook buildclean.🤖 Generated with Claude Code