Skip to content

Latest commit

 

History

History
42 lines (23 loc) · 3.05 KB

index.md

File metadata and controls

42 lines (23 loc) · 3.05 KB
title type order
Introduction
cookbook
0

TRAVAIL EN COURS

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.

Le cookbook versus le guide

En quoi le cookbook est-il différent du guide ? Pourquoi est-ce nécessaire ?

  • 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.

  • 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.

  • 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.

Lignes directrices pour les recettes

Les recettes doivent généralement :

  1. Résoudre un problème spécifique et commun
  1. Commencer avec l'exemple le plus simple possible
  1. Introduire les complexités une à la fois
  1. Comporter des liens vers d'autres sections de la documentation, plutôt que de réexpliquer les concepts
  1. Décrire le problème plutôt que de supposer que le lecteur est familier avec
  1. Expliquer le processus au delà du simple résultat final
  1. Expliquer le pour et le contre de votre approche, en indiquant dans quels cas elle est apropriée ou non
  1. Mentionner des solutions alternatives si c'est pertinent, mais garder les explications en profondeur pour une autre recette.