Typos and spelling mistakes in /introduction

bokobza · bokobza · commit 3695e49f86b8 · 2017-02-28T22:55:16.000Z
Started reading the book and fixing errors as I go :-)
diff --git a/README.md b/README.md
@@ -10,36 +10,36 @@
 Indonesian: [Read](https://nopara73.gitbooks.io/programmingblockchainindonesian/content/) - [GitHub](https://github.com/ProgrammingBlockchain/ProgrammingBlockchain-Indonesian) - [GitBook](https://www.gitbook.com/book/nopara73/programmingblockchainindonesian)  
 
 ## Quick feedback
-If you notice any mistakes, and don't want to fix them yourself, open an issue [on the Github page of the book.](https://github.com/ProgrammingBlockchain/ProgrammingBlockchain)  
-If you are reading this book with GitBook, you can also create a quick inline comment by clicking "+" button for the paragraph.
+If you notice any mistakes and don't want to fix them yourself, open an issue [on the GitHub page of the book.](https://github.com/ProgrammingBlockchain/ProgrammingBlockchain)  
+If you are reading this book with GitBook, you can also create a quick inline comment by clicking the "+" button for the paragraph.
 
-## How can I fix a typo? Aka quick contribution
-1. Find [the book on Github](https://github.com/ProgrammingBlockchain/ProgrammingBlockchain)
+## How can I fix a typo? aka quick contribution
+1. Find [the book on GitHub](https://github.com/ProgrammingBlockchain/ProgrammingBlockchain)
 2. Fork
 3. Edit file
 4. Make a pull request
 
-## How can I write a new chapter? Aka extensive contribution
-1. Find [the book on Github](https://github.com/ProgrammingBlockchain/ProgrammingBlockchain)
+## How can I write a new chapter? aka extensive contribution
+1. Find [the book on GitHub](https://github.com/ProgrammingBlockchain/ProgrammingBlockchain)
 2. Fork
 3. Clone your fork
-4. Download and install [Gitbook editor](https://www.gitbook.com/)
-5. Open Gitbook editor
+4. Download and install [GitBook Editor](https://www.gitbook.com/editor)
+5. Open GitBook Editor
 6. Select "Import" and select the folder where you cloned your fork
 7. Edit book
 8. Save files and Sync
 9. Make a pull request
 
-## How can I write a new chapter? Aka extensive contribution (for whom are literate in git and markdown)
-1. Find [the book on Github](https://github.com/ProgrammingBlockchain/ProgrammingBlockchain)
+## How can I write a new chapter? aka extensive contribution (for those literate in git and markdown)
+1. Find [the book on GitHub](https://github.com/ProgrammingBlockchain/ProgrammingBlockchain)
 2. Fork
 3. Clone your fork to your computer
-4. Download and install [Atom editor](https://atom.io/) ( or your favorite editors , notepad++ ,vim ,etc)
-5. Open Atom editor
+4. Download and install the [Atom editor](https://atom.io/) (or your favorite editors: notepad++, vim, etc.)
+5. Open Atom
 6. Select "Open Folder" and select the folder where you cloned your fork
-7. Edit book with help of the Markdown Preview package (Cmd/Ctrl-Shift-M)
+7. Edit the book with the help of the Markdown Preview package (Cmd/Ctrl-Shift-M)
 8. Save files
-9. Commit and push to your remote repo with your favorite git client (Github Desktop,Gitbash,SourceTree and etc.)
+9. Commit and push to your remote repo with your favorite git client (GitHub Desktop, Git BASH, SourceTree, etc.)
 10. Make a pull request
 
 ## Enhancing your learning process  
@@ -52,11 +52,11 @@ For every donation on this address, you will appear on [http://n.bitcoin.ninja/]
 
 ![1KF8kUVHK42XzgcmJF4Lxz4wcL5WDL97PB](assets/BookQr.png)  
 
-[1KF8kUVHK42XzgcmJF4Lxz4wcL5WDL97PB](https://www.smartbit.com.au/address/1KF8kUVHK42XzgcmJF4Lxz4wcL5WDL97PB) 
+[1KF8kUVHK42XzgcmJF4Lxz4wcL5WDL97PB](https://www.smartbit.com.au/address/1KF8kUVHK42XzgcmJF4Lxz4wcL5WDL97PB)
 
 ## Links
 
 [The book on GitHub](https://github.com/ProgrammingBlockchain/ProgrammingBlockchain)  
-[The book on GitBook](https://www.gitbook.com/book/programmingblockchain/programmingblockchain) (You can download pdf, epub, mobi versions here.)  
+[The book on GitBook](https://www.gitbook.com/book/programmingblockchain/programmingblockchain) (you can download pdf, epub and mobi versions here.)  
 [Code examples on GitHub](https://github.com/ProgrammingBlockchain/ProgrammingBlockchainCodeExamples/)  
-[Hall of the Makers](http://n.bitcoin.ninja/) (Here are the true makers those succeeded to complete the challenges of this book.)
+[Hall of the Makers](http://n.bitcoin.ninja/) (here are the true makers: those that succeeded in completing the challenges of this book.)
diff --git a/SUMMARY.md b/SUMMARY.md
@@ -8,11 +8,11 @@
    * [Why C#?](introduction/why_c.md)
    * [Why this book?](introduction/why_do_people_hate_bitcoin.md)
    * [Crowdfunding this book](introduction/crowdfunding_this_book.md)
-   * [Complementary Reading](introduction/complementary_reading.md)
+   * [Complementary reading](introduction/complementary_reading.md)
    * [Diagrams](introduction/diagrams.md)
    * [License: CC (ASA 3U)](introduction/license_cc_asa_3u.md)
-   * [Pre-requisites](introduction/pre-requisites.md)
-   * [Project Setup](introduction/project_setup.md)
+   * [Prerequisites](introduction/pre-requisites.md)
+   * [Project setup](introduction/project_setup.md)
 * [Bitcoin transfer](bitcoin_transfer/README.md)
    * [Bitcoin address](bitcoin_transfer/bitcoin_address.md)
    * [ScriptPubKey](bitcoin_transfer/payment_script.md)
@@ -41,11 +41,10 @@
    * [Using the TransactionBuilder](other_types_of_ownership/using_the_transactionbuilder.md)
 * [Other types of asset](other_types_of_asset/README.md)
    * [Colored Coins](other_types_of_asset/colored_coins.md)
-   * [Issuing an Asset](other_types_of_asset/issuing_an_asset.md)
-   * [Transfer an Asset](other_types_of_asset/transfer_an_asset.md)
+   * [Issuing an asset](other_types_of_asset/issuing_an_asset.md)
+   * [Transferring an asset](other_types_of_asset/transfer_an_asset.md)
    * [Unit tests](other_types_of_asset/unit_tests.md)
    * [Ricardian contracts](other_types_of_asset/ricardian_contracts.md)
    * [Liquid Democracy](other_types_of_asset/liquid_democracy.md)
    * [Proof of Burn and Reputation](other_types_of_asset/proof_of_burn_and_reputation.md)
    * [Protecting your private keys](security/protecting_your_private_keys.md)
-
diff --git a/foreword.md b/foreword.md
@@ -15,7 +15,7 @@ An extract in _Fountain Head_ by Ayn Rand resonated with me.
 > "Your strength?"  
 > "Your work." He tossed the branch aside. "The material the earth offers you and what you make of it..."  
 
-I think The Blockchain is like the tree branch. For outsiders, it feels like a boring and useless collection of bits. For programmers and entrepreneurs, it is a marvelous raw material that can be shaped with our imagination. We give it meaning and purpose.
+I think the Blockchain is like the tree branch. For outsiders, it feels like a boring and useless collection of bits. For programmers and entrepreneurs, it is a marvelous raw material that can be shaped with our imagination. We give it meaning and purpose.
 
 Just as you need to know about wood to make a bow, spear or cane from a branch, you need to learn about programming to shape the Blockchain. My hope is that you will discover how much your skill and intelligence can shape that useless collection of bits.
 
@@ -25,4 +25,4 @@ This book will take you from basic to advanced use of the Blockchain. It will no
 
 > Satoshi Nakamoto once described Bitcoin as “boring grey in colour.”
 
-While programming to an API can assist in getting an application up quickly, the developer is limited to innovations that can take place against the API. By fully understanding the Blockchain, the developer is empowered to unleash its full potential.
+While programming to an API can assist in getting an application up quickly, the developer is limited to innovations that can take place against the API. By fully understanding the Blockchain, the developer is empowered to unleash its full potential.
diff --git a/introduction/diagrams.md b/introduction/diagrams.md
@@ -8,4 +8,4 @@ For example, the following diagram should be read as
 
 ![](../assets/encrypted_key.png)
 
-Code is nice, but sometimes a picture worths a thousand words. (Don’t worry, we’ll also write the code.)
+Code is nice, but sometimes a picture is worth a thousand words. (Don’t worry, we’ll also write the code.)
diff --git a/introduction/pre-requisites.md b/introduction/pre-requisites.md
@@ -1,18 +1,15 @@
-## Pre-requisites {#pre-requisites}
+## Prerequisites {#pre-requisites}
 
 ### Skills {#skills}
 
 *   You need to be comfortable with object oriented as well as functional programming.
-*   A basic grasp of C# is helpful, but we feel the code will be legible to Java and other C-based languages.
-*   No mathematic knowledge is required. We will not cover cryptography beyond the bare minimum that you need to know to make a secure service.
+*   A basic grasp of C# is helpful, but we feel the code will be legible to developers familiar with Java and other C-based languages.
+*   No mathematical knowledge is required. We will not cover cryptography beyond the bare minimum you need to know to make a secure service.
 *   You don’t need to have deep knowledge of Bitcoin.
 
 ### Tools {#tools}
 
-*   [Visual Studio Community Edition](https://www.visualstudio.com/) on Windows or [Xamarin Studio](https://store.xamarin.com) on Mac and Linux. (Both free)
+*   [Visual Studio Community Edition](https://www.visualstudio.com/) on Windows or [Xamarin Studio](https://store.xamarin.com) on Mac and Linux (both free).
 *   [Bitcoin Core](https://bitcoin.org/en/bitcoin-core/) - Ideally you have it, but you can just proceed without it.
 
-> **Tip:** If disk-space is an issue, consider running Bitcoin Core in pruning mode. It is practically the same as a full node (including security), except it throws away some of the old history.
-
-
-
+> **Tip:** If disk space is an issue, consider running Bitcoin Core in pruning mode. It is practically the same as a full node (including security), except it throws away some of the old history.
diff --git a/introduction/project_setup.md b/introduction/project_setup.md
@@ -4,18 +4,18 @@ Before we begin with the instruction, we should describe how we expect your proj
 
 1.  Create a new Project in Visual Studio (.NET 4.5 or higher)
 2.  Right click on “References” in Solution Explorer and select “Manage NuGet Packages…”
-3.  Search for “**NBitcoin”** and install it. (Or NBitcoin.Mono on MAC and Linux.)
+3.  Search for “**NBitcoin”** and install it (or NBitcoin.Mono on MAC and Linux.)
 ![](../assets/nuget.png)  
 
 > **Tip:** If you are on MAC or Linux and reference NBitcoin instead of NBitcoin.Mono you will be missing some classes.  
 
-NBitcoin is the .NET Bitcoin library, it is open-source, maintained by Nicolas Dorier, the main author of this book. 
+NBitcoin is the .NET Bitcoin library, it is open-source and maintained by Nicolas Dorier, the main author of this book.
 This library should always be included if you do anything Bitcoin related in C#.  
 NBitcoin supports cross-platform applications.  
 
 ### ## # How to debug into NBitcoin source code (optional)  
 
-NBitcoin lets you debug into its code, to make your life easier. For this feature to work make sure you have source server support enabled in Visual Studio (Tools/Options).   
+NBitcoin lets you debug into its code to make your life easier. For this feature to work make sure you have source server support enabled in Visual Studio (Tools/Options).   
 ![](../assets/visualstudio_enablesourceserversupport.png)  
 
-Now, if you step into NBitcoin code, the source code will be automatically fetched on github, and appear in visual studio debugger.  
+Now, if you step into NBitcoin's code, the source code will be automatically fetched from GitHub, and appear in the Visual Studio Debugger.  
diff --git a/introduction/why_blockchain_programming_and_not_bitcoin_program.md b/introduction/why_blockchain_programming_and_not_bitcoin_program.md
@@ -2,9 +2,9 @@
 
 The Blockchain is to Bitcoin as gold is to jewelry.
 
-We did not compare Bitcoin to a gold coin, but rather with a jewelry. That’s because gold’s first killer app was jewelry. Coins came later.
+We did not compare a bitcoin to a gold coin, but rather to jewelry. That’s because gold’s first killer app was jewellery. Coins came later.
 
-Do not be fooled into thinking that Bitcoin is flawed while the Blockchain is valuable. If gold is valuable, would you throw away a gold necklace? The Blockchain is built on and thrives because of bitcoin. Any increase in value of the Blockchain will increase the amount of Bitcoin that is spent to use it, which will increase its demand.
+Do not be fooled into thinking that Bitcoin is flawed while the Blockchain is valuable. If gold is valuable, would you throw away a gold necklace? The Blockchain is built on and thrives because of Bitcoin. Any increase in value of the Blockchain will increase the amount of bitcoins that is spent to use it, which will increase its demand.
 
 Whether or not your app will use the “Bitcoin as a currency” feature is your own decision.
 
diff --git a/introduction/why_c.md b/introduction/why_c.md
@@ -5,12 +5,11 @@ The .NET framework is popular in corporate environments. We also believe this is
 *   You can create portable code that functions across iOS, Android, Windows tablets/phones, desktops, servers and embedded devices, for free.
 *   Everything from the compiler to the core runtime is open source.
 *   The BizSpark program allows any startup to get all Microsoft tools, including $150/month of Azure service, for free.
-*   Visual Studio Community 2015 is a professional grade IDE that you can use freely as hobbyist.
+*   Visual Studio Community 2015 is a professional grade IDE that you can use freely as a hobbyist.
 *   C# is closely related to Java and C++. As such, it can be easily read by a big base of developers.
 *   Nicolas Dorier, one of the authors of this book, created the most popular Bitcoin Framework for .NET, called [NBitcoin](https://github.com/MetacoSA/NBitcoin).
 *   Every person I met who learned about C# will tell you it is the best language out there, even if it is not the one they are using at the moment.
 
 The authors of this book have over 15 years combined experience with C#. It is our go-to language for any project for fun or profit.  
 
 > **Fact:** We have not been paid by Microsoft. It’s not too late to change that.
-
diff --git a/introduction/why_do_people_hate_bitcoin.md b/introduction/why_do_people_hate_bitcoin.md
@@ -1,5 +1,5 @@
 ## Why this book?{#why-do-people-hate-new-technologies-bitcoin}
 
-Understanding Bitcoin is quite a challenge. You might be completely unfamiliar with it. You might be heavily invested, following the news for years, already became completely addicted, but still the whole thing feels like a big mess. Or you feel like you understand it, but you are lacking of practical knowledge. If you fell into any of the these categories, we believe this book is the best investment for your time.  
+Understanding Bitcoin is quite a challenge. You might be completely unfamiliar with it. You might be heavily invested, following the news for years, already became completely addicted, but still the whole thing feels like a big mess. Or you feel like you understand it, but you are lacking practical knowledge. If you fell into any of these categories, we believe this book is the best investment of your time.  
 
-If you let us guide you through the Blockchain world we will not only armor you with skills those are necessary to win any [/r/Bitcoin](http://www.reddit.com/r/Bitcoin/) arguments, but also enable you to wisely choose among the countless developer opportunities those come to your way daily. Furthermore you will also be able to make those ideas reality. And in general, what better way is there to understand something, but coding it?  
+If you let us guide you through the Blockchain world, we will not only arm you with skills necessary to win any [/r/Bitcoin](http://www.reddit.com/r/Bitcoin/) arguments, but also enable you to wisely choose between the countless developer opportunities that come your way daily. Furthermore, you will also be able to make those ideas reality. And in general, what better way is there to understand something, but coding it?  

Original file line number	Diff line number	Diff line change
`@@ -8,4 +8,4 @@ For example, the following diagram should be read as`
`8`	`8`
`9`	`9`	`![](../assets/encrypted_key.png)`
`10`	`10`
`11`		`-Code is nice, but sometimes a picture worths a thousand words. (Don’t worry, we’ll also write the code.)`
	`11`	`+Code is nice, but sometimes a picture is worth a thousand words. (Don’t worry, we’ll also write the code.)`