Discussion :

[vermine]

[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
10. • 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 :

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.

[Golgotha]

Bonjour,

Je peut aussi travailler sur :

jQuery

5- La gestion des évènements
6- Requête Ajax

vermine : notifié.

[Auteur]

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 : "Avant, on faisait ainsi, maintenant on procède comme ceci."

Je sais que c'est un peu tôt pour ma remarque var elle concerne la mise en page des Q/R dans la FAQ , mais comme je ne veux pas oublié ma suggestion je me permets de la proposer ici.

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

vermine : remarque prise en compte, merci.


Je vais relire la FAQ et vous indiquerai sur quoi je peux travailler. D'ores et déjà je peux vous dire que je ne pourrai pas faire les bibliothèques JS car je ne les ai jamais manipulées.

[vermine]

Bonjour,
Pour commencer, j'aimerais relire "La Syntaxe JavaScript".
Plus tard, si tout va bien, ce sera sûrement les dates, les expressions régulières, les autres objets, les formulaires, etc. (Toujours dans la section JavaScript).
Je vais déjà commencer par la syntaxe.
Merci.

Notifié pour la syntaxe dans un premier temps.

[Auteur]

Gestion des dates et la balise table pour moi

vermine : notifié.

[bipbip2006]

Bonjour,
Je souhaiterai pour ma part prendre l'intro, les formulaires et les pugins sur Jquery.

vermine : notifié, les trois pour jQuery.

[sekaijin]

Je vais essayer de dégager un peu de temps pour clarifier les choses entre
javascript, ECMAScript, jscript, actionSctript,
javascript dans et hors du navigateur
qui normalise quoi
quelle relation entre javascript et JSON

Il me semble que j'avais fais un petit topos sur common-js, et autres

je ne vous garanti rien car je suis débordé.
A+JYT

vermine : parfait, merci. Tout ce que tu auras le temps de faire sera le bienvenu.

[Invité]

à part ça pas de problème pour moi, toute aide est la bienvenue.

Je t'avais mis un MP, mais il faut que tu sache que même "pro" de la programmation je ne le suis pas dans votre méthode de travail.
Veux-tu que nous communiquions par MP ou mieux par mail ?

Dis-moi ça par MP, si besoin je te mettrais mon adresse mail.

Si tu peux me préciser un point , j'ai téléchargé tout JavaScript du lien donné par Vermine, comme c'est très bien fait je lis tout, même si je connais en partie ... il y a toujours matière a apprendre
Alors, dis-moi quelle partie tu aimerais que "j'épluche à fond"

Amitiées
Christele

[Auteur]

Cela dépend de toi si j'ose dire. Du temps que tu peux consacrer, et dans quel domaine tu es le plus à l'aise. On ne va pas de te demander de relire une FAQ matlab si tu ne connais pas le langage

[Invité]

Cela dépend de toi si j'ose dire. Du temps que tu peux consacrer, et dans quel domaine, tu es le plus à l'aise. On ne va pas de te demander de relire une FAQ matlab si tu ne connais pas le langage

Merci de ta réponse, j'ai du temps (enfin un peut ) mon problème est simple, j'aurais aimé à titre d'exemple (conclusion ?) de ton superbe ToPo
l'inclure dans un AJAX de manipulation des tableaux, pour les parties que tu as développées.

Tu m'as dit que tu étais partant, et je suis parti tête baissée avec ce plan:

1) lire à fond ton topo (3 semaines ?)
2) l'introduire dans un ajax (1 semaine)
3) aller^plus loin.... ????

Je ne publierais rien, mais t'enverrais au fur et à mesure mes "travaux "

Pour moi c'est clair, mais cela passera forcément par des échanges à ton choix par MP ou par mail, comme pour Golgotha pour le deuxième sujet.

Par contre tu as vu que Vermine m'a demandé si j'acceptais de faire de la relecture (insistant sur AJAX ... objet de mon premier article) et c'est a ce sujet que devant la masse de ce qui est déjà fait, je demande
quel module en particulier vermine et donc Golgotha souhaiterait que je pioche, j'y suis prete, mais il faut me guider.

Bien Amicalement
Christele

[vermine]

Toute la partie AJAX.

Goglotha, merci de préciser à Christele les points qu'elle peut attaquer.

[dragonno]

Je peux de temps en temps m'occuper de la partie : "divers scripts utiles".

vermine : notifié, merci !