• # 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é à 4.

    Je suis assez étonné par les quelques réactions que je peux lire.

    Il me semble que si techniquement le LL n'a généralement rien a envier aux logiciels propriétaires, au niveau documentation (et ergonomie, mais là n'est pas la question) il y a des efforts à faire, j'entends par documentation celle qui est utile à l'utilisateur final, pas la documentation du code source pour en comprendre les arcanes.

    Il me parait évident que les développeurs n'ont pas tous vocation à créer de la documentation et inversement, ceux qui écrivent de la documentation ne sont pas nécessairement les développeurs. Tout le monde n'a pas envie d'aller chercher sur Internet des trucs et des astuces, de la documentation pour utiliser son logiciel, surtout s'il est destiné à un public non informaticien.

    Pour cela, encore faut-il désacraliser le code et accepter que la conquête du public se fait avec d'autres arguments que la simple ouverture du code. Cette réflexion englobe également l'ergonomie, le look des applications (cf la discussion sur les scanners et notamment le logiciel vuescan dont le look et l'intuitivité surpasse l'offre en matière de numérisation qu'on peut trouver dans le monde du LL alors que je suis convaincu qu'il y a largement de quoi avoir un équivalent libre)