Pour répondre à la question première du topic et pas sur la forme, queqlues conseils sur le contenu. Si ç'est hors propos, ou si ça soule, et bien... ne pas lire le post.
En fait, pour avoir fait pas mal de tutos dans ma boîte (on appelle ça des procédures), je peux donner quatre approches pour faire un tuto.
1. L'approche productive
2. L'approche didactique
3. L'aproche vue macro
4. l'approche scolaire
L'approche productive a pour but de donner les étapes nécessaires et suffisantes pour arriver à un but précis. Dans le genre d'une recette de cuisine quoi. C'est particulièrement adapté quand le lecteur veut arriver à un resultat en se contrefoutant de comprendre pourquoi on le fait. Pour créer ce genre de tuto le premier truc a faire est de se poser la question "quel but je dois atteindre". Ensuite le mieux est de faire ce qu'il y a a faire en le notant au fur et à mesure.
Un formalisme qui peut aller avec ça est un titre "comment jouer à un jeu mame avec gamex", puis de décrire successivement, complètement et inconditionnellement toutes les étapes à réaliser; les captures d'écran sont un grand atout. Un minimum de pré-requi doivent être nécessaires (les pré-requis sont les connaissance que le ecteur doit avoir pour faire le truc) en gros il faut qu'un demeuré puisse dérouler le truc. C'est pas un manque de respect du tout, c'est pour que ce soit efficace et lu par tous. par exemple pré-requis : savoir cliquer, allumer un ecran et un ordinateur...
Si tu veux faire vraiment pro tu peux faire un tableau dans ce goût là:
ACTION - RESULTAT ATTENDU - EN CAS DE PROBLEME
double cliquer sur install.exe - écran d'accueil - verifier que vous avez téléchargé gamex
cliquer sur suivant - affichage ecran de licence - vérifier que la souris est branchée
Le genre de truc qu'on trouve dans une notice parexemple. Bon, ce gere de truc, je sais pas si c'est adapté à planetemu mais tu as saisi l'idée. l'approche productive est par exemple un excellent complément à l'approche didactique:
http://planetemu.net/php/vbulletin/s...121#post175121
Ou une réponse à une question de profane :
http://planetemu.net/php/vbulletin/s...ad.php?t=11434
L'approche didactique doit contenir l'approche productive mais en plus expliquer le pourquoi du comment. Cela confère par la suite une plus grande autonomie à celui qui l'aura intégrée. Du genre "dans affichage choisissez Open GL. En effet, le choix du mode d'affichage s'appuie sur des composants logiciel d'affichage qui ne sont pas les mêmes selon les cartes videos et les systemes. DirectX ne sont pas disponiblse sur linux et qui ne sont pas les mêmes sur vista et xp. (voir
http://microsoft.pl/directXkesskeucè pour plus de renseignements). En outre l'affichage opengl est plus optimisé pour bla bla bla... alors que directX peut faire bli bli bli..."
A l'issue de l'intégration de la procédure on peut s'attendre à ce que le lecteur maîtrise mieux le bazar et aille plus loin tout seul. On doit se poser comme question "quel est le resultat attendu et que doit savoir le formé au final" en amont. Mais bon les pré-requis sont plus élevés dans ce genre de cas, c'est plus long a faire et dans l'optique "j'installe mon émulateur et je veux jouer" je sais pas si c'est vraiment ça qu'il faut, j'en ai jamais fait sur planet en tout cas.
L'approche macro s'adresse déjà à des experts et s'apparente plus à de l'information qu'a une réelle formation.
exemple : "Pour installer la nouvelle version de Gamex, faites comme d'habitude, mais cette fois choisissez le mode de hachage 64 bits pour aller avec votre processeur le cas échéant". Ou la résolution d'un cas particulier posant problème
http://planetemu.net/php/vbulletin/s...ad.php?t=11417 ou
http://planetemu.net/php/vbulletin/s...759#post177759 Mais bon c'est pas un "tuto", on explique pas tout, on informe ou on répond à une question de connaisseurs.
Dans tout les cas avant de mettre un truc en ligne je conseille de la tester. C'est a dire de la faire dérouler par un profane (votre petite soeur de 11 ans par exemple, ou votre voisin de 87 balais) ou un expert selon le type de formation pour voir s'il s'en sort. C'est le test qui ne trompe pas. Quand vous voyez qu'il rame, c'est que votre tuto n'est pas clair.
Si vous voulez j'ai des docs assez avancé sur "être formateur et rédiger des procédures". Mais encore une fois, je sais pas si c'est la peine de mettre la barre hyper haut pour un tuto planet. Genre normaliser les procédures pour que quelle qu'elle soit le lecteur ne perde pas de temps à rentrer dans le document...
La quatrième ? ah oui c'est vrai... et bien c'est l'
approche scolaire : on veut faire apprendre des trucs contre la volonté, on assoit son autorité puis on profite d'une relation dominant / dominé.
On pratique immodérement :
- l'apprentissage par coeur,
- les passages au tableau pour mettre le formé en mode de stress devant tout le monde,
- l'évaluation constante du formé pour garder la pression,
- des examens d'aptitude (controle / interro) et mise en concurrence (concours),
- l'interdiction de la contradiction avec le contenu du cours...
Le credo est "la répétition est la clé de l'apprentissage" et on fustige ceux qui ont du mal sans jamais se remttre en question sur l'adaptabilité du contenu du cours. Afin d'encourager l'émulation (pas celle de machines) on félicite les meilleurs. Bon j'arrête, je vais vomir
Pardon si des membres du corps enseignant sont outré mais je suis en profond désaccord avec l'approche française de la chose (bien différente de l'approche allemande, de l'approche socratique de l'enseignement ou de l'approche formation pro par exemple)