QQOQCCPSS !? le plan de mes tutoriels

QQOQCCPS

Alors QQOQCCPSS : kezako ?

D’abord, « normalement »,  vous connaissez déjà le très connu « QQOQCCP » sans les « S » donc…

– Quoi ?? vous connaissez pas !?…Pffff 😛
– En résumé, c’est une méthode d’analyse utilisable dans beaucoup de domaines, dont le but est de faire le tour du sujet  en 7 questions « Qui ? Quoi ? Où ? Quand ? Comment ? Combien ? Pourquoi ? »… pour plus d’informations, Wiki est ton ami (1.) 😉

Bref, voila la base que j’ai revu à ma façon pour:

  • Structurer mes tutoriels
  • Traiter correctement le sujet en oubliant rien
  • Donner le maximum d’informations

Mais pourquoi donc, me direz vous ?

Par expérience, j’ai « très » (voir « trop ») souvent rencontré des tutoriels très intéressants mais manquants cruellement d’informations sur la démarche, « pourquoi » et « dans quel but »,
Ou donnant une solution à un problème sans contexte.

Mon QQOQCCPSS en détail

Mais revenons à nos moutons, le QQOQCCPSS , je vais vous développer mon approche :

Quoi?

  • Simplement l’objectif du tutoriel

Il faut bien commencer quelque part, exprimer clairement l’objectif du tutoriel me semble un bon début, non ?

Qui?

  • A qui est destiné le tutoriel
  • Les compétences de base à avoir pour celui-ci
  • Difficultés du tutoriel

Que dire de plus, cibler le bon public c’est important ^^

Où?

  • Les outils et ressources nécessaires + contexte logiciel et/ou matériel

Étape très pratique pour savoir ce dont on a besoin avant de commencer

-Quoi comment ça, on lit le tutoriel avant de commencer….
-Ca va, on l’a tous fait de commencer un tuto sans tout lire avant, hein ? 😛

Quand?

  • Versions des logiciels et dépendances
  • Risque de variation dans le temps

Le fameux quand, une chose qui devrait être obligatoire dans tous les tutos de nos jours, combien de fois j’ai perdu mon temps sur des tutos obsolètes X(

Combien?

  • Temps de réalisation
  • Prix éventuel

Comment?

  • Le tutoriel en lui même

Pourquoi?

  • Exemples de cas d’utilisation
  • possibilités d’évolution

C’est l’occasion ici de développer plus les objectifs, donner le fond de ma pensée en rédigeant le tutoriel. mais aussi, d’exprimer mon avis et les perspectives d’évolution.

Sauvegarde?

  • Où sont les données
  • Où sont les fichiers de configuration

Élément important pour tout bon admin qui se respecte… savoir « où » et « quoi » sauvegarder pour les jours de blackout total ou de migration 😉
Merci à Genma (2.) qui m’a rappelé effectivement l’importance et l’absence régulier dans les tutoriels de cette information

Sources!!!!

Tout simplement de citer toutes les sources utilisées dans le tutoriel

Conclusion

Mon but est de vous guider pas de vous diriger,  vous faire réfléchir sur les possibilités d’évolution, mais surtout de vous permettre au mieux d’adapter mon tuto à vos besoins.
Je vous incite aussi à participer en commentaire, de donner votre avis sur mes tutos et même de me questionner si des éléments ne sont pas clairs.

« Avoir des connaissances sans les partager, c’est se mettre au niveau de celui qui n’a pas d’idées. »
– Thucydide ; L’histoire de la guerre du Péloponnèse – Ve s. av. J.-C (3.)

Sources
  1. QQOQCCP Wikipedia
  2. Le blog de Genma
  3. mon-poeme.fr
Facebooktwittergoogle_plusredditmail