From 6da70c8b0d676a93cb4456f23a264778461c862d Mon Sep 17 00:00:00 2001 From: sylvainpolletvillard Date: Sun, 5 Feb 2017 17:47:33 +0100 Subject: [PATCH 1/3] cookbook/index.md --- src/v2/cookbook/index.md | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/src/v2/cookbook/index.md b/src/v2/cookbook/index.md index 1b6f4bf153..571c172fb8 100644 --- a/src/v2/cookbook/index.md +++ b/src/v2/cookbook/index.md @@ -4,39 +4,39 @@ type: cookbook order: 0 --- -## WORK IN PROGRESS +## TRAVAIL EN COURS -

**Cette page est en cours de traduction française. Revenez une autre fois pour lire une traduction achevée ou [participez à la traduction française ici](https://github.com/vuejs-fr/vuejs.org).**

This cookbook is still in its very early stages. At this point, we will not be linking to it from anywhere else. Pages may be removed or reorganized at any time. Even the goals and overall format are still in flux.

+Ce livre de recettes (*cookbook*) en est encore à ses tout débuts. À ce stade, nous ne mettrons nulle part un lien vers celui-ci. Des pages peuvent être supprimées ou réorganisées à tout moment. Même les objectifs et le format global sont encore en mouvement.

-## The Cookbook vs the Guide +## Le *cookbook* versus le guide -How is the cookbook different from the guide? Why is this necessary? +En quoi le *cookbook* est-il différent du guide ? Pourquoi est-ce nécessaire ? -- __Greater Focus__: In the guide, we're essentially telling a story. Each section builds on and assumes knowledge from each previous section. In the cookbook, each recipe can and should stand on its own. This means recipes can focus on one specific aspect of Vue, rather than having to give a general overview. +- __Plus focalisé__ : Dans le guide, nous racontons essentiellement une histoire. Chaque section se construit sur la base des précédentes et présume la connaissance de celles-ci. Dans le *cookbook*, chaque recette peut et devrait se suffire à elle-même. Cela signifie que les recettes peuvent se focaliser sur un aspect spécifique de Vue, plutôt que d'avoir à donner un aperçu global. -- __Greater Depth__: To avoid making the guide too long, we try to include only the simplest possible examples to help you understand each feature. Then we move on. In the cookbook, we can include more complex examples, combining features in interesting ways. Each recipe can also be as long and detailed as it needs to be, in order to fully explore its niche. +- __Plus de profondeur__ : Pour éviter de rendre le guide trop long, nous essayons d'inclure seulement les exemples les plus simples possibles pour vous aider à comprendre chaque fonctionnalité. Puis nous passons à autre chose. Dans le *cookbook*, nous pouvons inclure des exemples plus complexes, combinant les fonctionnalités de façon intéressante. Chaque recette peut être aussi longue et détaillée que besoin, afin de pleinement explorer son sujet. -- __Teaching JavaScript__: In the guide, we assume at least intermediate familiarity with ES5 JavaScript. For example, we won't explain how `Array.prototype.filter` works in a computed property that filters a list. In the cookbook however, essential JavaScript features (including ES6/2015+) can be explored and explained in the context of how they help us build better Vue applications. +- __Enseigner JavaScript__ : Dans le guide, nous supposons que le lecteur est au moins moyennement familier avec la norme ES5 de JavaScript. Par exemple, nous n'expliquerons pas comment `Array.prototype.filter` fonctionne au sein d'une propriété calculée qui filtre une liste. Dans le *cookbook* en revanche, des fonctionnalités essentielles de JavaScript (y-compris ES6/2015+) peuvent être explorées et expliquées avec comme contexte, comment elles nous aident à construire de meilleures applications Vue. -- __Exploring the Ecosystem__: For advanced features, we assume some ecosystem knowledge. For example, if you want to use single-file components in Webpack, we don't explain how to configure the non-Vue parts of the Webpack config. In the cookbook, we have the space to explore these ecosystem libraries in more depth - at least to the extent that is universally useful for Vue developers. +- __Explorer l'écosystème__ : Pour les fonctionnalités avancées, nous supposons que le lecteur a quelques connaissances sur l'écosystème. Par exemple, si vous voulez utiliser des composants monofichiers avec Webpack, nous n'expliquerons pas comment configurer les parties qui ne concernent pas Vue dans la configuration de Webpack. Dans le *cookbook*, nous avons l'espace suffisant pour explorer plus en profondeur ces bibliothèques de l'écosystème - au moins dans la mesure où cela est universellement utile aux développeurs Vue. -## Guidelines for Recipes +## Lignes directrices pour les recettes -Recipes should generally: +Les recettes doivent généralement : -> 1. Solve a specific, common problem +> 1. Résoudre un problème spécifique et commun -> 2. Start with the simplest possible example +> 2. Commencer avec l'exemple le plus simple possible -> 3. Introduce complexities one at a time +> 3. Introduire les complexités une à la fois -> 4. Link to other docs, rather than re-explaining concepts +> 4. Comporter des liens vers d'autres sections de la documentation, plutôt que de réexpliquer les concepts -> 5. Describe the problem, rather than assuming familiarity +> 5. Décrire le problème plutôt que de supposer que le lecteur est familier avec -> 6. Explain the process, rather than just the end result +> 6. Expliquer le processus au delà du simple résultat final -> 7. Explain the pros and cons of your strategy, including when it is and isn't appropriate +> 7. Expliquer le pour et le contre de votre approche, en indiquant dans quels cas elle est apropriée ou non -> 8. Mention alternative solutions, if relevant, but leave in-depth explorations to a separate recipe +> 8. Mentionner des solutions alternatives si c'est pertinent, mais garder les explications en profondeur pour une autre recette. From c1e8f22b7dd8b295b0f3f92ae8ebaaa8ae9f5986 Mon Sep 17 00:00:00 2001 From: sylvainpolletvillard Date: Sat, 14 Jan 2017 18:18:28 +0100 Subject: [PATCH 2/3] revert gitignore (cherry picked from commit ec5b7c0) --- .gitignore | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/.gitignore b/.gitignore index 636fcecefb..7c13a2dbcd 100644 --- a/.gitignore +++ b/.gitignore @@ -1,9 +1,8 @@ .DS_Store Thumbs.db -.idea db.json *.log node_modules/ public/ .deploy*/ -src/_drafts \ No newline at end of file +src/_drafts From acaa4be2c6e588890c9854b778907d94e09758ac Mon Sep 17 00:00:00 2001 From: sylvainpolletvillard Date: Tue, 7 Feb 2017 23:11:57 +0100 Subject: [PATCH 3/3] retours PR --- src/v2/cookbook/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/v2/cookbook/index.md b/src/v2/cookbook/index.md index 571c172fb8..633f81143e 100644 --- a/src/v2/cookbook/index.md +++ b/src/v2/cookbook/index.md @@ -16,7 +16,7 @@ En quoi le *cookbook* est-il différent du guide ? Pourquoi est-ce nécessaire ? - __Plus de profondeur__ : Pour éviter de rendre le guide trop long, nous essayons d'inclure seulement les exemples les plus simples possibles pour vous aider à comprendre chaque fonctionnalité. Puis nous passons à autre chose. Dans le *cookbook*, nous pouvons inclure des exemples plus complexes, combinant les fonctionnalités de façon intéressante. Chaque recette peut être aussi longue et détaillée que besoin, afin de pleinement explorer son sujet. -- __Enseigner JavaScript__ : Dans le guide, nous supposons que le lecteur est au moins moyennement familier avec la norme ES5 de JavaScript. Par exemple, nous n'expliquerons pas comment `Array.prototype.filter` fonctionne au sein d'une propriété calculée qui filtre une liste. Dans le *cookbook* en revanche, des fonctionnalités essentielles de JavaScript (y-compris ES6/2015+) peuvent être explorées et expliquées avec comme contexte, comment elles nous aident à construire de meilleures applications Vue. +- __Enseigner JavaScript__ : Dans le guide, nous supposons que le lecteur est au moins moyennement familier avec la norme ES5 de JavaScript. Par exemple, nous n'expliquerons pas comment `Array.prototype.filter` fonctionne au sein d'une propriété calculée qui filtre une liste. Dans le *cookbook* en revanche, des fonctionnalités essentielles de JavaScript (y-compris ES6/2015+) peuvent être explorées et expliquées pour montrer comment elles nous aident à construire de meilleures applications Vue. - __Explorer l'écosystème__ : Pour les fonctionnalités avancées, nous supposons que le lecteur a quelques connaissances sur l'écosystème. Par exemple, si vous voulez utiliser des composants monofichiers avec Webpack, nous n'expliquerons pas comment configurer les parties qui ne concernent pas Vue dans la configuration de Webpack. Dans le *cookbook*, nous avons l'espace suffisant pour explorer plus en profondeur ces bibliothèques de l'écosystème - au moins dans la mesure où cela est universellement utile aux développeurs Vue. @@ -28,7 +28,7 @@ Les recettes doivent généralement : > 2. Commencer avec l'exemple le plus simple possible -> 3. Introduire les complexités une à la fois +> 3. Introduire une complexité à la fois > 4. Comporter des liens vers d'autres sections de la documentation, plutôt que de réexpliquer les concepts