I feel like this has good intention, but I think it misses key information that should be in the readme.
Its really great to have a blurb about what the thing does, the big idea behind why it exists, and how it fits into the rest of the universe.
I also really want instructions for how to build the repository. It seems like that is really downplayed in this guide. I feel like that is misaligned with the target audience of those visiting the repository. I would rather sacrifice overview for instructions on how to use the thing.
Its really great to have a blurb about what the thing does, the big idea behind why it exists, and how it fits into the rest of the universe.
I also really want instructions for how to build the repository. It seems like that is really downplayed in this guide. I feel like that is misaligned with the target audience of those visiting the repository. I would rather sacrifice overview for instructions on how to use the thing.