Sachez que l'énergie à dépenser pour mettre à jour une doc est bien supérieure à celle dépensée pour "vociférer", puisque, pour cela, il faut connaitre le fonctionnement du logiciel, mais aussi, dans la partie qui nous concerne, les outils pour avoir un truc qui fonctionne. Hélas, je n'ai ni le temps, ni la compétence sur ces outils, pour écrire/modifier une telle documentation.
open source ne veut pas juste dire gratos mais ouvert et communautaire
C'est quoi le rapport avec le fait que la documentation d'installation est déficiente selon moi ?
Pourquoi un utilisateur de logiciel pas content devrait toujours mettre la main à la patte et jamais critiquer ?
Tu vois, tu nous fais une réponse à deux balles, classique de ceux qui, parce qu'ils ont fait un truc gratos, il ne faudrait pas les critiquer.
Je suis l'auteur de quelques projets libres. Je n'ai encore jamais renvoyé un type comme tu viens de le faire suite à une critique. Je suis plutôt attentif au contraire, et, quand il y a critique, j'essaye de comprendre pourquoi et tente d'y remédier, sans forcément faire attention à la forme du discours (on a tous nos coups de gueule). Parce que, quand il y a mécontentement, c'est qu'il y a bien souvent un vrai problème à l'origine, petit ou gros. Et que ce problème gène peut-être d'autres personnes plus silencieuses. voir même qu'il y a des chances que le problème en question ait détourné illico presto les utilisateurs vers d'autres solutions. C'est tout perdant pour le projet (moins d'utilisateurs -> moins de retour sur les défauts -> moins de défauts corrigés -> insatisfaction -> moins d'utilisateurs etc...).
Je ne veux pas le beurre et l'argent du beurre comme tu dis : je demande juste une doc plus complète pour ceux qui ne connaissent pas les outils annexes nécessaires au fonctionnement ou à l'installation. D'ailleurs le coup de gueule ne s’adresse pas qu'au projet de cette news, mais à d'autres projets. Il y a peu de temps je devais installer une appli, faites en Java et nécessitant tomcat. Pour la configurer, ils indiquaient "modifier la balise machin dans le fichier de configuration". Aucun moyen de savoir quel était ce fichier et où. Sauf si tu es expert J2EE, que tu sais comment fonctionne tomcat, comment est organisé un war, un jar etc... Bref, pour installer une appli à la con, il fallait être expert J2EE, ou en tout cas être développeur JAVA.
Et là, c'est un presque pareil.
Si il y avait qu'une seule chose à documenter et à bien documenter, ce serait l'installation. C'est primordiale car c'est la porte d'entrée. Si la doc d'install est trop succinte, si la procédure est trop longue, ça décourage vite d'essayer, et les gens vont voir ailleurs.
[^] # Re: Simplifié ?
Posté par Laurent J (site web personnel, Mastodon) . En réponse à la dépêche Sortie de Modoboa 1.1.0. Évalué à 3.
Cher monsieur,
Sachez que l'énergie à dépenser pour mettre à jour une doc est bien supérieure à celle dépensée pour "vociférer", puisque, pour cela, il faut connaitre le fonctionnement du logiciel, mais aussi, dans la partie qui nous concerne, les outils pour avoir un truc qui fonctionne. Hélas, je n'ai ni le temps, ni la compétence sur ces outils, pour écrire/modifier une telle documentation.
C'est quoi le rapport avec le fait que la documentation d'installation est déficiente selon moi ?
Pourquoi un utilisateur de logiciel pas content devrait toujours mettre la main à la patte et jamais critiquer ?
Tu vois, tu nous fais une réponse à deux balles, classique de ceux qui, parce qu'ils ont fait un truc gratos, il ne faudrait pas les critiquer.
Je suis l'auteur de quelques projets libres. Je n'ai encore jamais renvoyé un type comme tu viens de le faire suite à une critique. Je suis plutôt attentif au contraire, et, quand il y a critique, j'essaye de comprendre pourquoi et tente d'y remédier, sans forcément faire attention à la forme du discours (on a tous nos coups de gueule). Parce que, quand il y a mécontentement, c'est qu'il y a bien souvent un vrai problème à l'origine, petit ou gros. Et que ce problème gène peut-être d'autres personnes plus silencieuses. voir même qu'il y a des chances que le problème en question ait détourné illico presto les utilisateurs vers d'autres solutions. C'est tout perdant pour le projet (moins d'utilisateurs -> moins de retour sur les défauts -> moins de défauts corrigés -> insatisfaction -> moins d'utilisateurs etc...).
Je ne veux pas le beurre et l'argent du beurre comme tu dis : je demande juste une doc plus complète pour ceux qui ne connaissent pas les outils annexes nécessaires au fonctionnement ou à l'installation. D'ailleurs le coup de gueule ne s’adresse pas qu'au projet de cette news, mais à d'autres projets. Il y a peu de temps je devais installer une appli, faites en Java et nécessitant tomcat. Pour la configurer, ils indiquaient "modifier la balise machin dans le fichier de configuration". Aucun moyen de savoir quel était ce fichier et où. Sauf si tu es expert J2EE, que tu sais comment fonctionne tomcat, comment est organisé un war, un jar etc... Bref, pour installer une appli à la con, il fallait être expert J2EE, ou en tout cas être développeur JAVA.
Et là, c'est un presque pareil.
Si il y avait qu'une seule chose à documenter et à bien documenter, ce serait l'installation. C'est primordiale car c'est la porte d'entrée. Si la doc d'install est trop succinte, si la procédure est trop longue, ça décourage vite d'essayer, et les gens vont voir ailleurs.