From 4760760d6b74a5268b053ea0aff077f0a67a2732 Mon Sep 17 00:00:00 2001 From: Moxiegirl Date: Thu, 6 Dec 2018 11:04:51 -0800 Subject: [PATCH] Setting up FAQs for app mining (#47) Signed-off-by: Mary Anthony --- _config.yml | 1 + _data/appFAQ.json | 221 +++++++++++++++++++++++++++++++++++++ _data/navigation_learn.yml | 2 +- _develop/appMiningFAQ.md | 14 +++ _develop/faq-data.json | 4 + _org/wallet-install.md | 103 +++++++++++++++++ 6 files changed, 344 insertions(+), 1 deletion(-) create mode 100644 _data/appFAQ.json create mode 100644 _develop/appMiningFAQ.md create mode 100644 _develop/faq-data.json create mode 100644 _org/wallet-install.md diff --git a/_config.yml b/_config.yml index 9cd5b7f7..b609b5a2 100644 --- a/_config.yml +++ b/_config.yml @@ -111,6 +111,7 @@ titles_from_headings: include: - _redirects + - _data exclude: - package-lock.json - package.json diff --git a/_data/appFAQ.json b/_data/appFAQ.json new file mode 100644 index 00000000..c7c260e9 --- /dev/null +++ b/_data/appFAQ.json @@ -0,0 +1,221 @@ +{ + "faqs":[ + { + "question":"What is app mining?", + "answer":"

Traditionally the term mining in cryptocurrency refers to the process of + contributing compute resources to the network and earning a reward. In the + Blockstack Ecosystem, instead of just mining through computation, developers + mine by building apps and the Blockstack community funds them simply for being + pioneers in the emerging Blockchain software market.

We believe app + mining represents a revolution in app funding, allowing small teams to bootstrap + without advertising or venture capital. Each month, qualifying apps compete for + funding. Qualified apps are evaluated and ranked by expert app reviewers. The + better your app, the higher payout you earn.

The pilot run begins + December 1st 2018, with 34 Blockstack Apps enrolled. A previous alpha run in Oct + 2018 included 17 Blockstack apps. App mining is a new mining model that we + expect will evolve and improve over time. We look forward to feedback from our + community regarding the app mining process and program.

" + }, + { + "question":"How much can I earn and how are rewards distributed? ", + "answer":"

Payouts for the pilot run are $100k in total each month (the original alpha + run paid out $25K. In the pilot run, the highest-ranked app receives 20% of the + 100K, the next highest-ranked app receives 20% of the remaining 80%, and so on + (this distribution is subject to change).

Rewards are paid in Bitcoin. + The payouts are administered by Blockstack PBC and facilitated by App.co.

" + }, + { + "question":"How is app mining different from cryptocurrency mining?", + "answer":"

Traditionally the term mining in cryptocurrency refers to the process of + contributing compute resources to the network and earning a distributed of new + tokens as a reward. On the Stacks blockchain, developers can “mine” by + contributing apps to the ecosystem and making applications the community wants. +

" + }, + { + "question":"What qualifies my app to compete in app mining?", + "answer": "

Your app should integrate Blockstack authentication for logging into your app. + Your finished app should be available to the public for use. In the future, App + Mining may reward apps that have taken steps to further decentralize, such as + utilizing Gaia storage or the publishing your app to the Blockstack Naming + System.

" + }, + { + "question":"Does my app have to be listed on App.co to enter app mining?", + "answer": "

Yes, it does.

" + }, + { + "question":"How do I submit my application for app mining?", + "answer": "

Complete the submission form on + App.co. We suggest registering several days before the ranking + deadline — our team needs to verify your details to ensure your app + qualifies. When you have met all the requirements, you should see your + app listed on this page.

" + + }, + { + "question":"How often can I submit my application for app mining?", + "answer": "

You need only to submit your application once. Each month after your + submission, your app is competing in app mining.

" + }, + { + "question":"Does my code repository need to be public?", + "answer": "

Your application code can be public or private.

" + }, + { + "question":"Is Blockstack Auth difficult to integrate?", + "answer": "

If you’re already building your app with JavaScript, adding Blockstack + authentication is easy! We have docs, tutorials, and thorough API references for + you to learn from. Vist the Zero-to-Dapp + tutorial for end-to-end training. Or use this short + example.

If you’re developing a traditional server-side application, + you can still take advantage of Blockstack authentication. For an example, check + out our Ruby on Rails gem.

" + }, + { + "question":"Who are the app reviewers?", + "answer": "

App reviewers are currently selected by Blockstack PBC. Reviewers are + entities that have a proprietary methodology that helps them make objective + judgements for why a certain app might be better than others. We strive to + engage a diverse coalition of app reviewers with the goal of making application + ranking objective and resilient to abuse.

At the time of our app mining + alpha (October 2018), the reviewers were: Product Hunt and Democracy Earth (who + uses software to collect votes by Stacks token holders). Future reviewers could + expand to community election. Please see our forum to ask questions or make + suggestions for app mining.

" + }, + { + "question":"How are apps ranked?", + "answer": "

App reviewers have a proprietary methodology that helps them make + objective judgments for why one app might be better than another. Each + app reviewers determines the data, formula, and personnel they wish to + utilize. For example, Product Hunt can tap into their community data to + determine relative app popularity. Reviewers are required to publish + their methodology to ensure transparency periodically.

We've + published a detailed + explanation of our ranking algorithm on our blog and our + documentation, where you can learn more.

" + }, + { + "question":"Do I have to Hunt my app on Product Hunt?", + "answer": "

As part of the ranking process, there is an assessment by App Reviewer + Product Hunt via their community vote and their internal team vote. More info on + the algorithm, here. The Hunt + launch will have an impact on your final ranking, as you can see in the + algorithm breakdown. Here is more + info on Product Hunt launch best practices. In general, sharing and + responsiveness to questions are encouraged and it might help your community + reception if you choose to hunt the app yourself. If not, Product Hunt can hunt + your App as well.

Apps will be hunted every 6 months, so if you hunted + your app in a past month, as long as you are in the 6 month time window you will + not have to Hunt the app.

" + }, + { + "question":"Can developers engage with voters on Democracy Earth?", + "answer": "

As of this time, they cannot. In the future, a feature that could be + interesting here is allowing developers to comment only on their app and not + others.

" + }, + { + "question":"What’s the incentive for user voting? ", + "answer": "

Voters in the app mining ecosystem are currently Stacks token holders with + incentive to strategically allocate resources in the ecosystem to apps they + consider highly valuable.

" + }, + { + "question":"What are examples of any quantitative metrics that may be shared with app reviewers?", + "answer": "

Qualitative meticrs are metrics + that evaluate elements such as engagement, DAU/MAU ratios + etc from the reviewed apps? Blockstack plans to incorporate metrics based + ranking. However, before we do, any mechanism must thoughtfully incorporate the + digital privacy rights of Blockstack users, and provide information in a way + that cannot be gamed.

" + }, + { + "question":"Is app mining Decentralized?", + "answer": "

Given the pioneering nature of the program, we are being careful and starting + in a centralized fashion that allows for necessary diligence. We don’t want to + bake in assumptions that have not been validated. The downside of this + protection is some level of centralization, which we are taking steps to reduce + over time. The pilot is the just the first step in creating a fair system that + can be relied upon by founders and contribute to the growth of the Blockstack + ecosystem.

Blockstack plans to move along a path to decentralization and + App Mining will too. It is important to highlight that initially App Mining will + purposely have a few points of centralization highlighted below, which can + become decentralized over time (all plans are subject to change, legal approval, + and applicable law).

Electing app reviewers:

Currently, + Blockstack PBC elects app reviewers. In the future, we anticipate gradually + transitioning to community elections of App Reviewers.

Registering + apps:

Currently, registering apps is regulated by Blockstack PBC through + app.co/mining. In the future, we anticipate transitioning to publishing on + designated Blockstack namespaces via our public blockchain.

Collecting + votes:

Currently, votes are aggregated by Blockstack PBC and + administered via App.co. In the future, we expect that votes will be collected + through the protocol itself.

Issuing money:

Currently, payouts + are issued by Blockstack PBC. In the future, we expect that payouts will over + time be generated and deployed on an automated basis.

" + }, + { + "question":"How is App Mining protected against bribery, collusion, or gaming?", + "answer": "

We are taking potential threats very seriously and hope to create a fair + system that continuously reinforces trust within our community for the long + term.

We are currently consulting with a team of 3 Ph.D. Game Theorist + professors from Princeton University and New York University to determine + thoughtful methods to protect App Mining from being attacked and/or abused. Our + goal is to be as transparent as possible, but App Reviewers may reserve the + right to keep some secrets in their formula to avoid bribes and gaming, and the + algorithm that combines all of these score may be tuned in the future to account + for new learnings.

The Game Theorists are working with us to create a + technical paper and broader documents like blogs explaining the overall + mechanism

" + }, + { + "question":"What is the Blockstack Ecosystem?", + "answer":"

The Blockstack Ecosystem has a mission to bring a new internet where users + control the access to, and use of, their own identity and data. With this + mission in mind, three independent entities were formed:

These three affiliated entities drive the advancement of + the Blockstack mission. All three entities are committed to building a new + internet where users fundamental digital rights, such as security, privacy, + anti-censorship, are always respected.

" + }, + { + "question":"What is Blockstack PBC and the Blockstack Platform?", + "answer": "

Blockstack Public Benefit Corp. (PBC) started development of the Blockstack + Platform in 2014 and launched an alpha of the platform in early 2017. The + Blockstack Platform is the easiest way to start building decentralized, + blockchain-based apps. It provides a complete decentralized application stack, + powered by the Stacks blockchain, and maintained by a community of 7000 + developers.

" + }, + { + "question":"Disclaimer", + "answer":"

This FAQ contains forward-looking statements, including statements + regarding Blockstack PBC’s plans for its App Mining program. Forward-looking + statements are subject to risks and uncertainties that could cause actual + results to differ materially, and reported results should not be considered as + an indication of future performance. Potential risks and uncertainties that + could change our actual results include, but are not limited to, risks + associated with: the failure of App Mining Program to successfully incentivize + the development of applications for the Blockstack network; risks associated + with attacks designed to influence the App Reviewers or game their + methodologies; technical difficulties in the transition from a centralized to a + decentralized administration of the program. These forward-looking statements + speak only as of the date hereof. Blockstack PBC disclaims any obligation to + update these forward-looking statements.

Any decisions that may + be made through the App Mining Program regarding rewards provided to app + developers are not recommendations as to the quality of any investments that + individuals may make in a company that receives rewards. If you are considering + an investment in any of these companies, you should make your own decision + regarding that investment and not rely in any way on the results of the App + Mining program.

" + } + ] +} diff --git a/_data/navigation_learn.yml b/_data/navigation_learn.yml index e6de9359..b9e110d8 100644 --- a/_data/navigation_learn.yml +++ b/_data/navigation_learn.yml @@ -29,6 +29,6 @@ - title: Reference docs: - core/faq_developer - - common/mining_faq + - develop/appMiningFAQ - common/javascript_ref - common/core_ref diff --git a/_develop/appMiningFAQ.md b/_develop/appMiningFAQ.md new file mode 100644 index 00000000..c9db0aef --- /dev/null +++ b/_develop/appMiningFAQ.md @@ -0,0 +1,14 @@ +--- +layout: learn +permalink: /:collection/:path.html +--- +# App Mining FAQ + +* TOC +{:toc} + + +{% for faq in site.data.appFAQ.faqs %} +## {{ faq.question }} + {{ faq.answer }} +{% endfor %} diff --git a/_develop/faq-data.json b/_develop/faq-data.json new file mode 100644 index 00000000..f0a0498f --- /dev/null +++ b/_develop/faq-data.json @@ -0,0 +1,4 @@ +--- +layout: null +--- +{{ site.data.appFAQ | jsonify }} diff --git a/_org/wallet-install.md b/_org/wallet-install.md new file mode 100644 index 00000000..e50ae372 --- /dev/null +++ b/_org/wallet-install.md @@ -0,0 +1,103 @@ +--- +layout: org +permalink: /:collection/:path.html +--- +# Install the Stacks Wallet software +{:.no_toc} + +You use the Stacks Wallet software client alone or with a hardware wallet to +manage your Stacks tokens. On this page, you learn how to install the Stacks +Software wallet. This page contains the following: + +* TOC +{:toc} + +If you have already installed the latest Stacks wallet, see [Use the Stacks +Wallet software](wallet-use.html) in this documentation instead. + + +## Before you start + +If Trezor, install Trezor bridge https://wallet.trezor.io/data/bridge/latest/index.html + + +## Windows Installation + + +## Download and check the download + +1. Select the download button this page. +2. Download the software which is packaged in a Zip file. + +## Verify the download was secure + +During you wallet download, you are at risk of a man-in-the-middle attack (as an +example) from hackers interested in stealing your tokens or your other +information. To protect yourself from this type of attack, you should verify +your downloaded wallet software before you install it. Verification confirms +that you received the software signed by Blockstack PBC. + +1. Open command prompt. + + You can find it by typing command into the Start menu + +2. Change to the directory your wallet downloaded to by running cd + + By default that’s /Downloads , so you can run cd Downloads + +3. Run the Windows checksum utility by running: + + certUtil -hashfile windows-stacks-wallet.exe SHA512 + +4. Verify that the resulting hash is the same as the latest hash published on on https://blockstack.org/wallet + + + +## Mac OSX Installation + + +## Download and check the download + +1. Select the download button this page. +2. Download the software which is packaged in a Zip file. +3. Unzip the zip file. ?Is it a zip + +## Verify and then start the wallet + +During you wallet download, you are at risk of a man-in-the-middle attack (as an +example) from hackers interested in stealing your tokens or your other +information. To protect yourself from this type of attack, you should verify +your downloaded wallet software before you install it. Verification confirms +that you received the software signed by Blockstack PBC. + +1. From your Mac desktop, click on the magnifying glass in the top, right corner of your screen. + + ![Spotlight search launch](images/search-start.png) + + The Spotlight search bar appears. + +2. Enter terminal in the search field. + + ![Terminal](images/search-terminal.png) + +3. Select the **Terminal.app** to launch it. +4. Change to the directory in Terminal to the directory your wallet downloaded to + + The default directory is usually `/Downloads` so type cd ~/Downloads and press return + +5. Run the checksum utility shasum by typing the following command and pressing return: + + `shasum -a 512 macos-stacks-wallet.dmg` + +6. Verify that the resulting hash is the same as the latest hash published on on https://blockstack.org/wallet + +7. Run the dmg + + + +## Before you start + +You link your wallet with a Coinlist or other account with access to Bitcoin. Before you begin, make sure that +you have [an account with CoinList](https://coinlist.co/register). You must +create this account yourself. You use this account to load very small fractions +of Bitcoin to fuel your wallet transactions.