« Discussion:Wikilivres » : différence entre les versions

Contenu supprimé Contenu ajouté
Appel à témoignages pour les anciens du projet
 
Ligne 4 :
 
[[Utilisateur:Sub|Sub]] 6 juillet 2008 à 14:27 (CEST)
 
: Sub m'ayant passé de la pommade dans le dos, je me sens obligé de témoigner.
: Euh, de quoi en fait ? Je n'ai rien de particulier à dire à propos de WikiBooks, ou plutôt de [[w:MediaWiki|MediaWiki]]qui n'est qu'un outil. De manière générale, j'aborde la rédaction technique de la manière suivante (cela ne s'adapte pas forcément à tous les cas) :
:* avoir une introduction assez courte et très généraliste, qui permette de cadrer tout de suite le sujet (de quoi ça parle, d'où ça vient, comment ça s'insert dans le domaine plus général auquel le sujet appartient), bref, ce que l'on apprend en cours de français…
:* séparer l'ouvrage en trois parties (inspiré par les deux manuels de ma HP 28 S…) :
:*# une partie procédurale : on identifie ce qui intéresse le plus la plupart des utilisateurs, et on fait du « pas à pas », en s'appuyant sur un exemple concret (didacticiel) ; cela permet à un débutant de prendre en main tout de suite le sujet, de mettre le pied à l'étrier, d'encourager en permettant d'avoir tout de suite des résultats concrets,
:*# une partie théorique : on explique le fond des choses, ce qui permet de comprendre ce que l'on fait et donc participe à la mémorisation,
:*# une partie plus exhaustive où l'on détaille plein de cas particuliers, assortie d'un ou plusieurs index permettant de ne pas avoir à tout lire pour trouver ce qui nous intéresse (voir par exemple les index de LaTeX [[[Programmation LaTeX/Index|1]]], [[[Programmation LaTeX/COmmandes|2]]], ou l'index de Scilab [[[Découvrir Scilab/Index|3]]]) ;
:* faire plutôt des phrases courtes, utiliser du vocabulaire généraliste en évitant les anglicismes lorsque c'est possible (mais indiquer entre parenthèses le vocabulaire spécialisé ou l'anglicisme courant) ;
:* faire des liens croisés entre les différentes pages, ne pas hésiter à répéter une information présente sur une autre page pour éviter d'avoir à naviguer et ne pas perdre le fil ;
:* illustrer le plus possible : prévoir des schémas de principes, simplifiés et clairs, permettant d'avoir une bonne vue générale et d'identifier tout de suite de quoi on parle, associés à des photographies ou schémas plus complexes qui permettent de voir ce dont on parle réellement, comment ce dont on parle s'intègre dans le système réel ;
:* repenser aux difficultés que l'on a eues lorsque l'on était débutant pour appuyer sur ces difficultés — en fait, j'ai écris certains Wikilivres en étant moi-même en phase d'apprentissage (par exemple ''[[Scilab]]''), ce qui permet de découvrir le sujet par le menu et de se confronter à des problèmes réels.
: Euh, et plein d'autres choses sans doute…
: [[Utilisateur:Cdang|Cdang]] 5 août 2008 à 09:08 (CEST)
Revenir à la page « Wikilivres ».