Merge branch 'master' into sfc-to-fc

Author: piotrwitek

Diff for: generator/.all-contributorsrc renamed to .all-contributorsrc

@@ -37,3 +37,4 @@ jspm_packages
 .node_repl_history
 
 temp/
+playground/dist

Diff for: .gitignore

@@ -1,21 +1,29 @@
 # Contributing Guide
+
+## General
 1. Make sure you have read and understand the **Goals** section to be aligned with project goals.
 2. Before submitting a PR please comment in the relevant issue (or create a new one if it doesn't exist yet) to discuss all the requirements (this will prevent rejecting the PR and wasting your work).
-3. All workflow scripts (prettier, linter, tests) must pass successfully.
-4. Don't edit `README.md` directly - it is built using `sh ./generate.sh` script to inject code snippets from the sources in the `/playground` folder (this will make sure all code examples are nicely formatted and working)
-   - To make changes in `README.md` edit `.md` files that are located in the `/docs/markdown` folder
-   - To make changes in code snippets edit source files in `/playground` folder
-   - include directives look like this: `::[example|usage]='../../playground/src/components/sfc-counter.tsx'::`
-5. When submitting a PR please make sure that you run the following:
-```bash
-# run linter in `/playground` folder
-npm run lint
+3. All workflow scripts (prettier, linter, tests) must pass successfully (it is run automatically on CI and will fail on github checks).
+
+## PR Checklist
+- generate a new `README.md` from `README_SOURCE.md` using command:
+```
+sh ./generate-readme.sh
 
-# run type-checking in `/playground` folder
-npm run tsc
+# or if you don't like bash, simply use node.js
+# node ./generate-readme.js
+```
+
+## `README.md` and `README_SOURCE.md`
+Don't edit `README.md` directly - it is generated automatically from `README_SOURCE.md` using script.
+   - Use `sh ./generate-readme.sh` script to generate updated `README.md` (this will inject code examples using type-checked source files from the `/playground` folder)
+   - So to make changes in code examples edit source files in `/playground` folder
+
+**Source code inject directives:**
+```
+# Inject code block with highlighter
+::codeblock='playground/src/components/sfc-counter.tsx'::
 
-# always re-generate `README.md` from root folder
-sh ./generate.sh
-# don't like bash scripts? simply use node.js script
-# node ./generator/bin/generate-readme.js
+# Inject code block with highlighter and expander
+::expander='playground/src/components/sfc-counter.usage.tsx'::
 ```