Plasma Group has been working hard on our Generalized Plasma Specification. We’ve recently reached a point where we’ve decided to actively seek review from members of the plasma community (and beyond). We're reaching out because we'd love your review on our spec!
This document goes through an introduction to our specification, our target audience, and some of the key areas we’re looking for feedback on. Hopefully this will give you some useful contextual information before you dive into review.
Just like our specification, this help guide is a living document! Feel free to reach out if you find something confusing or if you’d like to suggest an edit.
Reviewers will be credited in our specification! Thank you so much for your time. ♥
Reviewers should be familiar with plasma, Plasma MVP, and Plasma Cash. Our specification does not provide detailed explanations of any of these constructions. We recommend that reviewers reading through LearnPlasma if they’re not already familiar with these core plasma concepts.
Our specification is highly technical and attempts to use the language described by RFC 2119. You’ll see phrases like “… the client MUST do X …” or “… the operator SHOULD do Y …”. You may find it useful to quickly review RFC 2119 to become familiar with this language.
We’re using an app called Hypothesis to handle review comments. Hypothesis allows you to leave comments on web pages that others can read. You’ll have to create an account and install the Hypothesis chrome extension to get started. If you’re not on a chromium-based browser, you can use a bookmarklet.
Hypothesis allows you to leave annotate sections of a page. Annotations can be made public (everyone can see), private (only you can see), or in a group (group members can see). All you've got to do to start reviewing is to head to the Generalized Plasma Specification and open up the Hypothesis extension!
In an attempt to keep public annotations relatively minimal, we’re asking that reviewers leave comments in the PG Specification Review Hypothesis Group and not in the public channel. Anyone can join this group, but off-topic comments or spam will be hidden.
Make sure to switch groups before you add your comments or you might end up posting in the wrong channel by accident: