[DO NOT MERGE] Democracy Earth Documentation (#124)

* Adding in documentation for democracy earth

Signed-off-by: Mary Anthony <mary@blockstack.com>

* Updating with the review comments

Signed-off-by: Mary Anthony <mary@blockstack.com>

_data/navigation_learn.yml

@@ -27,6 +27,7 @@
   docs:
   - develop/mining_intro
   - develop/mining_enroll
+  - develop/vote-blockstack
   - develop/appMiningFAQ
 
 

_develop/vote-blockstack.md

@@ -0,0 +1,168 @@
+---
+layout: learn
+permalink: /:collection/:path.html
+---
+# Use the Democracy Earth voting process
+{:.no_toc}
+
+Democracy Earth developed the `vote.blockstack.org` site for voting on applications in the App Mining program. The votes cast through Democracy Earth are consumed by App Mining's ranking algorithm and so affect the final ranking of applications each month.
+
+Democracy Earth is a platform for borderless peer-to-peer democracy. Every aspect of `vote.blockstack.org` is thoughtfully designed with an understanding that governance is about enabling rich exchanges of information. The goal is to surface the optimal collective intelligence of a network.
+
+* TOC
+{:toc}
+
+## Understand the voting process
+
+Two categories of people participate in the voting process. Application miners who have submitted their application for mining are one category. The other people in the process are Stacks token holders who have asked Blockstack for voting privileges. Stacks token holders vote applications up or down; miners respond to questions about their applications.
+
+{% include important.html content="Blockstack may ask token holders to become voters or token holders may request an invitation to vote. If you are a token holder and would like to become a voter, email  <a href='mailto:mining@app.co' target='\_blank'>mining@app.co</a> for more information. Of course, token holders that are also application miners are not eligible to vote." %}
+
+### The value of a vote
+
+App Mining rewards are distributed every month at the end of the month. When
+they accept the voter responsibility, Stacks token holders receive 1000 lifetime
+votes. Voters can distribute some or all of their votes by voting either up or
+down on one or more applications. Of course, if none of the applications are up
+to a voters standards, the voter can abstain from voting entirely.
+
+Votes are a valuable resource. They ultimately help shape the future of blockchain development by directing financial support to innovative development efforts. As a voter, you are expected to try out each application and evaluate it just as an angel investor would do.
+
+### How app miners participate
+
+Choosing how to allocate votes for a monthly payout of 100k is not a trivial task. Questioning and constructive feedback are enormously insightful input for app miners. Each app has a **Debate** section where voters and app miners can interact directly with each other.
+
+<img src="images/de-debate.png" alt="">
+
+App miners are encouraged to introduce themselves, explain their goals, and share more about their work. Voters are encouraged to inquire and provide feedback as much as possible. Remember, everyone's joint goal is to build an application ecosystem where all users control their data.
+
+
+### When voting occurs
+
+New applications are added to Democracy Earth at the start of every month. All new apps added to Democracy Earth are highlighted with a **New** badge so voters can easily spot them.
+
+<img src="images/de-new.png" alt="">
+
+Apps from a previous month remain eligible for voting. This means the pool of applications expands each month. The reason for this is that applications are evolving products, they evolve the quality or expand their features. A product you thought wasn't so good could make a giant leap forward from one month to the next.  
+
+All applications appear in a randomized order so all can receive equal attention from voters.
+
+Every month, all voters receive a newsletter with updates related to App Mining's vote. The newsletter contains additional timing-related reminders. If you are a voter make sure you add <a href='mailto:appmining@democracy.earth' target='\_blank'>appmining@democracy.earth</a> to your contacts list. This prevents the newsletter from going to your Spam folder.
+
+Use the platform to talk (debate) to application miners and to vote on applications. At the 15th of ever month, votes are tabulated.
+
+
+### About vote tabulation
+
+Once a vote is cast, the vote goes onto the ledger for that app. It stays on the application until you remove it by reallocating the vote.  At the end of every monthly cycle, each application has a certain amount of upvotes and downvotes.
+
+Blockstack uses votes to calculate a _likability score_ and a _traction score_ for each app. For example, an app with 90 up- and 10 down-votes has a likability score of 80. A traction score ranks how many total votes (including downvotes) an app received, relative to other apps. Both scores are inputs into <a href="mining_intro.html" target="\_blank">the ranking algorithm used by App Mining</a>.
+
+
+## Create a voter or app miner profile on Democracy Earth
+
+If you are a voter or an application miner, you create a profile on Democracy Earth's `vote.blockstack.org` site. Participation on the site is controlled by the email in your Democracy Earth profile; so the email you use matters.
+
+Democracy Earth supports authentication with a Blockstack identity. When you authenticate into the site, it builds a profile using the email associated with your Blockstack ID. Your profile needs to use a specific email.
+
+* If you are an application miner, this email must be the one you provided when submitting your application to App Mining.
+* If you are a Stacks token holder, this email must should be the same email you use when communicating with Blockstack about your tokens.
+
+If for some reason you can't recall the proper email or the email that appears in your profile does not match the email required to vote, don't worry. You can change that email later after you create a profile.
+
+To create a voter profile, do the following:
+
+1. Visit the <a href="https://vote.blockstack.org/" target="\_blank">https://vote.blockstack.org/</a> site.
+2. Display the login drop down.
+
+    <img src="images/de-authenticate.png" alt="">
+
+3. Agree to the App Mining Voting Terms.
+4. Select the **Blockstack ID** button.
+
+   The system prompts you for a blockstack identity. You may be already signed into the Blockstack Browser with an identity; you can use this one or another. If you do not have a Blockstack identity, you should choose to **Create new ID**, <a href="https://docs.blockstack.org/browser/ids-introduction.html" target="\_blank">creating an identity can take time</a>. After creating an identity, return to this procedure.
+
+5. Authenticate with a Blockstack ID.
+
+   After you authenticate, the browser displays the `vote.blockstack.org` with your newly created profile.
+
+   <img src="images/de-profile.png" alt="">
+
+   When you authenticate, Democracy Earth sends a validation email to the email address associated with your Blockstack ID.
+
+6. Go to your mailbox.
+7. Locate the email that was sent to you.
+
+   <img src="images/de-verification.png" alt="">
+
+8. Click the link provided in the email.
+
+   The yellow verification message is no longer visible on your Democracy Earth profile.
+
+9. Decide whether your profile should use a pseudonym.
+
+   As an application miner, you want to represent your application to voters and so, you should not use a pseudonym. You use your profile to interact with voters. You'll answer questions or maybe defend your choices to votes.
+
+   If you are a voter, you may want to use a pseudonym. You can create this by
+   how you complete your profile. Provide a pseudonym and a username not
+   generally associated with your public identity. By default, Democracy Earth
+   initiates the profile with the username portion of your ID, but you can
+   change it afterward at any time.
+
+10. Edit the **FIRST NAME**, **SURNAME**, and **USERNAME FIELDS** in your profile.
+
+11. Press **Save Profile**.
+
+    At this point, you should see your completed profile.
+
+    <img src="images/de-votes.png" alt="">
+
+    If you are a voter, your profile appears with the number of votes you have to cast.
+
+    {% include important.html content="If you see that you have NONE instead of a number in the votes section, check and make sure the email in the profile is correct as described in these instructions. If your email is correct, and you still do not have any votes available, email <a href='mailto:appmining@democracy.earth' target='\_blank'>appmining@democracy.earth</a> for help." %}
+
+You are all done setting up your profile. In the future, make sure that if you log out of Democracy Earth that you always log back in with the Blockstack ID you used to set up your profile.
+
+
+## How to vote
+
+1. Log into the <a href="https://vote.blockstack.org/" target="\_blank">https://vote.blockstack.org/</a> site.
+2. Locate an app to vote on.
+
+    <img src="images/de-application.png" alt="">    
+
+    Applications that are new appear with a **New** badge.
+
+3. Select **Vote**.
+4. Decide how you want to vote.
+
+   **Yes** upvotes an application meaning you think is adding value to the future of blockchain ecosystems. **No** downvotes an application that you don't think is adding value. Remember you don't have to choose either, you can merely Debate if you like.
+
+5. Click **Yes** or **No**.
+
+   The intensity bar appears.
+
+6. Slide the bar appropriately for the number of votes you want to apply.
+
+   <img src="images/de-slider.png" alt="">    
+
+7. Confirm your vote.
+
+   Your confirmed vote is timestamped and remains on the registered ledger of the application. When you remove your vote, the removal is also recorded on the ledger.
+
+## Help improve voting and the App Mining process
+
+The Democracy Earth Foundation and Blockstack teams are working daily to make `vote.blockstack.org` a powerful tool of the Blockstack ecosystem. For that to
+happen your honest and constructive feedback is welcomed. New features are
+being added every month through the active collaboration between all the
+different stakeholders. Here are the channels that we utilize:
+
+* [Blockstack's forum](https://forum.blockstack.org/)
+
+* [Blockstack's Slack](https://slofile.com/slack/blockstack) for application miners with questions.
+
+* [Democracy Earth's feedback form](https://democracyearth.typeform.com/to/PQIjeL)
+
+If you have any questions or need help utilizing the platform, you can also
+reach out directly to <a href='mailto:appmining@democracy.earth'
+target='\_blank'>appmining@democracy.earth</a>.