Comment/Pourquoi écrire des astuces

(ou mini howtos) ?

(Écrit en orthographe recommandée. Voir note en bas de page)



Il suffit d'être très fort. D'être un gourou. Mais non, je plaisante. Il suffit d'en avoir envie et d'y consacrer un peu de temps. Quel que soit votre niveau.

Vous vous dites : " Ça ne servirait à rien, je suis trop débutant". Mais au contraire ! On a besoin de documentations de tous niveaux. Pour les gourous, les pros, les confirmés, mais aussi les débutants. Et on oublie trop souvent qu'un jour on a tous été débutants. Et ainsi on oublie ou on omet des détails parce qu'ils nous paraissent superflus, qu'il nous semble inutile d'enfoncer des portes ouvertes. Et pourtant, ils seraient tellement utiles aux débutants ces fichus détails qui nous semblent tellement évidents qu'on en oublie de les mentionner.

Voilà pourquoi OUI il faut que des débutants écrivent ce genre de documentation (et les mettent sur leur site personnel bien sûr).

Bref, vous voulez écrire un howto pour aider les autres. Comment faire ? Je n'ai pas de recettes miracles. Voilà à quelles occasions j'ai écrit mes propres astuces :

Première cas : j'ai eu envie comme ça, d'un coup, d'écrire sur un sujet que je connaissais un peu en me disant "ça va aider les autres". Eh bien si ça vous arrive, allez-y !

Deuxième cas : j'ai eu l'occasion de dépanner quelqu'un par mail et j'ai remis les courriers en forme pour faire quelque chose de présentable. (C'est bien commode parce qu'on a toutes les notes pour le faire).

Troisième cas : j'ai trouvé tout seul comme un grand (ou presque) la solution à un problème que j'ai eu (ou une panne). J'en profite pour prendre des notes et mettre tout en forme (il vaut mieux le faire de suite tant que c'est chaud, parce qu'après on oublie et c'est plus dur.
À vous d'essayer maintenant ;-)

Cet article est soumis à la licence LGPL. Vous pouvez le copier et le diffuser comme bon vous semble à condition de ne pas l'altérer et de laisser intacte la présente notice. Il a été écrit avec l'aide de plusieurs membres de la communauté du logiciel libre que je remercie au passage.


Des erreurs, des suggestions ? écrivez-moi. Voir mon adresse ici http://astuce.linux.free.fr/index.html


Mis à jour le 10 mars 2006 Claude MICOUIN


logo orthographe recommandée


N.B. L'Académie française a approuvé à l'unanimité un certain nombre de rectifications.
Ces rectifications sont désormais inscrites dans les programmes du ministère français de l'éducation nationale (BO n°5 du 12 avril 2007).
Pour en savoir plus http://www.orthographe-recommandee.info/

Attention ! Ces rectifications ne sont PAS de simples tolérances, mais fixent la NOUVELLE orthographe de certains mots.