En même temps, c'est pas forcément facile / agréable / gratifiant de maintenir de la documentation à jour, et certains développeurs y épuisent leur goût de faire du LL s'ils s'y ennuient.
Tout rejeter sur le dos des développeurs, c'est facile mais contre-productif. L'idée de faire de la documentation partagée me semble beaucoup plus efficace, et encourage, si tu ne trouve pas ce que tu cherches sur la doc partagée officielle, à l'ajouter quand tu le trouves ailleurs pour que tout le monde en profite. En plus ça peut permettre aux développeurs de voir ce qui manque (si quelqu'un poste un commentaire dans ce sens), et ce qui n'est pas clair pour tout le monde (si une partie est très documentée en général c'est que l'utilisation n'était pas intuitive ou le code mal documenté à la base).
Et puis, il faut se rendre à l'évidence, maintenant le développement et surtout le développement en LL ça se fait de plus en plus sur des bases collectives. C'est à dire que, même en solo, on a de plus en plus à utiliser des outils collaboratifs du genre github qui permettent de centraliser le code versionné, une wiki, la gestion de la collaboration d'autres développeurs, et la publicité des travaux. Que l'on y travailles activement en essayant de réaliser un outil spécialisé ou qu'on laisse l'auto-organisation faire son bonhomme de chemin. Après tout, avec un système à la github, n'importe qui peut trouver le projet, cloner le dépôt git, patcher pour ajouter de la doc sans rien casser et soumettre le patch au mainteneur qui n'a aucun effort à fournir ou presque pour l'intégrer, et il en va de même pour la wiki.
[^] # Re: Wiki-libra?
Posté par Bastes . En réponse au journal Documentation collaborative. Évalué à 3.
Tout rejeter sur le dos des développeurs, c'est facile mais contre-productif. L'idée de faire de la documentation partagée me semble beaucoup plus efficace, et encourage, si tu ne trouve pas ce que tu cherches sur la doc partagée officielle, à l'ajouter quand tu le trouves ailleurs pour que tout le monde en profite. En plus ça peut permettre aux développeurs de voir ce qui manque (si quelqu'un poste un commentaire dans ce sens), et ce qui n'est pas clair pour tout le monde (si une partie est très documentée en général c'est que l'utilisation n'était pas intuitive ou le code mal documenté à la base).
Et puis, il faut se rendre à l'évidence, maintenant le développement et surtout le développement en LL ça se fait de plus en plus sur des bases collectives. C'est à dire que, même en solo, on a de plus en plus à utiliser des outils collaboratifs du genre github qui permettent de centraliser le code versionné, une wiki, la gestion de la collaboration d'autres développeurs, et la publicité des travaux. Que l'on y travailles activement en essayant de réaliser un outil spécialisé ou qu'on laisse l'auto-organisation faire son bonhomme de chemin. Après tout, avec un système à la github, n'importe qui peut trouver le projet, cloner le dépôt git, patcher pour ajouter de la doc sans rien casser et soumettre le patch au mainteneur qui n'a aucun effort à fournir ou presque pour l'intégrer, et il en va de même pour la wiki.