lukechilds
/
docs
mirror of https://github.com/lukechilds/docs.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Browse Source

Some copy edits (#27) 

Signed-off-by: Mary Anthony <mary@blockstack.com>
feat/clarity-updates
Moxiegirl 6 years ago
committed by GitHub
parent
507ce9d1a6
commit
59778f3ce1
No known key found for this signature in database GPG Key ID: 4AEE18F83AFDEB23
5 changed files with 47 additions and 49 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Split View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 20
      _develop/zero_to_dapp_1.md
  2. 8
      _develop/zero_to_dapp_2.md
  3. 34
      _develop/zero_to_dapp_3.md
  4. 22
      _develop/zero_to_dapp_3_win.md
  5. 12
      _develop/zero_to_dapp_4.md

20
_develop/zero_to_dapp_1.md
View File

@ -13,15 +13,15 @@ their own identity and data. This tutorial is written for developers who want
to learn about how to use the Blockstack Ecosystem to develop and fund
decentralized applications (DApps).
The tutorial has four pages, this is first of four pages. The top of each page
The tutorial has four pages and this is first. The top of each page
lists the contents. This page contains the following:
* TOC
{:toc}
Of course, you can skip pages if you want. Each page contains a section
describing who can/should skip and containing a link to the next tutorial page.
You can also use the menu on the left.
describing who can or should skip the page. The section contains a link to the next page.
You can also use the navigation on the left to skip pages.
<div class="uk-card uk-card-default uk-card-body">
<h5>Can you skip this page?</h5>
@ -46,7 +46,7 @@ has lived in or visited a foreign country and lost access to a site, to a
service, or to information because of government censorship also understands how
centralization impacts how people live.
Users and businesses see DApps as valuable because they solve the the
Users and businesses see DApps as valuable because they solve the
centralization problems of traditional applications. The following table
describes the features of traditional applications and the features of
blockchain applications:
@ -57,7 +57,7 @@ blockchain applications:
<th>Decentralized application</th>
</tr>
<tr>
<td>Users must create many username and password combinations for each service or application. Each combination must be managed and maintained. Also, each creation requires the user to provide,important or unique information into the care of a third-party.</td>
<td>Users must create many username and password combinations for each service or application. Each combination must be managed and maintained. Also, each creation requires the user to provide, important or unique information into the care of a third-party.</td>
<td>Users create and own one or more identities. They use their identities with all applications and services. For example, a user could use the same identity for buying books online as they use for social media.</td>
</tr>
<tr>
@ -65,7 +65,7 @@ blockchain applications:
<td>Personal information and data is encrypted and remains under the control of the user.,Users leaving an application leave no data behind because none was stored with the application.</td>
</tr>
<tr>
<td>Multiple accounts across many servers makes personal data subject to attack, misuse, and uncontrolled collection.</td>
<td>Multiple accounts across many servers make personal data subject to attack, misuse, and uncontrolled collection.</td>
<td>Users can audit access to their data and know who accessed their data and which date were accessed.</td>
</tr>
<tr>
@ -74,14 +74,14 @@ blockchain applications:
</tr>
</table>
The blockchain technology you build an DApp with determines the features available to your application.
The blockchain technology you build a DApp with determines the features available to your application.
## How Blockstack is seeding DApp development
Blockchain applications are a new paradigm for both application developers and
application users. New paradigms in any market, think solar power or electric
vehicles, need private and private coalitions to grow. The centralized hosting
and services known of as cloud computing were once new paradigms. It was the
and services known as cloud computing were once new paradigms. It was the
investment of billions in funds and incentives from governments and private
companies that grew the cloud computing market.
@ -130,12 +130,12 @@ key features of Blockstack’s platform.
{:.no_toc}
This section introduced you to the benefits of a decentralized application
(DApp). You also learned that, similar to other new paradigms, you learned both
(DApp). You also learned that, similar to other new paradigms, both
the public and private companies are committing serious resources to developing
blockchain tech. Finally, you learned Blockstack is designed so that you
can quickly build a DApp and enter this emerging market.
In the next section, you learn more about the developing DApps and how they are
In the next section, you learn more about developing DApps and how they are
different from traditional applications. You’ll also learn about the resources
Blockstack provides for DApp developers that help you clarify where to put your
efforts and how to fund them.

8
_develop/zero_to_dapp_2.md
View File

@ -44,7 +44,7 @@ How do you convey this to users?
Currently, users can create a Blockstack ID for free or buy their own ID. Dapps
that are submitted for app mining must include Blockstack authentication. This
authentication includes onboarding flow for users delievered through the
authentication includes onboarding flow for users delivered through the
Blockstack Browser. The language and concepts presented by the flow are
important for you to understand before writing your own DApp.
@ -56,7 +56,7 @@ trying logging on from a device or browser software you haven't used before.
{% include create_id.md %}
Once in the browser, investigate the account and locate the storage settings.
Consider the interaction as both a user and a app designer. Are these settings
Consider the interaction as both a user and an app designer. Are these settings
what you expected or would you change them?
### Take a user perspective
@ -75,7 +75,7 @@ As a developer, your understanding of applications is vastly different from a
standard application user. Prototyping (paper or wireframes) and user testing
can help you determine if your approach is correct before you begin coding.
1. Choose an application from the Blockstack Browser home page or from the <a href="https://app.co/" target="\_blank">list on the App.co site</a>.
1. Choose an application from the Blockstack Browser homepage or from the <a href="https://app.co/" target="\_blank">list on the App.co site</a>.
Blockstack maintains the App.co website as a central place for users and
developers to explore and review blockchain applications. This site has
@ -133,7 +133,7 @@ The EY test is a general test about the domains that blockchain application can
* Users own their identities
* Users have free choice of clients
If you haven't read it, read the full article <a href="http://127.0.0.1:4000/develop/dapp_principles.html" target="\_blank">on principles of Blockstack applications</a>.
If you haven't read it, read the full article <a href="/develop/dapp_principles.html" target="\_blank">on principles of Blockstack applications</a>.
### Tips for coming up with application ideas
{:.no_toc}

34
_develop/zero_to_dapp_3.md
View File

@ -34,10 +34,10 @@ tutorial even if you have no programming experience. Knowledgeable developers
should easily be able to complete the tutorial within an hour by following
along.
If you are a developer super hero, you may want to skip ahead or move
If you are a developer superhero, you may want to skip ahead or move
quickly and that's fine too.
## Get prerequisites and set up environment
## Get prerequisites and set up your environment
To follow this tutorial, you need the following:
@ -60,7 +60,7 @@ is an example of an identity.
ID with the required _secret recovery key_ or _magic recovery code_. The
secret recovery key is a 12 or 24 word phrase you recorded when you created
the ID. The magic recovery code is a string of characters Blockstack emailed
to you when you created the your identity. You can confirm your identity with either.
to you when you created your identity. You can confirm your identity with either.
* If you do not yet have a Blockstack ID, <a href="https://browser.blockstack.org/" target="\_blank">create one through the Blockstack Browser</a> .
@ -142,20 +142,20 @@ components. You'll use the `npm` command to install these packaged components.
3. If the `npm` command is not in your system, <a href="https://www.npmjs.com/get-npm" target="\_blank">install it using the instructions for your operating system</a>.
Installing the NPM tool can take a several minutes depending on your connection speed.
Installing the NPM tool can take several minutes depending on your connection speed.
## Overview of the Animal Kingdom DApp
You are going to build a DApp called AnimalKingdom. Animal Kingdom is a DApp for
the web. Users log into it and create a animal persona that rules over a a
the web. Users log into it and create an animal persona that rules over a
specific territory. The combination of persona and territory is a kingdom. Once
you create a kingdom, you can add subjects from other kingdoms.
The Animal Kingdom interacts with two Blockstack services, the Blockstack
Browser (https://browser.blockstack.org) and the Gaia data storage hub
(https://hub.blockstack.org/). The Blockstack Browser is itself
a DApp. The storage hub is purely a service without user facing functionality.
a DApp. The storage hub is purely a service without user-facing functionality.
The following table describes the key interactions and screens in the DApp.
@ -211,7 +211,7 @@ The following table describes the key interactions and screens in the DApp.
</a>
</div></td>
<td>
<p>Users can add subjects from territories in their own Animal Kingdom. The DApp updates the user's GAI hub each time the user addss a subect. Users can also visit other Animal Kingdom installations and add subjects from these as well. You'll learn how to modify the <b>Other Kingdoms</b> available in your installation.
<p>Users can add subjects from territories in their own Animal Kingdom. The DApp updates the user's GAI hub each time the user adds a subject. Users can also visit other Animal Kingdom installations and add subjects from these as well. You'll learn how to modify the <b>Other Kingdoms</b> available in your installation.
</p>
</td>
</tr>
@ -242,9 +242,9 @@ In this section, you copy the code for Animal Kingdom to your workstation.
<img src="images/kingdom-download.png" alt="">
After unzipping the file you should have a `animal-kingdom-master` directory.
After unzipping the file you should have the `animal-kingdom-master` directory.
5. In your terminal change directory into top of the directory by entering:
5. In your terminal change directory into the top of the directory by entering:
```bash
$ cd animal-kingdom-master
@ -364,7 +364,7 @@ can run the program you use NPM to get all the dependent packages.
For example, you could edit your animal or visit the other pages such as **Animals** or **Territories**.
7. Go back to your terminal where you started you application is running.
7. Go back to your terminal where you started your application is running.
8. Press `CTRL-C` to stop the application.
<img src="images/kingdom-stop.png" alt="">
@ -455,7 +455,7 @@ for the DApp. Data is encrypted at a unique URL on a GAI storage hub.
<div class="uk-card uk-card-default uk-card-body">
<h5>App Mining Requirement: Blockstack Authentication</h5>
<p>To participate in application mining, your application must integrate Blockstack authentication.
<p>To participate in application mining your application must integrate Blockstack authentication.
</p>
</div>
@ -486,14 +486,14 @@ loadMe() {
The `loadMe()` code uses the Blockstack's `getFile()` method to get the
specified file from the applications data store. If the users' data store on
GAIA does not have the data, which is the case for a new users, the Gaia hub
GAIA does not have the data, which is the case for new users, the Gaia hub
responds with HTTP `404` code and the `getFile` promise resolves to null. If you
are using a Chrome Developer Tools with the DApp, you'll see these errors in a
browser's developer **Console**.
<img src="images/kingdom-errors.png" alt="">
After a user choses an animal persona and a territory, the user presses **Done**
After a user chooses an animal persona and a territory, the user presses **Done**
and the application stores the user data on GAIA.
```js
@ -519,7 +519,7 @@ In the next section, you extend your Kingdom's configuration.
<div class="uk-card uk-card-default uk-card-body">
<h5>App Mining Requirement: Gaia Storage</h5>
<p>To participate in application mining, your application must make use of Gaia storage.
<p>To participate in application mining your application must make use of Gaia storage.
</p>
</div>
@ -676,7 +676,7 @@ backend services for static websites. GitHub is a code hosting site.
<div class="uk-card uk-card-default uk-card-body uk-section-muted">
<h5>App Mining Requirement: Review Accessibility</h5>
<p>To participate in application mining, your application must be available for review. Open source projects must provide the URL to their code. Projects with private repositories can provides their application in a package form.
<p>To participate in application mining your application must be available for review. Open source projects must provide the URL to their code. Projects with private repositories can provide their application in a package form.
</p>
</div>
@ -721,7 +721,7 @@ Before you begin, you need to build a site that is ready to deploy.
<img src="images/netlify-deploy.gif" alt="">
After a moment, Netlify builds your code and displays the location of your new webiste.
After a moment, Netlify builds your code and displays the location of your new website.
<img src="images/kingdom-build.png" alt="">
@ -735,7 +735,7 @@ Before you begin, you need to build a site that is ready to deploy.
<img src="images/kingdom-failed.png" alt="">
You get this message because, when you authenticates, your DApp at one URL
You get this message because, when you authenticate, your DApp at one URL
requested a resource (an identity) from another DApp, the Blockstack
Browser. A request for a resource outside of the origin (your new website)
is called as a _cross-origin request_(CORs). Getting data in this manner can

22
_develop/zero_to_dapp_3_win.md
View File

@ -26,10 +26,10 @@ tutorial even if you have no programming experience. Knowledgeable developers
should easily be able to complete the tutorial within an hour by following
along.
If you are a developer super hero, you may want to skip ahead or move
If you are a developer superhero, you may want to skip ahead or move
quickly and that's fine too.
## Get prerequisites and set up environment
## Get prerequisites and set up your environment
To follow this tutorial, you need the following:
@ -52,13 +52,11 @@ is an example of an identity.
ID with the required _secret recovery key_ or _magic recovery code_. The
secret recovery key is a 12 or 24 word phrase you recorded when you created
the ID. The magic recovery code is a string of characters Blockstack emailed
to you when you created the your identity. You can confirm your identity with either.
to you when you created your identity. You can confirm your identity with either.
* If you do not yet have a Blockstack ID, <a href="https://browser.blockstack.org/" target="\_blank">create one through the Blockstack Browser</a> .
Instructions for creating an ID are <a href="{{ site.baseurl
}}/browser/ids-introduction.html#create-an-initial-blockstack-id"
target="\_blank">available in this documentation</a>.
Instructions for creating an ID are <a href="{{ site.baseurl }}/browser/ids-introduction.html#create-an-initial-blockstack-id" target="\_blank">available in this documentation</a>.
### Ensure command-line access
@ -134,20 +132,20 @@ components. You'll use the `npm` command to install these packaged components.
3. If the `npm` command is not in your system, <a href="https://www.npmjs.com/get-npm" target="\_blank">install it</a>.
Installing the NPM tool can take a several minutes depending on your connection speed.
Installing the NPM tool can take several minutes depending on your connection speed.
## Overview of the Animal Kingdom DApp
You are going to build a DApp called AnimalKingdom. Animal Kingdom is a DApp for
the web. Users log into it and create a animal persona that rules over a a
the web. Users log into it and create an animal persona that rules over a
specific territory. The combination of persona and territory is a kingdom. Once
you create a kingdom, you can add subjects from other kingdoms.
The Animal Kingdom interacts with two Blockstack services, the Blockstack
Browser (https://browser.blockstack.org) and the Gaia data storage hub
(https://hub.blockstack.org/). The Blockstack Browser is itself
a DApp. The storage hub is purely a service without user facing functionality.
a DApp. The storage hub is purely a service without user-facing functionality.
The following table describes the key interactions and screens in the DApp.
@ -203,7 +201,7 @@ The following table describes the key interactions and screens in the DApp.
</a>
</div></td>
<td>
<p>Users can add subjects from territories in their own Animal Kingdom. The DApp updates the user's GAI hub each time the user addss a subect. Users can also visit other Animal Kingdom installations and add subjects from these as well. You'll learn how to modify the <b>Other Kingdoms</b> available in your installation.
<p>Users can add subjects from territories in their own Animal Kingdom. The DApp updates the user's GAI hub each time the user adds a subject. Users can also visit other Animal Kingdom installations and add subjects from these as well. You'll learn how to modify the <b>Other Kingdoms</b> available in your installation.
</p>
</td>
</tr>
@ -234,9 +232,9 @@ In this section, you copy the code for Animal Kingdom to your workstation.
<img src="images/kingdom-download.png" alt="">
After unzipping the file you should have a `animal-kingdom-master` directory.
After unzipping the file you should have an `animal-kingdom-master` directory.
5. In your terminal change directory into top of the directory by entering:
5. In your terminal change directory into the top of the directory by entering:
```bash
$ cd animal-kingdom-master

12
_develop/zero_to_dapp_4.md
View File

@ -8,8 +8,8 @@ permalink: /:collection/:path.html
**Zero to DAPP 4 of 4**
On this page, you learn about application mining as a funding source for your
new DApp efforts. You'll submit your sample Animal Kingdom to to App.co, the
Universal DApp store and earn a t-shirt. You'll also learn about other ways
new DApp efforts. You'll submit your sample Animal Kingdom to App.co, the
Universal DApp store and earn a t-shirt. You'll also learn about other ways
Blockstack helps your development efforts. This page contains the following topics:
* TOC
@ -36,7 +36,7 @@ participate in application mining.
{% include payout-appmining.md %}
You area going to make a practice submission using the Animal Kingdom sample.
You are going to make a practice submission using the Animal Kingdom sample.
## Submit your Animal Kingdom to App.co
@ -73,7 +73,7 @@ than one example, only your first submission receives a t-shirt." %}
<td>Describe your application.&nbsp;&nbsp;</td>
</tr>
<tr>
<td><strong>Webiste</strong></td>
<td><strong>Website</strong></td>
<td>The URL of the website where you deployed your application.&nbsp;&nbsp;</td>
</tr>
<tr>
@ -126,7 +126,7 @@ Blockstack reviews each submission to app mining. Through this contact, Blocksta
developers refine business models and facilitating interactions with investors.
Two areas that Blockstack assists are pre-funding and pitching.
* **Pre-funding.** Directed toward developers that have a proof of concept of either a blockchain application or an integration with Blockstack’s techology. Blockstack helps with sourcing of developers and designers. We can also help with direct access to our core team members that can help you refine or optimize your product.
* **Pre-funding.** Directed toward developers that have a proof of concept of either a blockchain application or an integration with Blockstack’s technology. Blockstack helps with sourcing of developers and designers. We can also help with direct access to our core team members that can help you refine or optimize your product.
* **Pitching investors.** Blockstack can help you with access to an extensive investor community. Prior to arranging meetings we can give you resources to refine and craft your pitch for the blockchain market.
In addition to app mining, Blockstack offers both a community reward program.
@ -144,7 +144,7 @@ Learn more about <a href="https://blockstack.org/blog/blockstack-community-rewar
You've completed the Zero to DApp tutorial and have joined the growing
DApp developer community on Blockstack. We hope you've taken the extra
step of submitting your Animal Kingdom application to the App.co site.
step of submitting your Animal Kingdom application to the App.co site.
<a href="https://twitter.com/share?ref_src=twsrc%5Etfw"
class="twitter-share-button" data-size="large" data-text="I'm the rule of my Animal Kingdom. Just submitted my Blockstack sample DApp to App.co @TheDappStore! Dapp on people." data-hashtags="blockstack,

Write Preview
Loading…
Cancel
Save