Etienne BAUDOUX

Vous souhaitez réagir à ce message ? Créez un compte en quelques clics ou connectez-vous pour continuer.
Etienne BAUDOUX

Forum sur les projets de Etienne BAUDOUX

-55%
Le deal à ne pas rater :
Friteuse sans huile – PHILIPS – Airfryer HD9200/90 Série 3000
49.99 € 109.99 €
Voir le deal

4 participants

    [Astuce] Bien rédiger ses tutoriels

    Szman
    Szman



    Masculin Nombre de messages : 1257
    Age : 24
    Localisation : 76230 Bois-Guillaume
    Emploi/loisirs : Code, musique, sport
    Humeur : Toujours heureux évidemment!
    Date d'inscription : 22/10/2011

    [Astuce] Bien rédiger ses tutoriels Empty [Astuce] Bien rédiger ses tutoriels

    Message par Szman Lun 13 Jan 2014 - 8:27

    Bonjour tout le monde Smile

    Aujourd'hui on va apprendre à faire un beau tuto bien rédigé et propre pour maximiser la compréhension et que ceux qui lisent comprennent les moindres détails Wink


    Tout d'abord, je dirai qu'il faut commencer par un petit sommaire (histoire de voir les catégories de votre tuto).

    Pour le mien, je mettrai:




    SOMMAIRE


    La mise en place du tuto;

    La rédaction;

    Les petits +;


    Et maintenant commençons ! Very Happy

    LA MISE EN PLACE DU TUTO:

    C'est bien d'avoir écrit un sommaire, mais maintenant il faut savoir quoi mettre dans chacune des catégories Smile
    Pour cela je vous propose de faire une petite liste des choses importantes dans un fichier txt, vous pourrez mieux vous y retrouver (remarquez que cette technique est aussi utile pendant un contrôle ou une épreuve si vous avez à faire un paragraphe).
    Énumérez toutes les idées dans une liste. Mais attention! Mettez les dans l'ordre, sinon votre tuto sera fouillis...


    LA RÉDACTION:

    Une fois que vous avez fini votre liste, il est temps de rédiger votre tuto. Pour cela, marquez toutes les idées que vous avez notés dans votre fichier txt, mais en les développant bien. Essayez de faire au moins 2/3 lignes par idée.
    Séparez les idées par un retour à la ligne + un tiret, ça fait propre Smile
    Marquez en gras et/ou souligné les titres et choses importantes.
    Quand vous avez fini, relisez vous bien et corrigez vos fautes d'orthographe et vos phrases qui n'ont aucun sens amusé


    LES PETITS PLUS:

    Votre tuto est bien fini, mais il manque encore quelques détails... Les voici! Very Happy

    - Mettez des screenshot pour améliorer la compréhension du tuto, et pour que les débutants sachent quoi faire et où le faire... La technique est de se mettre à la place du débutant qui ne connais rien. Montrez lui quoi faire, ne le laissez pas abandonner Wink
    - Mettez des smileys, ça donne de la vie au texte et c'est plus joyeux  cheers
    - Une fois encore je vous le répète: faites attention aux fautes d'orthographe! C'est très dérangeant de lire un texte bourré de fautes, voire marqué en langage sms...
    - Mettez de la couleur, ça fait joli  flower 
    - Si vous avez d'autres idées, partagez-les ! Wink


    Merci d'avoir lu Smile. J'espère que ça vous aidera Wink

    Cordialement,
    Softewarzatorman
    polien
    polien



    Masculin Nombre de messages : 3003
    Age : 28
    Localisation : Bouches du Rhones
    Emploi/loisirs : velo, informatique, électronique, robotique, modélisme feroviaire
    Humeur : Je commence tout mais ne finit rien :P
    Date d'inscription : 19/05/2011

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par polien Lun 13 Jan 2014 - 8:42

    Bonjour,

    je dirais même plus: faite attention à l'éditeur whysing du forum qui fait souvent des erreurs d'interprétation de synthaxe (s'est pour ça que le tuto contient des [/b] amusé)

    préférez l'éditeur classique avec balise Wink

    sinon s'est un bon tuto pour ceux qui veulent rédiger un tuto (justement amusé ) je rajoute au sommaire Wink
    fandeonepiece2
    fandeonepiece2
    Je suis là tous les jours
    Je suis là tous les jours


    Masculin Nombre de messages : 1804
    Age : 23
    Localisation : chez moi
    Emploi/loisirs : Programmation H24
    Humeur : massacrante... si je n'ai pas ma dose journalière de programmation
    Date d'inscription : 14/09/2013

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par fandeonepiece2 Lun 13 Jan 2014 - 15:50

    merci,
    c'est super sympa de ta part
    Szman
    Szman



    Masculin Nombre de messages : 1257
    Age : 24
    Localisation : 76230 Bois-Guillaume
    Emploi/loisirs : Code, musique, sport
    Humeur : Toujours heureux évidemment!
    Date d'inscription : 22/10/2011

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par Szman Lun 13 Jan 2014 - 16:40

    Re,

    merci a vous deux Wink

    C'est vrai que cet éditeur (de merd* >_<) a certains problèmes :/ Mais j'ai réussi à tout remettre sans "[/b]" et autres Razz

    Il était bien temps de le faire en même temps ce tuto amusé

    Premier de mes tutos dans le sommaire ! Very Happy

    Cordialement,
    Softewarzatorman

    EDIT: ah non c'est mon 3ème dans le sommaire Razz
    polien
    polien



    Masculin Nombre de messages : 3003
    Age : 28
    Localisation : Bouches du Rhones
    Emploi/loisirs : velo, informatique, électronique, robotique, modélisme feroviaire
    Humeur : Je commence tout mais ne finit rien :P
    Date d'inscription : 19/05/2011

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par polien Lun 13 Jan 2014 - 17:14

    re,

    il est excellent par rapport à l'éditeur de openclassroom: lui tu passe moins de temps à écrite tes messages en HTML Razz

    bon sinon quand on passe par les balises s'est plus fiable mais on s'y retrouve beaucoup moins, par exemple pour le sommaire:
    [Astuce] Bien rédiger ses tutoriels 2014-015
    fandeonepiece2
    fandeonepiece2
    Je suis là tous les jours
    Je suis là tous les jours


    Masculin Nombre de messages : 1804
    Age : 23
    Localisation : chez moi
    Emploi/loisirs : Programmation H24
    Humeur : massacrante... si je n'ai pas ma dose journalière de programmation
    Date d'inscription : 14/09/2013

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par fandeonepiece2 Lun 13 Jan 2014 - 17:29

    bonjour,
    sa va j'ai pas trop de bug a pars dans ma signature
    cordialement
    Szman
    Szman



    Masculin Nombre de messages : 1257
    Age : 24
    Localisation : 76230 Bois-Guillaume
    Emploi/loisirs : Code, musique, sport
    Humeur : Toujours heureux évidemment!
    Date d'inscription : 22/10/2011

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par Szman Lun 13 Jan 2014 - 17:50

    Re,

    j'aime bien celui de OCR, il bug pas Razz
    Mais ils ont mis une nouveau "style" quand tu écris du code dans un message/tuto et j'aime pas parce-que tu peux modifier le code aussi, et ça sert à rien Very Happy

    Cordialement,
    Softewarzatorman
    fandeonepiece2
    fandeonepiece2
    Je suis là tous les jours
    Je suis là tous les jours


    Masculin Nombre de messages : 1804
    Age : 23
    Localisation : chez moi
    Emploi/loisirs : Programmation H24
    Humeur : massacrante... si je n'ai pas ma dose journalière de programmation
    Date d'inscription : 14/09/2013

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par fandeonepiece2 Lun 13 Jan 2014 - 17:53

    bonjour,
    peut tu mettre une screen de celui de OCR ou me dire ou le trouver dans le site
    cordialement
    polien
    polien



    Masculin Nombre de messages : 3003
    Age : 28
    Localisation : Bouches du Rhones
    Emploi/loisirs : velo, informatique, électronique, robotique, modélisme feroviaire
    Humeur : Je commence tout mais ne finit rien :P
    Date d'inscription : 19/05/2011

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par polien Lun 13 Jan 2014 - 18:26

    softewarzatorman a écrit:Re,

    j'aime bien celui de OCR, il bug pas Razz
    Mais ils ont mis une nouveau "style" quand tu écris du code dans un message/tuto et j'aime pas parce-que tu peux modifier le code aussi, et ça sert à rien Very Happy

    Cordialement,
    Softewarzatorman

    si, il bug pour les paragraphes par exemple amusé
    perso j'ai été bannis du site donc je ne sais pas si ils ont améliorés le système (mais en parcourant les nouveaux post, sa se voit que rien n'a changé Razz )
    Szman
    Szman



    Masculin Nombre de messages : 1257
    Age : 24
    Localisation : 76230 Bois-Guillaume
    Emploi/loisirs : Code, musique, sport
    Humeur : Toujours heureux évidemment!
    Date d'inscription : 22/10/2011

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par Szman Lun 13 Jan 2014 - 19:45

    Re,

    @fandeonepiece2: désolé je peux pas te mettre de scren je suis sur mon portable amusé Essaye de créer un nouveau post Wink

    @Polien: comment t'as été banni? Razz. Bon c'est vrai que la communauté à pas trop changée mais j'aime bien regarder les projets des autres, et puis tous les membres ne sont pas ''mauvais'' (au niveau caractère Smile).

    Cordialement,
    Softewarzatorman
    lereparateurdepc
    lereparateurdepc



    Masculin Nombre de messages : 5622
    Age : 32
    Localisation : Calvados
    Emploi/loisirs : Electrotechnicien / électricité, HAUTE TENSION, électronique, informatique, automatisme , Arduino, bref le BRICOLAGE , ...
    Humeur : toujours cool
    Date d'inscription : 31/01/2010

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par lereparateurdepc Lun 13 Jan 2014 - 19:50

    re,

    Sympas ce tuto pour faire des tuto Smile

    Pour l'éditeur, j'en vais parlé à Admin peut de temps après mon inscription et l'erreur à été corrigée.
    Au début, on n'avait pas le choix, c'était directement du whysing comme dis Polien (visu directe); après mon signalement, plus le choix, éditeur classique avec les balise mais plus de problème.
    Depuis peut de temps, on à le choix mais ça plante toujours mais moins. Perso, je reste classique, maître des balises Smile.

    HS : Arduino c'est bien mais on tombe vite amoureux je ai déjà 5  Shocked  drunken  ............

    Cordialement,
    Le réparateur de PC
    polien
    polien



    Masculin Nombre de messages : 3003
    Age : 28
    Localisation : Bouches du Rhones
    Emploi/loisirs : velo, informatique, électronique, robotique, modélisme feroviaire
    Humeur : Je commence tout mais ne finit rien :P
    Date d'inscription : 19/05/2011

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par polien Lun 13 Jan 2014 - 20:01

    softewarzatorman a écrit:Re,

    @fandeonepiece2: désolé je peux pas te mettre de scren je suis sur mon portable amusé Essaye de créer un nouveau post Wink

    @Polien: comment t'as été banni? Razz. Bon c'est vrai que la communauté à pas trop changée mais j'aime bien regarder les projets des autres, et puis tous les membres ne sont pas ''mauvais'' (au niveau caractère Smile).

    Cordialement,
    Softewarzatorman
    s'est vrai qu'il n'y a pas que des gens mauvais, mais de manière générale les gens vont vers le sens de celui qui est "maître" du post même si il dit des c********
    du coup tu peut faire une remarque pertinente mais te faire quand même pourrir par les autres qui vont te prendre pour l'allumé de service.... bon, en même temps je me suis pas mal moqué d'un des créateurs du site de façon exagéré et les derniers moments où j'étais inscrit je ne faisait que troller... mais bon, déjà que les membres n'était pas très agréable auparavant, mais en plus avec l'aspect commercial que prend le site, ça ne me donne plus l'envie de me réinscrire (mais j'y consulte toujours les tutos Wink )

    lereparateurdepc a écrit:re,

    Sympas ce tuto pour faire des tuto Smile

    Pour l'éditeur, j'en vais parlé à Admin peut de temps après mon inscription et l'erreur à été corrigée.
    Au début, on n'avait pas le choix, c'était directement du whysing comme dis Polien (visu directe); après mon signalement, plus le choix, éditeur classique avec les balise mais plus de problème.
    Depuis peut de temps, on à le choix mais ça plante toujours mais moins. Perso, je reste classique, maître des balises Smile.

    HS : Arduino c'est bien mais on tombe vite amoureux je ai déjà 5  Shocked  drunken  ............

    Cordialement,
    Le réparateur de PC

    ouaip, les balises s'est le mieux Wink (même si il faut prendre une certaines habitude avec...)

    HS: "je ai déjà 5" euh... moi pas comprendre amusé
    mais s'est vrai que s'est vraiment sympa comme système Wink perso j'ai pas trop de temps en ce moment donc je ne fais que des trucs qui sont expliqués dans le guide...
    mais dès que je suis à la fac, je m'y met plus sérieusement Wink
    lereparateurdepc
    lereparateurdepc



    Masculin Nombre de messages : 5622
    Age : 32
    Localisation : Calvados
    Emploi/loisirs : Electrotechnicien / électricité, HAUTE TENSION, électronique, informatique, automatisme , Arduino, bref le BRICOLAGE , ...
    Humeur : toujours cool
    Date d'inscription : 31/01/2010

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par lereparateurdepc Lun 13 Jan 2014 - 20:10

    re,

    5 Arduino: 3 UNO et 2 Micro Smile J'ai une horloge en projet + d'autre...... (j'ai fait les achats en 2013 pour cause de TVA)

    Cordialement,
    Le réparateur de PC
    polien
    polien



    Masculin Nombre de messages : 3003
    Age : 28
    Localisation : Bouches du Rhones
    Emploi/loisirs : velo, informatique, électronique, robotique, modélisme feroviaire
    Humeur : Je commence tout mais ne finit rien :P
    Date d'inscription : 19/05/2011

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par polien Lun 13 Jan 2014 - 20:28

    lereparateurdepc a écrit:re,

    5 Arduino: 3 UNO et 2 Micro :)J'ai une horloge en projet + d'autre...... (j'ai fait les achats en 2013 pour cause de TVA)

    Cordialement,
    Le réparateur de PC
    re,

    ah ok !! ça commence à en faire 5 ^^
    fandeonepiece2
    fandeonepiece2
    Je suis là tous les jours
    Je suis là tous les jours


    Masculin Nombre de messages : 1804
    Age : 23
    Localisation : chez moi
    Emploi/loisirs : Programmation H24
    Humeur : massacrante... si je n'ai pas ma dose journalière de programmation
    Date d'inscription : 14/09/2013

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par fandeonepiece2 Lun 13 Jan 2014 - 20:52

    bonjour,
    en effet, j'ai hâte d'acheter la mienne
    cordialement
    Szman
    Szman



    Masculin Nombre de messages : 1257
    Age : 24
    Localisation : 76230 Bois-Guillaume
    Emploi/loisirs : Code, musique, sport
    Humeur : Toujours heureux évidemment!
    Date d'inscription : 22/10/2011

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par Szman Mar 14 Jan 2014 - 17:06

    Re,

    moi aussi je compte m'y mettre à Arduino Very Happy

    Sinon pour l'éditeur du fofo, c'est pas wysiwyg au lieu de whysing? Enfin je crois que ça veut dire "What You See Is What You Get" non? Smile

    Cordialement,
    Softewarzatorman
    lereparateurdepc
    lereparateurdepc



    Masculin Nombre de messages : 5622
    Age : 32
    Localisation : Calvados
    Emploi/loisirs : Electrotechnicien / électricité, HAUTE TENSION, électronique, informatique, automatisme , Arduino, bref le BRICOLAGE , ...
    Humeur : toujours cool
    Date d'inscription : 31/01/2010

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par lereparateurdepc Mar 14 Jan 2014 - 17:10

    re,

    Pour le whysing, j'ai suivis Polien car je connaissez pas son petit nom Smile

    Pour finir le HS : pour débuter, prend Arduino UNO et regarde aussi DfRobot Smile

    Cordialement,
    Le réparateur de PC
    polien
    polien



    Masculin Nombre de messages : 3003
    Age : 28
    Localisation : Bouches du Rhones
    Emploi/loisirs : velo, informatique, électronique, robotique, modélisme feroviaire
    Humeur : Je commence tout mais ne finit rien :P
    Date d'inscription : 19/05/2011

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par polien Mar 14 Jan 2014 - 17:51

    softewarzatorman a écrit:Re,

    moi aussi je compte m'y mettre à Arduino Very Happy

    Sinon pour l'éditeur du fofo, c'est pas wysiwyg au lieu de whysing? Enfin je crois que ça veut dire "What You See Is What You Get" non? Smile

    Cordialement,
    Softewarzatorman
    re,

    oui ça doit être ça... déjà que je suis mauvais en anglais, mais alors les abréviations anglaises... amusé
    fandeonepiece2
    fandeonepiece2
    Je suis là tous les jours
    Je suis là tous les jours


    Masculin Nombre de messages : 1804
    Age : 23
    Localisation : chez moi
    Emploi/loisirs : Programmation H24
    Humeur : massacrante... si je n'ai pas ma dose journalière de programmation
    Date d'inscription : 14/09/2013

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par fandeonepiece2 Mar 14 Jan 2014 - 18:06

    scratch 
    bonjour,
    faut que je m’achète un PC avant donc ce sera pas avant dans 1 an je pense donc j'ai le temps de réfléchir mais c'est une UNO que je voulais prendre
    cordialement
    polien
    polien



    Masculin Nombre de messages : 3003
    Age : 28
    Localisation : Bouches du Rhones
    Emploi/loisirs : velo, informatique, électronique, robotique, modélisme feroviaire
    Humeur : Je commence tout mais ne finit rien :P
    Date d'inscription : 19/05/2011

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par polien Mar 14 Jan 2014 - 18:28

    fandeonepiece2 a écrit:scratch 
    bonjour,
    faut que je m’achète un PC avant donc ce sera pas avant dans 1 an je pense donc j'ai le temps de réfléchir mais c'est une UNO que je voulais prendre
    cordialement
    ben? tu n'utilise pas un pc en ce moment pour écrire? lol (oui je sais, là question qui tue amusé)
    sinon se serait, en effet bien adapté pour un jeune dynamique comme toi Wink ça permet à la fois d'apprendre les bases de l'informatiques et de l'èlectronique
    sans pour autant griller les composants amusé
    fandeonepiece2
    fandeonepiece2
    Je suis là tous les jours
    Je suis là tous les jours


    Masculin Nombre de messages : 1804
    Age : 23
    Localisation : chez moi
    Emploi/loisirs : Programmation H24
    Humeur : massacrante... si je n'ai pas ma dose journalière de programmation
    Date d'inscription : 14/09/2013

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par fandeonepiece2 Mar 14 Jan 2014 - 18:39

    bonjour,
    il y a pas longtemps j'avais fait un circuit permettant de faire des arc électrique de 2mm avec du 12 V continu / 1.5 A en source mais j'ai cramé les diodes (de recupération  Very Happy ) de mon circuit Razz 
    cordialement
    lereparateurdepc
    lereparateurdepc



    Masculin Nombre de messages : 5622
    Age : 32
    Localisation : Calvados
    Emploi/loisirs : Electrotechnicien / électricité, HAUTE TENSION, électronique, informatique, automatisme , Arduino, bref le BRICOLAGE , ...
    Humeur : toujours cool
    Date d'inscription : 31/01/2010

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par lereparateurdepc Mar 14 Jan 2014 - 19:02

    re,

    Pour la THT (HTA/HTB) et les arcs, va sur mon site dans les images (vers la fin).
    En MP, peux-tu me donner les schémas, la réf des diodes,..... stp

    Cordialement,
    Le réparateur de PC
    fandeonepiece2
    fandeonepiece2
    Je suis là tous les jours
    Je suis là tous les jours


    Masculin Nombre de messages : 1804
    Age : 23
    Localisation : chez moi
    Emploi/loisirs : Programmation H24
    Humeur : massacrante... si je n'ai pas ma dose journalière de programmation
    Date d'inscription : 14/09/2013

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par fandeonepiece2 Mar 14 Jan 2014 - 20:14

    bonjour,
    je peux te donner le schéma mais tu ne pourra pas le reproduire
    les diodes sont ... 
    à la poubelle (vu qu'elles sont foutu) Rolling Eyes 
    cordialement
    lereparateurdepc
    lereparateurdepc



    Masculin Nombre de messages : 5622
    Age : 32
    Localisation : Calvados
    Emploi/loisirs : Electrotechnicien / électricité, HAUTE TENSION, électronique, informatique, automatisme , Arduino, bref le BRICOLAGE , ...
    Humeur : toujours cool
    Date d'inscription : 31/01/2010

    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par lereparateurdepc Mar 14 Jan 2014 - 20:17

    re,

    Une diode est une diode faut la redimensionner en fonction de la tension inverse (VRRM) et l'intensité.
    Comment sais-tu qu'elle sont HS ?

    STP, continu le sujet en MP Smile

    Cordialement,
    Le réparateur de PC

    Contenu sponsorisé


    [Astuce] Bien rédiger ses tutoriels Empty Re: [Astuce] Bien rédiger ses tutoriels

    Message par Contenu sponsorisé


      La date/heure actuelle est Jeu 21 Nov 2024 - 21:41