diff --git a/specification/.gitignore b/specification/.gitignore new file mode 100644 index 0000000..ccbfadb --- /dev/null +++ b/specification/.gitignore @@ -0,0 +1 @@ +site/ \ No newline at end of file diff --git a/specification/README.md b/specification/README.md new file mode 100644 index 0000000..b601e2e --- /dev/null +++ b/specification/README.md @@ -0,0 +1,13 @@ +# Setup + + pip install mkdocs + pip install mkdocs-mermaid2 + pip install mkdocs-material + +# Local Development + + mkdocs serve + +# Production Build + + mkdocs build \ No newline at end of file diff --git a/specification/docs/design.md b/specification/docs/design.md new file mode 100644 index 0000000..e69de29 diff --git a/specification/docs/implementation.md b/specification/docs/implementation.md new file mode 100644 index 0000000..e69de29 diff --git a/specification/docs/overview.md b/specification/docs/overview.md new file mode 100644 index 0000000..c4d3871 --- /dev/null +++ b/specification/docs/overview.md @@ -0,0 +1,28 @@ +The purpose of this document is to provide detailed instructions for building a decentralized, autonomous organization (DAO) using the principles and approach described in the paper [On-Chain Governance of Decentralized Autonomous Organizations (Craig Calcaterra, 2018)](https://papers.ssrn.com/sol3/papers.cfm?abstract_id=3188374). + +A [prototype of this system](https://gitea.dgov.io/DGF/dgf-prototype) has been implemented in Solidity and JavaScript. This specification will be derived from that prototype, and generalized in such a way that it can be implemented using an alternative technology stack, such as Casper. + +## Decentralized Autonomous Organization + +### Organization + +- a group of persons organized for some end or work; association + ([dictionary.com](https://www.dictionary.com/browse/organization)) + +In our model, a DAO is comprised of a group of experts who want to be able to present a united front. They will collaborate to define the rules by which the organization is to be governed, and by which customers may engage the expertise of the DAO. + +### Autonomous + +- self-governing; independent; subject to its own laws only. +- having autonomy; not subject to control from outside; independent +- (of a machine, device, etc.) able to operate with little or no human control or intervention + ([dictionary.com](https://www.dictionary.com/browse/autonomous)) + +The rules of the DAO are to be implemented as code, and executed automatically, without the need for human intervention. + +### Decentralized + +- (of currency) not controlled or distributed by a government, bank, or other third party, as bitcoin and some other digital currencies + ([dictionary.com](https://www.dictionary.com/browse/decentralized)) + +The code which implements the rules of the DAO is to be run by multipe parties who each verify one another's results. \ No newline at end of file diff --git a/specification/docs/requirements.md b/specification/docs/requirements.md new file mode 100644 index 0000000..e69de29 diff --git a/specification/docs/stylesheets/extra.css b/specification/docs/stylesheets/extra.css new file mode 100644 index 0000000..ab5dc64 --- /dev/null +++ b/specification/docs/stylesheets/extra.css @@ -0,0 +1,3 @@ +.md-header { + background-color:rgb(36, 88, 43); +} \ No newline at end of file diff --git a/specification/docs/terminology.md b/specification/docs/terminology.md new file mode 100644 index 0000000..e69de29 diff --git a/specification/mkdocs.yml b/specification/mkdocs.yml new file mode 100644 index 0000000..9995d7a --- /dev/null +++ b/specification/mkdocs.yml @@ -0,0 +1,22 @@ +site_name: DGF DAO Specification +site_url: https://spec.dgov.io +theme: + name: material +plugins: + - search + - mermaid2 +extra_css: + - stylesheets/extra.css +markdown_extensions: + - pymdownx.superfences: + # make exceptions to highlighting of code: + custom_fences: + - name: mermaid + class: mermaid + format: !!python/name:mermaid2.fence_mermaid_custom +nav: + - Overview: overview.md + - Terminology: terminology.md + - Requirements: requirements.md + - Design: design.md + - Implementation: implementation.md