Merge remote-tracking branch 'upstream/master'

# Conflicts resolved:
#	README.md
#	src/v2/cookbook/adding-instance-properties.md
#	src/v2/guide/comparison.md
#	src/v2/guide/components-custom-events.md
#	src/v2/guide/components-edge-cases.md
#	src/v2/guide/components-props.md
#	src/v2/guide/components.md
#	src/v2/guide/computed.md
#	src/v2/guide/events.md
#	src/v2/guide/index.md
#	src/v2/guide/join.md
#	src/v2/guide/list.md
#	src/v2/guide/syntax.md
#	themes/vue/layout/partials/resources_dropdown.ejs

Signed-off-by: Haeresis <bruno.lesieur@gmail.com>

Author: MachinisteWeb

README.md

@@ -2,7 +2,15 @@
 
 Ce site est assemblé avec [hexo](http://hexo.io/). Le contenu du site est écrit au format Markdown et se trouve dans `src`. Les propositions de fusion (*pull request*) sont les bienvenues !
 
+<<<<<<< HEAD
 ## Développement
+=======
+## Writing
+
+See the [Vue Docs Writing Guide](https://github.com/vuejs/vuejs.org/blob/master/writing-guide.md) for our rules and recommendations on writing and maintaining documentation.
+
+## Developing
+>>>>>>> upstream/master
 
 Lancez un serveur de développement sur `localhost:4000` :
 

src/images/oxford-comma.jpg

@@ -44,7 +44,8 @@ partners_list:
         description:
             "Modus Create is a digital product agency that supports clients with business and product strategy consulting, customer experience, cloud services, and Agile software delivery. Our official partnerships with Atlassian, AWS, InVision, Cloudflare, GitHub, Ionic Framework, and Vue.js reinforce our proven results with digital transformation with organizations from startups to the Fortune 100."
         proficiencies:
-            - VueJs
+            - name: Vue.js
+              url: https://moduscreate.com/partners/vue/?utm_source=Vue&utm_medium=Partner-Page&utm_campaign=Vue_partnerpage
             - name: AWS
               url: https://moduscreate.com/partners/aws/?utm_source=Vue&utm_medium=Partner-Page&utm_campaign=Vue_partnerpage
             - name: Atlassian
@@ -90,10 +91,14 @@ partners_list:
         description:
             "Monterail is a full-service software development company with 100+ experts on board delivering meaningful software for start-ups, SMBs and enterprises. We build for the Web with Ruby on Rails, Python, JavaScript, and Agile. We guarantee this: a product so qualitative and aligned with your vision, you’ll swear it was built in-house."
         proficiencies:
-            - VueJs
-            - Ruby on Rails
-            - Javascript
-            - Python
+            - name: VueJs
+              url: https://hi.monterail.co/2NqPUa6
+            - name: Ruby on Rails
+              url: https://hi.monterail.co/31RvfBm
+            - name: Javascript
+              url: https://hi.monterail.co/34cWQhR
+            - name: Python
+              url: https://hi.monterail.co/2MXHLeb
             - name: Services
               url:  https://www.monterail.com/services
             - name: Projects
@@ -103,7 +108,7 @@ partners_list:
             - English
             - Polish
         url_text: www.monterail.com
-        url_link: www.monterail.com
+        url_link: www.monterail.com/?utm_campaign=Vue.js&utm_source=partner-list
         hire_url: www.monterail.com/contact
         email: hello@monterail.com
         social_links:
@@ -127,4 +132,46 @@ partners_list:
                 name: Instagram
                 class: instagram
                 url: 'https://www.instagram.com/monterail/'
+    -
+        name: Rangle
+        logo: https://res.cloudinary.com/rangle/image/upload/q_auto,f_auto/vuejs.org/rangle_black_lockup_n6q48z.png
+        description:
+            "Rangle is a global digital consultancy that helps ambitious organizations outperform the competition in the most demanding markets. We work closely with our clients as one team to imagine, design, and deliver human-centered digital experiences that create lasting results and real business value. Anchored in innovation and lean startup best-practices, our unique delivery and partnership model is purposed-built to this task."
+        proficiencies:
+            - name: Building Products
+              url: https://rangle.io/#build-a-product/?utm_source=referral&utm_medium=partner&utm_campaign=vue-partners
+            - name: Improving Experiences
+              url: https://rangle.io/#improve-an-experience/?utm_source=referral&utm_medium=partner&utm_campaign=vue-partners
+            - name: Training & Coaching
+              url: https://rangle.io/#level-up-your-team/?utm_source=referral&utm_medium=partner&utm_campaign=vue-partners
+            - name: Agile Transformation
+              url: https://rangle.io/#adopt-agile-delivery/?utm_source=referral&utm_medium=partner&utm_campaign=vue-partners
+            - name: Business Transformation
+              url: https://rangle.io/#transform-your-business/?utm_source=referral&utm_medium=partner&utm_campaign=vue-partners
+        location: Toronto, ON, CA　Atlanta, GA, USA　Amsterdam, Netherlands　Tokyo, Japan
+        languages:
+            - English
+            - French
+            - Dutch
+        url_text: rangle.io
+        url_link: rangle.io/?utm_source=referral&utm_medium=partner&utm_campaign=vue-partners
+        hire_url: rangle.io/contact-us/?utm_source=referral&utm_medium=partner&utm_campaign=vue-partners
+        email: info@rangle.io
+        social_links:
+            -
+                name: GitHub
+                class: github
+                url: 'https://github.com/rangle'
+            -
+                name: LinkedIn
+                class: linkedin
+                url: 'https://www.linkedin.com/company/rangle/'
+            -
+                name: Twitter
+                class: twitter
+                url: 'https://twitter.com/rangleio'
+            -
+                name: Instagram
+                class: instagram
+                url: 'https://www.instagram.com/rangleio/?hl=en'
 ---

src/resources/partners.md

@@ -20,7 +20,7 @@ order: 804
     <h2 :id="partner.name">{{partner.name}}</h2>
     <blockquote class="theme-partner-description" v-html="partnerDescription"></blockquote>
     <div class="themes-grid">
-      <div v-for="product in partner.products" :key="product.name" class="item-preview">
+      <div v-for="product in partner.products" :key="product.url" class="item-preview">
         <a class="item-preview-img" :href="product.url" rel="sponsored">
           <img :src="product.image" :alt="`${product.name} - ${product.description}`" loading="lazy">
         </a>

src/resources/themes.md

@@ -58,7 +58,7 @@ new Vue({
 })
 ```
 
-Cela sera `"Mon App"`, puis `"Le nom d'une autre app"`, car `this.appName` est écrasée ([en quelque sorte](https://github.com/getify/You-Dont-Know-JS/blob/2nd-ed/this-object-prototypes/ch5.md)) par `data` quand l'instance est créée. Nous limitons la portée des propriétés avec `$` pour éviter ça. Vous pouvez même utiliser votre propre convention si vous préférez, comme `$_appName` ou `ΩappName`, pour en plus prévenir les conflits avec les plugins et les fonctionnalités futures.
+Cela sera `"Mon App"`, puis `"Le nom d'une autre app"`, car `this.appName` est écrasée ([en quelque sorte](https://github.com/getify/You-Dont-Know-JS/blob/2nd-ed/objects-classes/ch5.md)) par `data` quand l'instance est créée. Nous limitons la portée des propriétés avec `$` pour éviter ça. Vous pouvez même utiliser votre propre convention si vous préférez, comme `$_appName` ou `ΩappName`, pour en plus prévenir les conflits avec les plugins et les fonctionnalités futures.
 
 ## Un exemple en situation réelle : Remplacer Vue Resource par Axios
 

src/v2/cookbook/adding-instance-properties.md

@@ -7,7 +7,7 @@ order: 6
 Un besoin classique de la liaison de données est la manipulation de la liste des classes d'un élément, ainsi que ses styles en ligne. Puisque ce sont tous deux des attributs, il est possible d'utiliser `v-bind`  pour les gérer : il faut simplement générer une chaine de caractère avec nos expressions. Cependant la concaténation de chaine de caractères est fastidieuse et source d'erreur. Pour cette raison, Vue fournit des améliorations spécifiques quand `v-bind` est utilisé avec `class` et `style`. En plus des chaines de caractères, l'expression peut évaluer des objets ou des tableaux.
 
 ## Liaison de Classes HTML
-<div class="vueschool"><a href="https://vueschool.io/lessons/vuejs-dynamic-classes?friend=vuejs" target="_blank" rel="sponsored noopener" title="Cours Vue.js gratuit sur les classes dynamiques">Regarder le cours gratuit sur Vue School</a></div>
+<div class="vueschool"><a href="https://vueschool.io/lessons/vuejs-dynamic-classes?friend=vuejs" target="_blank" rel="sponsored noopener" title="Cours Vue.js gratuit sur les classes dynamiques">Regarder le cours gratuit sur Vue School (EN)</a></div>
 
 ### Syntaxe Objet
 

src/v2/guide/class-and-style.md

@@ -224,5 +224,5 @@ Avec Polymer, l'équipe a également créé un système de liaison de données v
 
 Riot 3.0 fournit un modèle de développement similaire orienté composant (cela est appelé un « tag » dans Riot), avec une API minimaliste mais conçue de manière élégante. Riot et Vue partagent probablement beaucoup de choses dans leur philosophie d'architecture. Cependant, bien qu'étant un peu plus lourd que Riot, Vue offre certains avantages significatifs :
 
-- De meilleures performances. Riot [utilise le DOM](http://riotjs.com/compare/#virtual-dom-vs-expressions-binding) plutôt qu'un DOM virtuel, et par conséquent il souffre des mêmes problèmes de performances que AngularJS.
+- De meilleures performances. Riot [utilise le DOM](https://v3.riotjs.now.sh/compare/#virtual-dom-vs-expressions-binding) plutôt qu'un DOM virtuel, et par conséquent il souffre des mêmes problèmes de performances que AngularJS.
 - Le support d'un outillage plus mature. Vue fournit un support officiel pour [webpack](https://github.com/vuejs/vue-loader) et [Browserify](https://github.com/vuejs/vueify), là où Riot s'appuie sur le soutien de la communauté pour l'intégration de systèmes de build.

src/v2/guide/comparison.md

@@ -6,6 +6,8 @@ order: 103
 
 > Cette page suppose que vous avez déjà lu les principes de base des [composants](components.html). Lisez-les en premier si les composants sont quelque chose de nouveau pour vous.
 
+<div class="vueschool"><a href="https://vueschool.io/lessons/communication-between-components?friend=vuejs" target="_blank" rel="sponsored noopener" title="Cours Vue.js gratuit sur les évènements personnalisés">Regarder le cours gratuit sur Vue School (EN)</a></div>
+
 ## Noms d'événements
 
 Contrairement aux composants et aux props, les noms d'événements ne fournissent pas de conversion kebab-case/camelCase. Le nom de l'événement émis doit correspondre exactement au nom utilisé pour écouter cet événement. Par exemple, si l'on émet un nom d'événement en camelCase :

src/v2/guide/components-custom-events.md

@@ -201,7 +201,7 @@ Pour plus de détails sur `<keep-alive>`, consultez la [référence API](../api/
 
 ## Composants asynchrones
 
-<div class="vueschool"><a href="https://vueschool.io/lessons/dynamically-load-components?friend=vuejs" target="_blank" rel="sponsored noopener" title="Cours Vue.js gratuit sur les composants asynchrones">Regarder le cours gratuit sur Vue School</a></div>
+<div class="vueschool"><a href="https://vueschool.io/lessons/dynamically-load-components?friend=vuejs" target="_blank" rel="sponsored noopener" title="Cours Vue.js gratuit sur les composants asynchrones">Regarder le cours gratuit sur Vue School (EN)</a></div>
 
 Dans de grosses applications, nous pouvons avoir besoin de diviser l'application en morceaux plus petits et charger un composant depuis le serveur seulement lorsque celui-ci est requis. Pour rendre cela plus facile, Vue vous permet de définir un composant en tant que fonction usine qui va résoudre de façon asynchrone la définition de votre composant. Vue déclenchera la fonction usine seulement lorsque le rendu du composant est nécessaire, et mettra en cache le résultat pour les futurs nouveaux rendus. Par exemple :
 

src/v2/guide/components-dynamic-async.md

@@ -233,7 +233,7 @@ methods: {
 }
 ```
 
-Consultez [ce fiddle](https://jsfiddle.net/chrisvfritz/1Leb7up8/) pour le code complet. Notez cependant que si vous vous trouvez à devoir faire beaucoup de code de montage et de nettoyage au sein d'un seul composant, la meilleure solution sera souvent de créer des composants plus modulaires. Dans le cas présent, nous recommanderions de créer un composant réutilisable `<input-datepicker>`.
+Consultez [ce fiddle](https://jsfiddle.net/09jvu65m/) pour le code complet. Notez cependant que si vous vous trouvez à devoir faire beaucoup de code de montage et de nettoyage au sein d'un seul composant, la meilleure solution sera souvent de créer des composants plus modulaires. Dans le cas présent, nous recommanderions de créer un composant réutilisable `<input-datepicker>`.
 
 Pour en apprendre plus sur les écouteurs programmatiques, allez voir l'API des [méthodes d'événements d'une instance](https://vuejs.org/v2/api/#Instance-Methods-Events).
 

src/v2/guide/components-edge-cases.md

@@ -6,6 +6,8 @@ order: 102
 
 > Cette page suppose que vous avez déjà lu les principes de base des [composants](components.html). Lisez-les en premier si les composants sont quelque chose de nouveau pour vous.
 
+<div class="vueschool"><a href="https://vueschool.io/lessons/reusable-components-with-props?friend=vuejs" target="_blank" rel="sponsored noopener" title="Cours Vue.js gratuit sur les props">Regarder le cours gratuit sur Vue School (EN)</a></div>
+
 ## Casse des props (camelCase vs. kebab-case)
 
 Les noms d'attributs HTML sont insensibles à la casse, aussi les navigateurs interprèteront de la même manière les majuscules et les minuscules. Cela signifie que pour l'utilisation des templates directement dans le DOM, les props en camelCase doivent utiliser leur équivalent kebab-case (délimités par des tirets) :

src/v2/guide/components-props.md

@@ -6,7 +6,7 @@ order: 101
 
 > Cette page suppose que vous avez déjà lu les principes de base des [composants](components.html). Lisez-les en premier si les composants sont quelque chose de nouveau pour vous.
 
-<div class="vueschool"><a href="https://vueschool.io/lessons/global-vs-local-components?friend=vuejs" target="_blank" rel="sponsored noopener" title="Cours Vue.js gratuit sur l'abonnement des composants">Regarder le cours gratuit sur Vue School</a></div>
+<div class="vueschool"><a href="https://vueschool.io/lessons/global-vs-local-components?friend=vuejs" target="_blank" rel="sponsored noopener" title="Cours Vue.js gratuit sur l'abonnement des composants">Regarder le cours gratuit sur Vue School (EN)</a></div>
 
 ## Noms de composant
 

src/v2/guide/components-registration.md

@@ -4,7 +4,7 @@ type: guide
 order: 11
 ---
 
-<div class="vueschool"><a href="https://vueschool.io/courses/vuejs-components-fundamentals?friend=vuejs" target="_blank" rel="sponsored noopener" title="Cours Vue.js gratuit sur les fondamentaux des composants">Regarder le cours gratuit sur Vue School</a></div>
+<div class="vueschool"><a href="https://vueschool.io/courses/vuejs-components-fundamentals?friend=vuejs" target="_blank" rel="sponsored noopener" title="Cours Vue.js gratuit sur les fondamentaux des composants">Regarder le cours gratuit sur Vue School (EN)</a></div>
 
 ## Exemple de base
 
@@ -603,6 +603,8 @@ Dans l'exemple ci-dessus, `currentTabComponent` peut contenir soit :
 
 Regardez [ce fiddle](https://jsfiddle.net/chrisvfritz/o3nycadu/) pour expérimenter cela avec un code complet, ou [cette version](https://jsfiddle.net/chrisvfritz/b2qj69o1/) pour un exemple lié à un objet d'option de composant plutôt qu'à un nom enregistré.
 
+Gardez à l'esprit que ces attributs peuvent être utilisés sur des éléments HTML standard, cependant ils seront traités comme des composants, ce qui signifie que tous les attributs **seront liés en tant qu'attribut du DOM**. Pour que diverses propriétés fonctionnent comme vous le souhaité, comme pour `value`, vous allez devoir les liés en utilisant le [modificateur `.prop`](../api/#v-bind).
+
 C'est tout ce que vous avez besoin de savoir à propos des composants dynamiques pour le moment, mais une fois que vous aurez fini de lire cette page et que vous vous sentirez à l'aise avec son contenu, nous vous recommandons de revenir pour lire le guide complet à propos des [Composants dynamiques et asynchrones](components-dynamic-async.html).
 
 ## Cas particuliers de l'analyse des templates de DOM

src/v2/guide/components.md

@@ -6,6 +6,8 @@ order: 5
 
 ## Propriétés calculées
 
+<div class="vueschool"><a href="https://vueschool.io/lessons/vuejs-computed-properties?friend=vuejs" target="_blank" rel="sponsored noopener" title="Cours Vue.js gratuit sur les propriétés calculées et observateurs">Regarder le cours gratuit sur Vue School (EN)</a></div>
+
 Les expressions dans le template sont très pratiques, mais elles sont uniquement destinées à des opérations simples. Mettre trop de logique dans vos templates peut les rendre trop verbeux et difficiles à maintenir. Par exemple :
 
 ``` html

src/v2/guide/computed.md

@@ -4,6 +4,8 @@ type: guide
 order: 7
 ---
 
+<div class="vueschool"><a href="https://vueschool.io/lessons/vuejs-conditionals?friend=vuejs" target="_blank" rel="sponsored noopener" title="Learn how conditional rendering works with Vue School">Learn how conditional rendering works with a free lesson on Vue School</a></div>
+
 ## `v-if`
 
 La directive `v-if` est utilisée pour conditionnellement faire le rendu d'un bloc. Le rendu du bloc sera effectué uniquement si l'expression de la directive retourne une valeur évaluée à vrai.

src/v2/guide/conditional.md

@@ -6,7 +6,7 @@ order: 302
 
 ## Introduction
 
-<div class="vueschool"><a href="https://vueschool.io/lessons/create-vuejs-directive?friend=vuejs" target="_blank" rel="sponsored noopener" title="Cours Vue.js gratuit sur les directives personnalisées">Regarder le cours gratuit sur Vue School</a></div>
+<div class="vueschool"><a href="https://vueschool.io/lessons/create-vuejs-directive?friend=vuejs" target="_blank" rel="sponsored noopener" title="Cours Vue.js gratuit sur les directives personnalisées">Regarder le cours gratuit sur Vue School (EN)</a></div>
 
 En supplément de l'ensemble de directives fournies par défaut (`v-model` et `v-show`), Vue vous permet également d'enregistrer vos propres directives. Notez qu'avec Vue 2.0, les composants sont la forme principale de réutilisabilité et d'abstraction du code. Il y a cependant des cas où vous aurez juste besoin d'un accès de bas niveau aux éléments du DOM, et c'est là que les directives personnalisées vous seraient utiles. Un exemple pourrait être la prise du focus sur un élément de champ, comme celui-ci :
 

src/v2/guide/custom-directive.md

@@ -4,6 +4,8 @@ type: guide
 order: 9
 ---
 
+<div class="vueschool"><a href="https://vueschool.io/lessons/vuejs-user-events?friend=vuejs" target="_blank" rel="sponsored noopener" title="Cours Vue.js gratuit sur la gestion des évènements">Regarder le cours gratuit sur Vue School (EN)</a></div>
+
 ## Écouter des évènements
 
 Nous pouvons utiliser l'instruction `v-on` pour écouter les évènements du DOM afin d'exécuter du JavaScript lorsque ces évènements surviennent.
@@ -154,7 +156,9 @@ Parfois nous avons également besoin d'accéder à l'évènement original du DOM
 methods: {
   warn: function (message, event) {
     // maintenant nous avons accès à l'évènement natif
-    if (event) event.preventDefault()
+    if (event) {
+      event.preventDefault()
+    }
     alert(message)
   }
 }

src/v2/guide/events.md

@@ -36,7 +36,7 @@ ou :
 
 La page d'[installation](installation.html) vous offre d'autres manières d'installer Vue. Notez que nous **ne** recommandons **pas** aux débutants de commencer avec `vue-cli`, surtout si vous n'êtes pas encore familier avec les outils de *build* basés sur Node.js.
 
-Si vous préférez quelque chose de plus interactif, vous pouvez également consulter [cette série de tutoriels sur Scrimba](https://scrimba.com/playlist/pXKqta), ce qui vous donnera un mélange de démonstration visuelle et de jeu avec le code que vous pourrez mettre en pause à n'importe quel moment.
+Si vous préférez quelque chose de plus interactif, vous pouvez également consulter [cette série de tutoriels sur Scrimba](https://scrimba.com/g/gvuedocs), ce qui vous donnera un mélange de démonstration visuelle et de jeu avec le code que vous pourrez mettre en pause à n'importe quel moment.
 
 ## Rendu déclaratif