Update contribution guide

Author: lmiller1990

README.md

@@ -8,11 +8,15 @@ Welcome to the Vue Testing Handbook!
 
 This is a collection of short, focused examples on how to test Vue components. It uses `vue-test-utils`, the official library for testing Vue components, and Jest, a modern testing framework. It covers the `vue-test-utils` API, as well as best practises and useful parts of the Jest API for testing Vue components, as well an a demo project with all the example code.
 
+## Style
+
 Most sections have have a simple component or two, some tests, and the related code. Here is an example
 
-- [Setting up for TDD](https://github.com/lmiller1990/vue-testing-handbook/blob/master/docs/setting-up-for-tdd.md)
-- [Component](https://github.com/lmiller1990/vue-testing-handbook/blob/master/demo-app/src/components/Greeting.vue)
-- [Test](https://github.com/lmiller1990/vue-testing-handbook/blob/master/demo-app/tests/unit/Greeting.spec.js)
+- [Setting up for TDD](https://github.com/lmiller1990/vue-testing-handbook/blob/master/docs/setting-up-for-tdd.md). This is a guide about setting up an environment for TDD.
+- [Component](https://github.com/lmiller1990/vue-testing-handbook/blob/master/demo-app/src/components/Greeting.vue). This is the component usd in the guide.
+- [Test](https://github.com/lmiller1990/vue-testing-handbook/blob/master/demo-app/tests/unit/Greeting.spec.js). This is the test used in the guide.
+
+Guides should be short, concise, and focused on a single concept. The relevant code should be linked in the article, and easily reproduced by the reader.
 
 ## Languages
 
@@ -22,21 +26,23 @@ We are aiming to support Japanese and English for now.
 
 ### Development enviroment
 
-Clone the repo and run `yarn`. Then run `yarn dev` to open the dev server.　Access it on `localhost:8080`.
+Vuepress is used to generate the static website. Articles are written in markdown.
 
-There is an example project to run tests and examples. To run it, `cd demo-app`, then run `yarn`. To run the test run `yarn test:unit`.
+#### Guides
 
-### Existing pages
+Clone the repo and run `yarn` to install the dependencies. Then run `yarn dev` to open the dev server.　Access it on `localhost:8080`.
 
-Make an issue regarding what you think can be improved, and why. Once everyone is happy with the addition, add it in English. Someone will translate it so the guide stays in sync for both languages, and it will be merged.
+#### Code Samples
 
-### Adding a new page
+There is an example project to run tests and examples used in the guides. To run it the demo app, run `cd demo-app` to navigate into the project, then run `yarn` to install the dependencies. Run `yarn test:unit` to execute the test suite.
 
-Make an issue explaining the benefit of the new page. Once everyone is in agreement, add the new page. You should also add an example to the `demo-app` project, so readers can easily recreate the scenario. You should also create a new page for the Japaense documentation, so someone can translate it later. This helps keep the guie up to date.
+### Updates existing guides
 
-### Fixing grammar or stylist improvements
+Make an issue regarding what you think can be improved, or just make a PR. 
 
-Just make the PR.
+### Adding a new page
+
+Make an issue explaining the benefit of the new page. You should also add any relevant code and tests in the `demo-app` project, so readers can easily recreate the scenario.
 
 ## Vue Testing Handbook
 
@@ -60,18 +66,14 @@ Most sections have have a simple component or two, some tests, and the related c
 
 ### 開発環境
 
-レプをクローンして、`yarn`を実行します. そして`yarn dev`を実行して、`localhost:8080`にアクセスします。
+レプをクローンして、`yarn install`を実行して必要なモジュールをインストールします。そして`yarn dev`を実行して、`localhost:8080`にアクセスします。
 
-デモプロジェクトもあります。`cd demo-app`して、そして`yarn`を実行してインストールします。`yarn test:unit`でテストを実行します。
+ガイドに使うテストのデモプロジェクトもあります。`cd demo-app`して、そして`yarn install`を実行してインストールします。`yarn test:unit`でテストを実行します。
 
 ### 既存のページに貢献
 
-追加したいことについて課題を作ってください。ディスカッションしてから追加します。もし日本語だけで追加したら、誰かが翻訳してからマージします。
+Issueを切って、それかPRを出します。レビューします。
 
 ### 新しいページを追加
 
-課題を作って、新しいページの価値を説明してください。皆さんは賛成すると、新しいページを追加してください。`demo-app`プロジェクトにも書いたコードの例を追加してください。そうすると、ガイドが説明した内容を簡単に再現できます。もし日本語だけで追加すると、英語のページを作って、誰かが翻訳します。
-
-### 文法、スタイルだけの改善
-
-普通にPRを作ってください。
+課題を作って、新しいページの価値を説明してください。`demo-app`プロジェクトにも書いたコードの例を追加してください。そうすると、ガイドが説明した内容を簡単に再現できます。