Merge remote-tracking branch 'upstream/master'

# Conflicts resolved:
#	src/v2/api/index.md
#	src/v2/cookbook/client-side-storage.md
#	src/v2/cookbook/unit-testing-vue-components.md
#	src/v2/guide/comparison.md
#	src/v2/guide/components-registration.md
#	src/v2/guide/components.md
#	src/v2/guide/conditional.md
#	src/v2/guide/index.md
#	src/v2/guide/join.md
#	src/v2/guide/plugins.md
#	src/v2/guide/unit-testing.md
#	themes/vue/layout/sponsors-page.ejs

Author: MachinisteWeb

src/coc/index.md

@@ -0,0 +1,73 @@
+# Code Of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, sex characteristics, gender identity and expression,
+level of experience, education, socio-economic status, nationality, personal
+appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+  advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at vuejscommunity@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+
+[homepage]: https://www.contributor-covenant.org

src/v2/api/index.md

@@ -360,7 +360,9 @@ type: api
 
 - **Utilisation :**
 
-  Installe un plugin Vue.js. Si l'argument plugin est de type Object, il doit exposer une méthode  `install`. S'il s'agit d'une fonction, elle sera utilisée comme méthode d'installation. Cette méthode d'installation sera appelée avec Vue en tant qu'argument.
+  Installe un plugin Vue.js. Si l'argument plugin est de type `Object`, il doit exposer une méthode  `install`. S'il s'agit d'une fonction, elle sera utilisée comme méthode d'installation. Cette méthode d'installation sera appelée avec Vue en tant qu'argument.
+
+  Cette méthode doit être appelée avant d'appeler `new Vue()`
 
   Quand cette méthode est appelée avec le même plugin plusieurs fois, le plugin ne sera installé qu'une seule fois.
 

src/v2/cookbook/packaging-sfc-for-npm.md

@@ -172,7 +172,7 @@ With the package.json `scripts` section ready and the SFC wrapper in place, all
 import vue from 'rollup-plugin-vue'; // Handle .vue SFC files
 import buble from 'rollup-plugin-buble'; // Transpile/polyfill with reasonable browser support
 export default {
-    input: 'build/wrapper.js', // Path relative to package.json
+    input: 'src/wrapper.js', // Path relative to package.json
     output: {
         name: 'MyComponent',
         exports: 'named',

src/v2/cookbook/unit-testing-vue-components.md

@@ -57,9 +57,7 @@ test("Foo", () => {
   expect(wrapper.find(".error").exists()).toBe(true);
 
   // update the name to be long enough
-  wrapper.setData({
-    username: "Lachlan"
-  });
+  wrapper.setData({ username: 'Lachlan' })
 
   // assert the error has gone away
   expect(wrapper.find(".error").exists()).toBe(false);

src/v2/guide/comparison.md

@@ -26,7 +26,7 @@ Plusieurs des sections plus bas peuvent être incorrectes du fait de la récente
 
 ### Performance à l'exécution
 
-Vue comme React offrent des performances similaires et incroyables. La rapidité est un facteur de décision entre les deux assez minime. Pour le détail exacte des chiffres, vous pouvez regarder ce [benchmark tier](http://www.stefankrause.net/js-frameworks-benchmark7/table.html) se focalisant sur les performances brutes de rendu et de mise à jour avec de simples arbres de composant.
+Vue comme React offrent des performances similairement rapide, tellement rapide que que ce n'est pas un facteur de décision entre les deux. Pour le détail exacte des chiffres, vous pouvez regarder ce [benchmark tier](http://www.stefankrause.net/js-frameworks-benchmark8/table.html) se focalisant sur les performances brutes de rendu et de mise à jour avec de simples arbres de composant.
 
 #### Efforts d'optimisation
 
@@ -178,7 +178,7 @@ Pour finir, sans être profondément intégré à TypeScript comme peut l'être
 
 ### Performance à l'exécution
 
-Les deux frameworks sont exceptionnellement rapides avec des métriques similaires au benchmark. Utilisez les métriques spécifiques du [benchmark tier](http://www.stefankrause.net/js-frameworks-benchmark7/table.html) pour une comparaison plus granulaire, mais la rapidité n'est pas un facteur de décision.
+Les deux frameworks sont exceptionnellement rapides avec des métriques similaires au benchmark. Utilisez les métriques spécifiques du [benchmark tier](http://www.stefankrause.net/js-frameworks-benchmark8/table.html) pour une comparaison plus granulaire, mais la rapidité n'est pas un facteur de décision.
 
 ### Taille
 
@@ -204,7 +204,7 @@ Cela dit, il serait probablement plus judicieux de faire une comparaison entre l
 
 - La syntaxe des templates de Vue exploite toute la puissance des expressions JavaScript alors que les expressions Handlebars et les aides à la syntaxe sont intentionnellement limitées en comparaison.
 
-- Côté performance, Vue surpasse Ember [avec une bonne avance](http://www.stefankrause.net/js-frameworks-benchmark7/table.html), même après la dernière mise à jour du moteur Glimmer dans Ember 2.x. Vue regroupe automatiquement les rafraichissements des vues par lot, alors que dans Ember, vous devez gérer manuellement les boucles d'exécution dans les situations où la performance est critique.
+- Côté performance, Vue surpasse Ember [avec une bonne avance](http://www.stefankrause.net/js-frameworks-benchmark8/table.html), même après la dernière mise à jour du moteur Glimmer dans Ember 3.x. Vue regroupe automatiquement les rafraichissements des vues par lot, alors que dans Ember, vous devez gérer manuellement les boucles d'exécution dans les situations où la performance est critique.
 
 ## Knockout
 

src/v2/guide/components-registration.md

@@ -16,7 +16,7 @@ Vue.component('my-component-name', { /* ... */ })
 
 Le nom du composant est le premier argument de `Vue.component`.
 
-Le nom que vous donnez à un composant peut dépendre de l'endroit où vous avez l'intention de l'utiliser. Lorsque vous utilisez un composant directement dans le DOM (par opposition à une chaine ou un [composant monofichiers](single-file-components.html)), nous vous recommandons fortement de suivre [les règles du W3C](https://www.w3.org/TR/custom-elements/#concepts) pour les noms de balises personnalisées (tout en minuscules, contenir un trait d'union). Cela vous permet d'éviter les conflits avec les éléments HTML actuels et futurs.
+Le nom que vous donnez à un composant peut dépendre de l'endroit où vous avez l'intention de l'utiliser. Lorsque vous utilisez un composant directement dans le DOM (par opposition à une chaine ou un [composant monofichiers](single-file-components.html)), nous vous recommandons fortement de suivre [les règles du W3C](https://html.spec.whatwg.org/multipage/custom-elements.html#valid-custom-element-name) pour les noms de balises personnalisées (tout en minuscules, contenir un trait d'union). Cela vous permet d'éviter les conflits avec les éléments HTML actuels et futurs.
 
 Vous pouvez voir d'autres recommandations pour les noms de composants dans le guide des [Conventions](../style-guide/#Base-component-names-strongly-recommended).
 

src/v2/guide/conditional.md

@@ -196,4 +196,6 @@ D'une manière générale, `v-if` a des couts à la permutation plus élevés al
 
 ## `v-if` avec `v-for`
 
-Lorsqu’il est conjointement utilisé avec `v-for`, `v-for` a une priorité plus élevée que `v-if`. Consultez le <a href="../guide/list.html#v-for-avec-v-if">guide du rendu de liste</a> pour plus de détails.
+<p class="tip">Utiliser `v-if` et `v-for` ensemble n'est **pas recommandé**. Consultez le [guide des conventions](/v2/style-guide/#Eviter-v-if-avec-v-for-essentiel) pour plus d'informations.</p>
+
+Lorsqu'il est conjointement utilisé avec `v-for`, `v-for` a une priorité plus élevée que `v-if`. Consultez le <a href="../guide/list.html#v-for-avec-v-if">guide du rendu de liste</a> pour plus de détails.

src/v2/guide/index.md

@@ -387,7 +387,7 @@ Pour une grosse application, il est nécessaire de la diviser entièrement en co
 
 Vous avez peut-être remarqué que les composants de Vue sont très similaires aux **_Custom Elements_**, qui sont une partie de la [spécification des *Web Components*](https://www.w3.org/wiki/WebComponents/). C'est parce que la syntaxe de Vue est vaguement inspirée de cette spécification. Par exemple, les composants de Vue implémentent l'[API Slot](https://github.com/w3c/webcomponents/blob/gh-pages/proposals/Slots-Proposal.md) et l'attribut spécial `is`. Cependant, il y a quelques différences essentielles :
 
-1. La spécification des *Web Components* est toujours à l'état de brouillon, et n'est pas implémentée nativement dans tous les navigateurs. En comparaison, les composants de Vue n'ont besoin d'aucun *polyfill* et fonctionnent de la même manière dans tous les navigateurs supportés (IE9 et supérieurs). Quand cela est nécessaire, les composants de Vue peuvent également être implémentés à l'intérieur d'un élément personnalisé natif.
+1. La spécification des Web Components est finalisée mais n'est pas implémentée nativement dans tous les navigateurs. Safari 10.1+, Chrome 54+ et Firefox 63+ supporte nativement les Web Components. En comparaison, les composants de Vue n'ont besoin d'aucun polyfill et fonctionnent de la même manière dans tous les navigateurs supportés (IE9 et supérieurs). Quand cela est nécessaire, les composants de Vue peuvent également être implémentés à l'intérieur d'un élément personnalisé natif.
 
 2. Les composants de Vue fournissent des fonctionnalités importantes qui ne sont pas disponibles dans les éléments personnalisés  standards, notamment le flux de données entre composants, la communication par évènements personnalisés et l'intégration avec les outils de *build*.
 

src/v2/guide/join.md

@@ -8,7 +8,11 @@ La communauté Vue grandit incroyablement vite et si vous lisez ceci, il y a de
 
 Maintenant nous allons voir ensemble ce que la communauté peut faire pour vous et ce que vous pouvez faire pour la communauté.
 
-## Ressources qui te plairont
+## Ressources
+
+### Code de conduite
+
+Le [code de conduite](/coc) est un guide pour rendre facile l'enrichissement de tous et la communauté technique à laquelle nous participons
 
 ### Obtenir de l'aide
 

src/v2/guide/plugins.md

@@ -4,8 +4,6 @@ type: guide
 order: 304
 ---
 
-## Écrire un plugin
-
 Les plugins sont habituellement ajoutés au niveau des fonctionnalités globales de Vue. Il y a un cadre strictement défini pour un plugin et il y a divers types de plugins que vous pouvez écrire pour :
 
 1. Ajouter plusieurs méthodes globales ou propriétés. Par ex. [vue-custom-element](https://github.com/karol-f/vue-custom-element)
@@ -18,7 +16,39 @@ Les plugins sont habituellement ajoutés au niveau des fonctionnalités globales
 
 5. Fournir une bibliothèque qui fournit sa propre API, et qui en même temps injecte une combinaison des points précédents. Par ex. [vue-router](https://github.com/vuejs/vue-router)
 
-Un plugin Vue.js doit exposer une méthode `install`. Cette méthode sera appelée avec le constructeur de `Vue` en tant que premier argument, avec les options possibles suivantes :
+## Utiliser un plugin
+
+Utiliser un plugin en appelant la méthode globale `Vue.use()` :
+
+``` js
+// appelle `MyPlugin.install(Vue)`
+Vue.use(MyPlugin)
+```
+
+Vous pouvez optionnellement passer certaines options :
+
+``` js
+Vue.use(MyPlugin, { someOption: true })
+```
+
+`Vue.use` empêchera automatiquement l'utilisation du même plugin plusieurs fois. Ainsi, appeler cette fonction plusieurs fois sur le même plugin n'installera le plugin qu'une seule fois.
+
+Certains plugins fournis officiellement par Vue.js comme `vue-router` appellent automatiquement `Vue.use()` si `Vue` est disponible en tant que variable globale. Cependant, dans un environnement modulaire comme avec CommonJS, vous devrez toujours appeler explicitement `Vue.use()` :
+
+``` js
+// En utilisant CommonJS depuis Browserify ou webpack
+var Vue = require('vue')
+var VueRouter = require('vue-router')
+
+// N'oubliez pas de l'appeler
+Vue.use(VueRouter)
+```
+
+Consultez [awesome-vue](https://github.com/vuejs/awesome-vue#components--libraries) pour une large collection de plugins et bibliothèques fournis par la contribution de la communauté.
+
+## Écrire un plugin
+
+Un plugin Vue.js devrait exposer une méthode `install`. Cette méthode sera appelée avec le constructeur de `Vue` en tant que premier argument, avec les options possibles suivantes :
 
 ``` js
 MyPlugin.install = function (Vue, options) {
@@ -49,33 +79,3 @@ MyPlugin.install = function (Vue, options) {
   }
 }
 ```
-
-## Utiliser un plugin
-
-Utiliser un plugin en appelant la méthode globale `Vue.use()` :
-
-``` js
-// appelle `MyPlugin.install(Vue)`
-Vue.use(MyPlugin)
-```
-
-Vous pouvez optionnellement passer certaines options :
-
-``` js
-Vue.use(MyPlugin, { someOption: true })
-```
-
-`Vue.use` empêchera automatiquement l'utilisation du même plugin plusieurs fois. Ainsi, appeler cette fonction plusieurs fois sur le même plugin n'installera le plugin qu'une seule fois.
-
-Certains plugins fournis officiellement par Vue.js comme `vue-router` appellent automatiquement `Vue.use()` si `Vue` est disponible en tant que variable globale. Cependant, dans un environnement modulaire comme avec CommonJS, vous devrez toujours appeler explicitement `Vue.use()` :
-
-``` js
-// En utilisant CommonJS depuis Browserify ou webpack
-var Vue = require('vue')
-var VueRouter = require('vue-router')
-
-// N'oubliez pas de l'appeler
-Vue.use(VueRouter)
-```
-
-Consultez [awesome-vue](https://github.com/vuejs/awesome-vue#components--libraries) pour une large collection de plugins et bibliothèques fournis par la contribution de la communauté.

src/v2/guide/team.md

@@ -226,7 +226,9 @@ order: 803
     'Thessaloniki, Greece': [40.640063, 22.944419],
     'Tokyo, Japan': [35.689487, 139.691706],
     'Toronto, Canada': [43.653226, -79.383184],
-    'Wrocław, Poland': [51.107885, 17.038538]
+    'Wrocław, Poland': [51.107885, 17.038538],
+    'Boston, MA, USA': [42.360081, -71.058884],
+    'Kyiv, Ukraine': [50.450100, 30.523399]
   }
   var languageNameFor = {
     en: 'English',
@@ -243,7 +245,8 @@ order: 803
     hi: 'हिंदी',
     fa: 'فارسی',
     ko: '한국어',
-    ro: 'Română'
+    ro: 'Română',
+    uk: 'Українська'
   }
 
   var team = [{
@@ -372,7 +375,7 @@ order: 803
         'vue-i18n', 'vue-cli-plugin-i18n', 'vue-i18n-loader', 'vue-i18n-extensions'
       ],
       links: [
-        'https://cuusoo.com', 'http://frapwings.jp'
+        'https://www.patreon.com/kazupon', 'https://cuusoo.com', 'http://frapwings.jp'
       ]
     },
     {
@@ -503,6 +506,9 @@ order: 803
       ],
       reposPersonal: [
         'vue-apollo', 'vue-meteor', 'vue-virtual-scroller', 'v-tooltip'
+      ],
+      links: [
+        'http://patreon.com/akryum'
       ]
     },
     {
@@ -600,6 +606,9 @@ order: 803
       work: {
         role: 'Consultant'
       },
+      reposOfficial: [
+        'news.vuejs.org'
+      ],
       reposPersonal: [
         'shentao/vue-multiselect'
       ]
@@ -691,6 +700,37 @@ order: 803
   ]))
 
   var partners = [
+    {
+      name: 'Jen Looper',
+      title: 'Queen Fox',
+      city: 'Boston, MA, USA',
+      languages: ['en', 'fr'],
+      work: {
+        role: 'CEO',
+        org: 'Vue Vixens'
+      },
+      github: 'jlooper',
+      twitter: 'jenlooper',
+      links: [
+        'https://vuevixens.org/',
+        'https://nativescript-vue.org/'
+      ]
+    },
+    {
+      name: 'Natalia Tepluhina',
+      title: 'Fox Tech Guru',
+      city: 'Kyiv, Ukraine',
+      languages: ['uk', 'ru', 'en'],
+      work: {
+        role: 'CTO',
+        org: 'Vue Vixens',
+      },
+      github: 'NataliaTepluhina',
+      twitter: 'N_Tepluhina',
+      links: [
+        'https://vuevixens.org/'
+      ]
+    },
     {
       name: 'Alex Jover',
       title: 'Vue Components Squeezer',

src/v2/guide/unit-testing.md

@@ -71,7 +71,7 @@ describe('MyComponent', () => {
 
 ## Écrire des composants testables
 
-Une bonne partie du code en sortie du rendu d'un composant est principalement déterminée par les props qu'il reçoit. En fait, si le rendu d'un composant dépend uniquement de ses props, il devient assez facile à tester, de la même manière que l'on ferait une assertion sur la valeur de retour d'une fonction pure avec différents arguments. Voici un exemple :
+Une bonne partie du code en sortie du rendu d'un composant est principalement déterminée par les props qu'il reçoit. Si le rendu d'un composant dépend uniquement de ses props, il devient assez facile à tester, de la même manière que l'on ferait une assertion sur la valeur de retour d'une fonction pure avec différents arguments. Voici un exemple :
 
 ``` html
 <template>

themes/vue/_config.yml

@@ -98,6 +98,9 @@ gold_sponsors:
   - url: https://kintohub.com
     img: kintohub.png
     name: kinto hub
+  - url: https://opteo.com/vue
+    img: opteo.png
+    name: opteo
 
 silver_sponsors:
   - url: https://dopamine.bg/