[Période de relecture] Automne 2012

Bonjour,

Cette discussion explique le fonctionnement de la relecture des FAQ JavaScript au sens large. Le but étant de :

  • lister ce qui est devenu faux/obsolète ;
  • corriger les éventuelles coquilles ;
  • compléter les Q/R existantes avec les nouveautés ;
  • ajouter des Q/R et des pages d'exemples.


Comme vous allez le constater, la FAQ JavaScript a été créée il y a longtemps et certaines Q/R n'ont pas été adaptées. Les FAQ Frameworks sont plus récentes mais l'évolution des frameworks est cependant plus rapide.

Pour commencer, nous allons nous diviser la tâche selon le découpage en sections des FAQ. A côté de chaque section apparaissent en vert les pseudos des membres s'étant proposés pour la section. En gris apparaissent les sections relues.

1. JavaScript

  1. Informations générales - vermine
  2. Introduction
  3. Syntaxe JavaScript - ctrii
  4. Les tableaux (l'objet Array) - Watilin
  5. La gestion des dates (l'objet Date) - Auteur
  6. La détection des événements - Watilin
  7. La gestion des fenêtres et des frames - headmax
  8. La navigation et le navigateur - headmax
  9. Les formulaires - Auteur, NoSmoking
  10. Les tableaux (balise table) - Auteur
  11. Les feuilles de style - headmax
  12. Les expressions régulières - Watilin
  13. Les autres objets - headmax
  14. Utilisation du DOM - Watilin
  15. Les technologies d'Ajax - Golgotha
  16. Divers scripts utiles - dragonno


2. jQuery

  1. Informations générales - vermine
  2. Introduction - bipbip2006
  3. Utilisation du DOM - headmax
  4. Les formulaires - bipbip2006
  5. La gestion des évènements - Golgotha
  6. Requête Ajax - Golgotha
  7. Les objets - headmax
  8. Plugins - bipbip2006
  9. Divers scripts utiles


3. MooTools

  1. Informations générales - vermine
  2. Introduction - vermine
  3. Les objets - vermine
  4. La gestion des évènements - vermine
  5. Les nombres - vermine
  6. Les chaines de caractères - vermine
  7. Les tableaux - vermine
  8. La navigation et le navigateur - vermine
  9. Formulaires HTML et autres objets
    • Les champs des formulaires - vermine
    • Les effets visuels - vermine
    • Les autres objets - vermine
  11. Utilisation du DOM - vermine
  12. Divers scripts utiles - vermine


4. ExtJS / Sencha

  1. Informations générales - vermine
  2. Introduction
  3. Utiliser Ext-JS
  4. Modèles de conception et de développement
  5. Organisation du framework
  6. Gestion des événements


5. Google Maps

  1. Informations générales - vermine
  2. Introduction - NoSmoking
  3. Les cartes - undead001
  4. Les markers - undead001
  5. Les InfoWindows - NoSmoking


a. Chacun précise dans cette discussion la section sur laquelle il désire travailler. Essayez de ne pas être plus de trois personnes sur une même section. Et si vous êtes trois, redivisez-vous la section.


b. En cours de relecture, si vous détectez une modification à faire dans une Q/R (voir la liste ci-dessus des modifications attendues), ouvrez une discussion avec le nom de la Q/R et le préfixe FAQ :

[FAQ] Qu'est-ce que le JavaScript ?
En première ligne de la discussion, recopiez le titre de la Q/R avec son lien :

Qu'est-ce que le JavaScript ?
Ensuite, exposez brièvement vos modifications, puis remettez la nouvelle version de la Q/R dans son intégralité (avec la mise en forme) dans des balises [ quote ].


c. Je rajouterai alors le tag [A relire] pour attirer l'attention des autres membres. Chacun peut relire la correction proposée et le notifie dans la même discussion.
Lorsque vous estimez que la Q/R est maintenant en ordre, vous taguez la discussion en [Résolu].

Rem : il n'est nullement question de supprimer une Q/R ou bien d'en supprimer son contenu actuel. Pour tout ce qui est obsolète ou dépassé, la Q/R devra simplement le signaler avec le tag proposé par Auteur :

Citation Envoyé par Auteur
Une Q/R de la FAQ avec contenu obsolète devrait porter un tag [Obsolète].

Si cette question est obsolète mais possède une méthode à jour, on devrait écrire la nouvelle méthode puis en dessous, avec une mise en évidence particulière, l'ancienne méthode avec le tag [Obsolète].

d. Lors de vos relectures, n'hésitez pas à faire une remarque quant à l'emplacement de la Q/R et la structure de la FAQ. Par exemple, à l'origine la FAQ Google Maps était la FAQ API Google. Plus maintenant. On pourra donc remettre au niveau principal les sections cartes, markers et InfoWindows. De son côté, jQuery est divisé en plusieurs parties (AJAX, UI, mobile, plugins). Ca ne transparait pas forcément dans la FAQ. Une question pourrait être déplacée dans une autre section pour plus de pertinence. Des liens entre des Q/R peuvent être fait "Lire aussi... ". Soyez donc attentifs à ce genre de détails de présentation.


e. Une fois la relecture de votre section finie (les discussions étant alors résolues), signalez-le dans la discussion principale. Vous pouvez alors choisir une nouvelle section à relire.