I’d like to create a document that is a Beginner’s Guide to Initiaives. This guide would use clear, concise language to explain what an Initiative is, how it’s used in SC, and how to create one.
It would also become one of multiple guides within the Getting Started Category.
Having a Beginner’s Guide to Initiatives would enable and empower beginners to get involved with the community, understand the larger values of the project by knowing how to explore existing Initiatives, and to create their own meaningful contributions right away by contributing to initiatives or creating their own.
This would also create a canonical understanding of what an initiative is and how it’s best used for the entire community at large. As well as a definitive place to look when the definition or procedure around an Initiative changes.
Implementation Plan
Have a conversation with someone who fully understands the topic of initiatives to learn from and solidify MY understanding as a newb. (Completed)
Use that understanding to create a rough draft of a guide. (Completed)
Have knowledgeable folks review/edit the guide draft for accuracy and legibility to multiple audiences.
Make revisions as necessary, and repeat review/editing process until an accurate final guide has been forged.
Publish a finished Beginner’s Guide to Initiatives to the Getting Started Category.
Deliverables
This Initiative will create a ”Beginner’s Guide to Initiatives” that is accurate, concise, and easy for the layperson to understand. As well as a touchstone definition of initiatives for the whole community.
Dependencies
The Initiatives Artifact existing makes it possible to write a guide for that Artifact.
Yeah, from my conversation with @decentralion it sounded like those categories could be better defined or simplified in general. I figured that nailing those concepts down could be part of this process of creating the guide.
Yeah totally! That’s why I wanted to try to organize all the data about various mechanisms in one place so that we could start to understand what’s going on and sketch out the basic mechanics of everything. The code for Initiatives is actually right here, but it’s a WIP as @Beanow is still working on Write the Initiatives Plugin.
@decentralion and @Beanow would be the best people to reach out to regarding what Initiatives are and how they work. If you guys happen to chat about Initiatives (or really any other Sourcecred protocol stuff) please announce it in the #chat-announce channel. I really really want to deeply understand how the protocol/game works, so happy to jump into any protocol related discussions even if it’s just to listen
I totally get that, though I imagine these guides will be something that continue to get updated as we figure things out. I think there’s a lot of value to getting something out there that is mostly accurate and can be changed as our understanding changes.
(And of course, we’ll definitely keep everyone updated on future chats, you are obviously a champion when it comes to wrangling all this info into an orderly state.)
Oh yeah 100%. Design, development, and documentation is all happening in parallel. Also, everything in the Getting Started category is a wiki so that it can be updated. That’s one of the best things about playing the SourceCred game for collaboration because all the contributions are synergistic and result in positive-sum Cred creation
