• [^] # Re: De l'importance de la documentation...

    Posté par . En réponse à la dépêche Calenco : une solution pour la documentation des projets libres ?. Évalué à 2.

    Il y a effectivement du boulot concernant la doc utilisateur. C'est souvent du au fait que beaucoup de développeurs bénévoles développent avant tout pour eux même et que leur code n'a pas forcément vocation à être utilisé, ou en tout cas pas par un grand nombre de personnes (et pas Mme Michu).

    Sur un projet qui fait beaucoup d'audience ou pour lequel on est tenu (commercialement) de faire du support, documenter est une évidence. Quand on en a marre de se prendre pour la 10e fois un bug qui n'en est pas un sur une fonctionnalité mal comprise, on met à jour la doc ou on ajoute une entrée dans la FAQ, ne serait-ce que pour se faciliter la vie et limiter le flux entrant. Dans la monde du libre, on est moins impacté. Les utilisateurs ont tendance à tester un logiciel et abandonner pour passer à autre chose s'ils rencontrent un problème. Ils sont peu nombreux à remonter des bugs. Du coup le développeur ne se rends pas compte qu'il y a un réel problème et comme il n'a pas de soucis, il ne change rien.