Agreed. It’s a living brainstorm of ideas for people to dive into, expand, branch, and do whatever with. It highlights a core narrative, but does so in chunks so that people can dive in or build on top of it. It’s meant to be a living ongoing conversation.
Docs are very very different than the spotlight/narrative idea. While docs would be great for SourceCred, docs aren’t as fun/engaging to write. Also, traditionally, documentation work has been paid less and been less appreciated than general discussions, design, or development. Having contributed to documentation for several projects, I’m hesitant to continue in that direction due to the reasons listed above.
If we were, however, sketching out and designing the incentive/token models of SourceCred and then needed to formalize that into a spec, I would be intrigued…