Contributing to the Aragon Network Paper
The Aragon Network will be the first community governed decentralized organization whose goal is to act as a digital jurisdiction. This paper describes the mechanism and economics that constitute the network.
In our opinion, Git provides the perfect set of tools to visualize the work behind writing a paper. Through commits, pull requests and issues one can see who contributed, and in what way and what effect it had on the final version. We anticipate that the document will continue to evolve as we prototype, experiment, and implement the mechanisms described here.
We decided to use this technology to draft The Aragon Network Paper and we encourage others to join in to bring more transparency and collaboration to this process. If you would like to discuss the technical details of specific mechanisms referenced in the paper, but not necessarilly raise a specific issue or propose a change please create a thread in our research forum.
This processes is structured similarly to and inspired by DemocracyEarths's Social Smart Contract Repository
Guidelines for contribution
How to contribute
Using Github Issues
Use issues to:
- make general comments
- raise your concerns
- ask a question
- request more details, explanation
We will do our best to answer as fast as possible all issues created by the community.
If you are not familiar with Github, look up the Github user guide to create an issue
Using Pull requests
Use pull requests to suggest modifications to the paper. Here are a few guidelines for pull request creation:
- Please make your edits following the wiki markup language Markdown Formatting, they will be easier to merge that way.
- 1 pull request per change please.
- Give your pull request a subject/title that describes the edit.
We will do our best to address pull requests created by the community as quickly as possible. If the modification is a "no brainer" for reviewers we will merge it instantly, if not we will engage in a conversation with its creators to understand how best we can make use of his/her suggestions or explain why we are rejecting it.
If you are not familiar with Github look up the Github user guide to create pull requests.