Browse Source

Added a few dummies, clipped README and added to Contribute

Nathan Schneider 5 years ago
parent
commit
7386aff637

+ 6 - 26
README.md

@@ -1,32 +1,12 @@
 # Democratic Mediums
 
-*Patterns for decision, deliberation, and noise*
+**Patterns for decision, deliberation, and noise**
 
-A project of the [Media Enterprise Design Lab](http://cmci.colorado.edu/medlab/)
-at the University of Colorado Boulder.
+*A project of the [Media Enterprise Design Lab](http://cmci.colorado.edu/medlab/)
+at the University of Colorado Boulder.*
 
-Live demo: [medlabboulder.gitlab.io/democraticmediums](https://medlabboulder.gitlab.io/democraticmediums/)
+Democratic Mediums is a work in progress. View the live demo at [medlabboulder.gitlab.io/democraticmediums](https://medlabboulder.gitlab.io/democraticmediums/).
 
-## Contributing
+## Contribute
 
-Democratic Mediums is a participatory project that depends on community contributions. Please share your expertise by helping to make this resource more useful for others.
-
-To contribute, you can fork [the project on GitLab](https://gitlab.com/medlabboulder/democraticmediums) and submit a merge request once you have made your changes. The website is built with [MkDocs](https://www.mkdocs.org/), a simple but powerful static site generator for Markdown files.
-
-All site content is located in the [docs/ directory](https://gitlab.com/medlabboulder/democraticmediums/tree/master/docs), which in turn is organized roughly as it appears on the site itself.
-
-**The easiest way to contribute** is to use the website's integration with the GitLab online editor:
-
-* Navigate to the page you want to edit on the Democratic Mediums website and click the edit button (a small pencil icon)
-* Sign into GitLab with an existing account or create a new one
-* GitLab will offer to create a "fork" for you, which is a copy of the site in your GitLab account—do so!
-* Edit the page as you wish; to edit multiple pages, it may be easier to use GitLab's "Web IDE"
-* Add a "commit message" summarizing your suggested change and click "Commit changes"
-* Fill out any additional information you want in the merge request form and submit it
-* Your merge will be approved, if appropriate, as soon as possible
-
-Please let us know if you have any questions at [medlab@colorado.edu](mailto:medlab@colorado.edu). If you prefer not to use GitLab for contributions, you can also simply email suggestions there.
-
-## To do
-
-* Load initial Mediums pages
+Visit the [Contribute page](https://medlabboulder.gitlab.io/democraticmediums/about/contribute/) for information about how to help build Democratic Mediums.

+ 10 - 5
docs/about/contribute.md

@@ -2,11 +2,9 @@
 
 Democratic Mediums is a participatory effort that depends on community contributions. Please share your expertise by helping to make this resource more useful for others.
 
-To contribute, you can fork [the project on GitLab](https://gitlab.com/medlabboulder/democraticmediums) and submit a merge request once you have made your changes. The website is built with [MkDocs](https://www.mkdocs.org/), a simple but powerful static site generator for Markdown files.
+## How to use the platform
 
-All site content is located in the [docs/ directory](https://gitlab.com/medlabboulder/democraticmediums/tree/master/docs), which in turn is organized roughly as it appears on the site itself.
-
-**The easiest way to contribute** is to use the website's integration with the GitLab online editor:
+To add or edit content, fork [the project on GitLab](https://gitlab.com/medlabboulder/democraticmediums) and submit a merge request once you have made your changes. Follow these instructions to take advantage of the website's integration with the GitLab online editor:
 
 * Navigate to the page you want to edit on the Democratic Mediums website and click the edit button (a small pencil icon)
 * Sign into GitLab with an existing account or create a new one
@@ -16,4 +14,11 @@ All site content is located in the [docs/ directory](https://gitlab.com/medlabbo
 * Fill out any additional information you want in the merge request form and submit it
 * Your merge will be approved, if appropriate, as soon as possible
 
-Please let us know if you have any questions at [medlab@colorado.edu](mailto:medlab@colorado.edu). If you prefer not to use GitLab for contributions, you can also simply email suggestions there.
+The website is built with [MkDocs](https://www.mkdocs.org/), a simple but powerful static site generator for Markdown files. All site content is located in the [docs/ directory](https://gitlab.com/medlabboulder/democraticmediums/tree/master/docs), which in turn is organized roughly as it appears on the site itself.
+
+Please send any questions to [medlab@colorado.edu](mailto:medlab@colorado.edu). If you prefer not to use GitLab, you can also simply email your suggestions there.
+
+## Standards for inclusion
+
+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.
+

+ 27 - 0
docs/mediums/platform.md

@@ -0,0 +1,27 @@
+# Platform
+
+SUMMARY
+
+<!--
+As in, party platforms, clarifying what a party stands for
+
+See also solidarity
+-->
+
+## History
+
+## Feedback loops
+
+### Sensitivities
+
+### Oversights
+
+## Implementations
+
+### Communities
+
+### Tools
+
+## Bibliography
+
+## Further reading

+ 24 - 0
docs/mediums/proportional_representation.md

@@ -0,0 +1,24 @@
+# Proportional representation
+
+SUMMARY
+
+<!--
+-->
+
+## History
+
+## Feedback loops
+
+### Sensitivities
+
+### Oversights
+
+## Implementations
+
+### Communities
+
+### Tools
+
+## Bibliography
+
+## Further reading

+ 24 - 0
docs/mediums/solidarity.md

@@ -0,0 +1,24 @@
+# Solidarity
+
+<!--
+* Workers organizations
+* Party whips, enforcing party discipline
+-->
+
+## History
+
+## Feedback loops
+
+### Sensitivities
+
+### Oversights
+
+## Implementations
+
+### Communities
+
+### Tools
+
+## Bibliography
+
+## Further reading