vuejs
diff --git a/‎.editorconfig
Lines changed: 15 additions & 0 deletions b/‎.editorconfig
Lines changed: 15 additions & 0 deletions
diff --git a/‎.eslintrc
Lines changed: 7 additions & 8 deletions b/‎.eslintrc
Lines changed: 7 additions & 8 deletions
diff --git a/‎.github/COMMIT_CONVENTION.md
Lines changed: 83 additions & 0 deletions b/‎.github/COMMIT_CONVENTION.md
Lines changed: 83 additions & 0 deletions
diff --git a/‎.github/CONTRIBUTING.md
Lines changed: 15 additions & 16 deletions b/‎.github/CONTRIBUTING.md
Lines changed: 15 additions & 16 deletions
diff --git a/‎.github/ISSUE_TEMPLATE.md
Lines changed: 3 additions & 0 deletions b/‎.github/ISSUE_TEMPLATE.md
Lines changed: 3 additions & 0 deletions
diff --git a/‎.gitignore
Lines changed: 1 addition & 0 deletions b/‎.gitignore
Lines changed: 1 addition & 0 deletions
diff --git a/‎BACKERS.md
Lines changed: 66 additions & 25 deletions b/‎BACKERS.md
Lines changed: 66 additions & 25 deletions
@@ -0,0 +1,15 @@
+# http://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+insert_final_newline = false
+trim_trailing_whitespace = false
@@ -1,14 +1,13 @@
 {
   "root": true,
-  "parser": "babel-eslint",
-  "extends": "vue",
-  "plugins": ["flowtype"],
+  "plugins": [
+    "flowtype"
+  ],
+  "extends": [
+    "plugin:vue-libs/recommended",
+    "plugin:flowtype/recommended"
+  ],
   "globals": {
     "__WEEX__": true
-  },
-  "rules": {
-    "no-useless-escape": 0,
-    "flowtype/define-flow-type": 1,
-    "flowtype/use-flow-type": 1
   }
 }
@@ -0,0 +1,83 @@
+## Git Commit Message Convention
+
+> This is adapted from [Angular's commit convention](https://github.com/conventional-changelog/conventional-changelog/blob/master/packages/conventional-changelog-angular/convention.md).
+
+#### Examples
+
+Appears under "Features" header, pencil subheader:
+
+```
+feat(pencil): add 'graphiteWidth' option
+```
+
+Appears under "Bug Fixes" header, graphite subheader, with a link to issue #28:
+
+```
+fix(graphite): stop graphite breaking when width < 0.1
+
+close #28
+```
+
+Appears under "Performance Improvements" header, and under "Breaking Changes" with the breaking change explanation:
+
+```
+perf(pencil): remove graphiteWidth option
+
+BREAKING CHANGE: The graphiteWidth option has been removed. The default graphite width of 10mm is always used for performance reason.
+```
+
+The following commit and commit `667ecc1` do not appear in the changelog if they are under the same release. If not, the revert commit appears under the "Reverts" header.
+
+```
+revert: feat(pencil): add 'graphiteWidth' option
+
+This reverts commit 667ecc1654a317a13331b17617d973392f415f02.
+```
+
+### Full Message Format
+
+A commit message consists of a **header**, **body** and **footer**.  The header has a **type**, **scope** and **subject**:
+
+```
+<type>(<scope>): <subject>
+<BLANK LINE>
+<body>
+<BLANK LINE>
+<footer>
+```
+
+The **header** is mandatory and the **scope** of the header is optional.
+
+### Revert
+
+If the commit reverts a previous commit, it should begin with `revert: `, followed by the header of the reverted commit. In the body it should say: `This reverts commit <hash>.`, where the hash is the SHA of the commit being reverted.
+
+### Type
+
+If the prefix is `feat`, `fix` or `perf`, it will appear in the changelog. However if there is any [BREAKING CHANGE](#footer), the commit will always appear in the changelog.
+
+Other prefixes are up to your discretion. Suggested prefixes are `docs`, `chore`, `style`, `refactor`, and `test` for non-changelog related tasks.
+
+### Scope
+
+The scope could be anything specifying place of the commit change. For example `core`, `compiler`, `ssr`, `v-model`, `transition` etc...
+
+### Subject
+
+The subject contains succinct description of the change:
+
+* use the imperative, present tense: "change" not "changed" nor "changes"
+* don't capitalize first letter
+* no dot (.) at the end
+
+### Body
+
+Just as in the **subject**, use the imperative, present tense: "change" not "changed" nor "changes".
+The body should include the motivation for the change and contrast this with previous behavior.
+
+### Footer
+
+The footer should contain any information about **Breaking Changes** and is also the place to
+reference GitHub issues that this commit **Closes**.
+
+**Breaking Changes** should start with the word `BREAKING CHANGE:` with a space or two newlines. The rest of the commit message is then used for this.
@@ -43,13 +43,14 @@ After cloning the repo, run:
 $ npm install
 ```
 
-If you are on a Unix-like system, optionally install the Git pre-commit hook with:
+This will also run the `postinstall` script which links two git hooks:
 
-``` bash
-$ npm run install:hooks
-```
+- `pre-commit`: runs ESLint on staged files.
+- `commit-msg`: validates commit message format (see below).
+
+### Commiting Changes
 
-This will run ESLint on changed files before each commit.
+Commit messages should follow the [commit message convention](./COMMIT_CONVENTION.md) so that changelogs can be automatically generated. If git hooks have been properly linked, commit messages will be automatically validated upon commit. It is recommended to use `npm run commit` instead of `git commit`, which provides an interactive CLI for generating proper commit messages.
 
 ### Commonly used NPM scripts
 
@@ -73,10 +74,16 @@ The default test script will do the following: lint with ESLint -> type check wi
 
 ## Project Structure
 
-- **`build`**: contains build-related configuration files. In most cases you don't need to touch them.
+- **`build`**: contains build-related configuration files. In most cases you don't need to touch them. However, it would be helpful to familiarize yourself with the following files:
+
+  - `build/alias.js`: module import aliases used across all source code and tests.
+
+  - `build/config.js`: contains the build configurations for all files found in `dist/`. Check this file if you want to find out the entry source file for a dist file.
 
 - **`dist`**: contains built files for distribution. Note this directory is only updated when a release happens; they do not reflect the latest changes in development branches.
 
+  See [dist/README.md](https://github.com/vuejs/vue/blob/dev/dist/README.md) for more details on dist files.
+
 - **`flow`**: contains type declarations for [Flow](https://flowtype.org/). These declarations are loaded **globally** and you will see them used in type annotations in normal source code.
 
 - **`packages`**: contains `vue-server-renderer` and `vue-template-compiler`, which are distributed as separate NPM packages. They are automatically generated from the source code and always have the same version with the main `vue` package.
@@ -85,16 +92,6 @@ The default test script will do the following: lint with ESLint -> type check wi
 
 - **`src`**: contains the source code, obviously. The codebase is written in ES2015 with [Flow](https://flowtype.org/) type annotations.
 
-  - **`entries`**: contains entries for different builds and packages.
-
-    - **`web-runtime`**: the entry for `dist/vue.common.js`, a.k.a the runtime-only build. It does not include the template to render function compiler, so it does not support the `template` option. **This is set as the `main` field in `package.json` so it is the default export when you import Vue as an NPM package.**
-
-    - **`web-runtime-with-compiler`**: the entry for `dist/vue.js`, a.k.a the standalone build. It includes the template to render function compiler. To use this build from the NPM packages, do `import Vue from 'vue/dist/vue'`, or alias `vue` to `vue/dist/vue` in your build tool configuration.
-
-    - **`web-compiler.js`**: the entry for the `vue-template-compiler` NPM package.
-
-    - **`web-server-renderer.js`**: the entry for the `vue-server-renderer` NPM package.
-
   - **`compiler`**: contains code for the template-to-render-function compiler.
 
     The compiler consists of a parser (converts template strings to element ASTs), an optimizer (detects static trees for vdom render optimization), and a code generator (generate render function code from element ASTs). Note the codegen directly generates code strings from the element AST - it's done this way for smaller code size because the compiler is shipped to the browser in the standalone build.
@@ -117,6 +114,8 @@ The default test script will do the following: lint with ESLint -> type check wi
 
   - **`platforms`**: contains platform-specific code.
 
+    Entry files for dist builds are located in their respective platform directory.
+
     Each platform module contains three parts: `compiler`, `runtime` and `server`, corresponding to the three directories above. Each part contains platform-specific modules/utilities which are then imported and injected to the core counterparts in platform-specific entry files. For example, the code implementing the logic behind `v-bind:class` is in `platforms/web/runtime/modules/class.js` - which is imported in `entries/web-runtime.js` and used to create the browser-specific vdom patching function.
 
   - **`sfc`**: contains single-file component (`*.vue` files) parsing logic. This is used in the `vue-template-compiler` package.
 
@@ -4,4 +4,7 @@ IMPORTANT: Please use the following link to create a new issue:
   https://new-issue.vuejs.org/
 
 If your issue was not created using the app above, it will be closed immediately.
+
+中文用户请注意：
+请使用上面的链接来创建新的 issue。如果不是用上述工具创建的 issue 会被自动关闭。
 -->
@@ -9,3 +9,4 @@ dist/vue.common.min.js
 test/e2e/reports
 test/e2e/screenshots
 coverage
+RELEASE_NOTE*.md
@@ -4,63 +4,73 @@ You can join them in supporting  Vue.js development by [pledging on Patreon](htt
 
 ### $2000
 
-<a href="http://www.thedifferenceengine.io/">
-  <img width="600px" src="https://raw.githubusercontent.com/vuejs/vuejs.org/master/themes/vue/source/images/tde.png">
+<a href="https://stdlib.com/">
+  <img width="600px" src="https://raw.githubusercontent.com/vuejs/vuejs.org/master/themes/vue/source/images/stdlib.png">
+</a>
+
+---
+
+### $1000
+
+<a href="https://www.upyun.com/?utm_source=vue&utm_medium=ad&utm_content=github">
+  <img width="400px" src="https://raw.githubusercontent.com/vuejs/cn.vuejs.org/master/themes/vue/source/images/upyun-large.png">
 </a>
 
 ---
 
 ### $500
 
+<a href="https://deepstreamhub.com">
+  <img width="260px" src="https://raw.githubusercontent.com/vuejs/vuejs.org/master/themes/vue/source/images/deepstream.png">
+</a>
+<br><br>
 <a href="https://jsfiddle.net/">
   <img width="240px" src="https://raw.githubusercontent.com/vuejs/vuejs.org/master/themes/vue/source/images/jsfiddle.png">
 </a>
-
+<br><br>
 <a href="https://laravel.com">
   <img width="240px" src="https://raw.githubusercontent.com/vuejs/vuejs.org/master/themes/vue/source/images/laravel.png">
 </a>
-
+<br><br>
 <a href="https://chaitin.cn">
   <img width="240px" src="https://raw.githubusercontent.com/vuejs/vuejs.org/master/themes/vue/source/images/chaitin.png">
 </a>
-
+<br><br>
 <a href="https://htmlburger.com/">
   <img width="240px" src="https://raw.githubusercontent.com/vuejs/vuejs.org/master/themes/vue/source/images/htmlburger.png">
 </a>
-
+<br><br>
 <a href="https://starter.someline.com/">
   <img width="240px" src="https://raw.githubusercontent.com/vuejs/vuejs.org/master/themes/vue/source/images/someline.png">
 </a>
-
+<br><br>
 <a href="http://monterail.com/" target="_blank">
   <img width="240px" src="https://raw.githubusercontent.com/vuejs/vuejs.org/master/themes/vue/source/images/monterail.png">
 </a>
-
+<br><br>
 <a href="https://www.trisoft.ro/" target="_blank">
   <img width="240px" src="https://raw.githubusercontent.com/vuejs/vuejs.org/master/themes/vue/source/images/trisoft.png">
 </a>
-
+<br><br>
 <a href="https://www.2mhost.com/" target="_blank">
   <img width="240px" src="https://raw.githubusercontent.com/vuejs/vuejs.org/master/themes/vue/source/images/2mhost.png">
 </a>
-
+<br><br>
 <a href="https://vuejsjob.com/?ref=vuejs" target="_blank">
   <img width="240px" src="https://raw.githubusercontent.com/vuejs/vuejs.org/master/themes/vue/source/images/vuejobs.png">
 </a>
-
+<br><br>
 <a href="https://leanpub.com/vuejs2" target="_blank">
   <img width="240px" src="https://raw.githubusercontent.com/vuejs/vuejs.org/master/themes/vue/source/images/tmvuejs2.png">
 </a>
-
-<a href="https://stdlib.com/" target="_blank">
-  <img width="240px" src="https://raw.githubusercontent.com/vuejs/vuejs.org/master/themes/vue/source/images/stdlib.png">
+<br><br>
+<a href="https://famebroker.com" target="_blank">
+  <img width="260px" src="https://raw.githubusercontent.com/vuejs/vuejs.org/master/themes/vue/source/images/famebroker.png">
+</a>
+<br><br>
+<a href="https://component.io/" target="_blank">
+  <img width="260px" src="https://raw.githubusercontent.com/vuejs/vuejs.org/master/themes/vue/source/images/component_io.png">
 </a>
-
----
-
-### $250
-
-It could be you!
 
 ---
 
@@ -69,18 +79,26 @@ It could be you!
 <a href="http://tighten.co/">
   <img width="240px" src="http://i.imgur.com/T7fQYLT.png">
 </a>
-
+<br><br>
 <a href="http://invoicemachine.com/">
   <img width="220px" src="http://assets.invoicemachine.com/images/flat_logo.png">
 </a>
-
+<br><br>
 <a href="https://alligator.io">
   <img width="240px" src="https://alligator.io/images/alligator-logo.svg">
 </a>
-
+<br><br>
 <a href="https://monei.net/">
   <img width="200px" src="http://i.imgur.com/JUSjHAi.png">
 </a>
+<br><br>
+<a href="https://www.accelebrate.com/">
+  <img width="220px" src="https://www.accelebrate.com/assets/images/accelebrate_logo@2x.png">
+</a>
+<br><br>
+<a href="https://www.waterfall.com">
+  <img width="200px" src="https://waterfall.com/waterfall_logo_large.png">
+</a>
 
 ---
 
@@ -96,7 +114,6 @@ It could be you!
 - Wasim Khamlichi
 - errorrik
 - Alex Balashov
-- Cheng-Wei Chien
 
 ---
 
@@ -141,7 +158,6 @@ It could be you!
 - Anders
 - Dexter Miguel
 - Stephen Michael Hartley
-- TJ Fogarty
 - Wen-Tien Chang
 - Ole Støvern
 - Valerian Cure
@@ -222,3 +238,28 @@ It could be you!
 - Michael Richards
 - Eduardo Reveles
 - Jan Kremlacek
+- Guy Gavergun
+- Keith Bailey
+- Joel Birch
+- Bernhard E. Reiter
+- Radu Cretu
+- Luiz Tanure
+- Poamrong Rith
+- Chengzhi Yin
+- Dan Barrett
+- Zoran Knezevic
+- Charles Beaumont
+- Jonathan Kent
+- James Simpson
+- Pascal Germain
+- Pierre Vanhulst
+- Vincent Gabriel
+- Kyovo Digaw
+- devneko
+- Cheng-Wei Chien
+- Michael Mazurczak
+- Daniel
+- Chris Anderson
+- Jon Hobbs-Smith
+- Chez Tschetter
+- Akiho Nagao