jean-francois.delaroque a écrit :

Bonjour à tous,

Bonjour Jean-François,

b.. Questions : Pour les débutants, cela risque d'être rebutant et de ne pas dégager l'essentiel. c'est là que l'avis de tous, y compris des non qualifiés est aussi indispensable car la documentation s'adresse à eux aussi. Faut-il faire 2 niveaux (ou 3) de documentation ou tout simplement rappeler la référence des guides ou livres qui traitent des bases du sujet ?

C'est, en effet, un gros problème assez difficile à traiter. Un moyen de le contourner serait de préciser en début de doc les points à consulter en fonction des besoins. Ceci dit, l'organisation de ce document est conçue de manière à graduer l'information. Les titres choisis me semblent assez parlants pour guider en ce sens.


c.. Mon avis : Les guides ont une approche pratique. Un complément, plus synthétique et plus complet pourrait être utile. Une page « bibliographie » pourrait être ajoutée au how-to. Elle ne mentionnerait pas seulement les documents utilisés pour réaliser le document, mais le plus possible de documents traitant du sujet, sans oublier les liens. Chaque rédacteur de guide, livre ou how-to ou relecteur étant invité à compléter cette page. Éviter de trop démultiplier le nombre de documents. L'organisation actuelle est bonne

Si c'est effectivement utile, ce type de référence est très difficile à maintenir. Un catalogue externe -- la solution actuelle -- est, à mon avis, beaucoup plus souple. N'oublions pas que nous souffrons du manque de contributeurs pour rédiger, alors pour maintenir des listes de références...


d.. Question : Faut-il faire un document récapitulant la documentation disponible par thème ?

N'est-ce pas ce que font les listes de l'espace documentaire ?


e.. Mon avis : A voir s'il y a une réelle demande... et dans ce cas des volontaires pour le réaliser. La page bibliographie de chaque how-to remplirait cet office. Consulter le how-to ou faire une compilation de ces pages . Terrible dilemme éventuel !

Et sacré boulot ! :)


Salutations du dimache.

Très cordialement,
--
Jean-Francois Nifenecker, Bordeaux

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Répondre à