After looking through the project, I wonder if the README could show:
- How the main parts connect together?
- When you'd reach for each abstraction?
- Real Ruby/Rails examples of pieces working together?
- Why each pattern exists, not just how to use it?
- Links to source/specs for digging deeper?
Maybe keep it lean and move the heavier stuff to separate docs. The code's pretty clear—just exposing more of that in the docs would help.
After looking through the project, I wonder if the README could show:
Maybe keep it lean and move the heavier stuff to separate docs. The code's pretty clear—just exposing more of that in the docs would help.