One of the examples seems relatively easy to grasp if you're a web developer, about how to do HTTP forwarding: https://github.com/aperturerobotics/bifrost/blob/master/exam...
Where do you draw the line? At one point, you have to accept that some projects require deep and context-specific knowledge. I can't be expected to be handheld if I dive deep into some math libraries without knowing the prerequisites. And if I do anyway, it's up to me to figure out at least the basics on my own.
The README has the examples and explanations you're looking for, they're just using the language common in the peer-to-peer ecosystem, as it's a peer-to-peer library/cli/daemon.
Like my ideal readme is:
- 1 screenshot, even if it's a CLI app or web server or something
- 2 sentence elevator pitch
- pip install / cargo install line
- Command line examples