MEDLab/democratic-mediums
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Created several example entries; edited the .template.md; added to the Contribute page

Browse Source
This commit is contained in:
Nathan Schneider
2019-04-09 23:02:05 -06:00
parent 3855b95bb4
commit 101898b6e3
15 changed files with 129 additions and 77 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/about/basics.md
View File

@ -2,7 +2,7 @@
The future of governance is being made in social movements, networked protocols, and unsettled governments around the world. What tools will they have to work with?
# "I love the noise of democracy." — James Buchanan
<div id="pullquote">"I love the noise of democracy" — James Buchanan</div>
**This is a collaborative directory of democratic mediums—patterns for decision, deliberation, and noise.** It brings lessons from political, corporate, and community governance into conversation with the people inventing the next generation of institutions with permissionless networks and radical markets.

29
docs/about/contribute.md
View File

@ -24,7 +24,34 @@ Please send any questions to [medlab@colorado.edu](mailto:medlab@colorado.edu).
The "mediums" included in this directory should aim to capture the most discrete, modular elements of democratic practice. That is, *Westminster system* would not be a good entry because it is a historical phenomenon that combines many elements. Some of those elements, such as *proportional representation* and *parliamentarianism*, however, would be useful to include.
### New entries
To create a new entry, copy the content of the [docs/mediums/.template.md](https://gitlab.com/medlabboulder/democraticmediums/blob/master/docs/mediums/.template.md) file into a new file at docs/mediums/NAME.md. Follow the format of the template, and look to existing entries for examples.
### Markup
Democratic Mediums files are written in [Markdown](https://daringfireball.net/projects/markdown/dingus), a simple markup language that translates to HTML. (When necessary, HTML may be used as well.) For information about how the MkDocs system handles links, metadata, and other content, see [its documentation](https://www.mkdocs.org/user-guide/writing-your-docs/).
### Style
Democratic Mediums is not meant to be exhaustive or encyclopedic. Entries should strive above all for brevity, clarity, and practicality. The model for an entry should be not a Wikipedia article but a technical manual, like [API documentation](https://www.mulesoft.com/resources/api/guidelines-api-documentation).
Democratic Mediums is not meant to be exhaustive or encyclopedic. Entries should strive above all for brevity, clarity, and practicality. The model for an entry should be not a Wikipedia article but a technical manual, like [API documentation](https://www.mulesoft.com/resources/api/guidelines-api-documentation). Concise, grammatical bullet points and examples are more appropriate than lengthy prose discussions. The purpose is not completeness (leave that to sources in the Further Resources section) but usability for governance designers.
Language should be as simple and direct, avoiding specialized terminology wherever possible.
### References
Most citations can be made through links to source material and in-text indications of the source. External sources that are especially useful can be included in the Further Resources section of an entry.
Bibliographic references can be made in the [Chicago Manual of Style bibliography-entry format](https://www.chicagomanualofstyle.org/tools_citationguide/citation-guide-1.html) or a format that similarly enables alphabetization. Include links in bibliographic entries where possible.
## Roadmap
The following are future goals for this project:
* Populate more of the entries in the directory
* Build community and a robust contributor base
* Commission uniform illustrated diagrams for each entry
* Present the mediums as less isolated and more modular, enabling users to assemble them into packages and processes
* Gamification features enabling users to test mediums against one another
To get involved in developing these strategic objectives, please write to [medlab@colorado.edu](mailto:medlab@colorado.edu).