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.
Il est clair que mettre en place une documentation est assez fastidieux, cependant si celle-ci est faite en même temps que le développement c'est beaucoup moins contraignant. Un peu de rigueur dans la mise à jour et on s'y retrouve. Certes, les projets avancent un peu moins vite mais parfois ce n'est pas plus mal .... entre avoir une bibliothèque inutilisable parce que non documentée ou doc pas à jour, et une bibliothèque qui évolue moins vite mais qui est bien documentée, je choisis la deuxième ....
Tout rejeter sur le dos des développeurs, c'est facile mais contre-productif
Loin de moi l'idée de trouver un coupable, simplement je déplore un état de fait. Et surtout, il y a encore des développeurs qui s'imaginent que le code source suffit, et qu'il n'y a pas besoin de documentation. Et c'est entre autre pour ça qu'en entreprise les LL se trainent une maivaise image.
C'est une vision utopique du dev de LL.
Il est impossible pour une tierce personne de déveopper une doc à jour pour du LL, sans mettre les développeurs dans la boucle, car le développement des LL va bien trop vite.
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.
D'accord avec toi, cependant les développeurs doivent en faire un minimum. Et la il s'agit plus d'adopter des conventions et des normes communes dans un développement, qui pourront être utilisés par des outils tiers pour centraliser cette doc. Il faut aussi en cas de besoin avoir un chemin inverse : reporter les modifications de la doc "en ligne" par exemple vers le code source .... un peu ambitieux mais pourquoi pas ?
Juste une queston : as-tu déjà essayé de documenter un projet que tu ne connais pas, rien qu'à partir du code source ? Moi, oui, et le temps de documenter ce que tu as compris, c'est obsolète car une ou deux autres versions du projet sont sorties et tout est à refaire.
[^] # Re: Wiki-libra?
Posté par totof2000 . En réponse au journal Documentation collaborative. Évalué à 2.
Il est clair que mettre en place une documentation est assez fastidieux, cependant si celle-ci est faite en même temps que le développement c'est beaucoup moins contraignant. Un peu de rigueur dans la mise à jour et on s'y retrouve. Certes, les projets avancent un peu moins vite mais parfois ce n'est pas plus mal .... entre avoir une bibliothèque inutilisable parce que non documentée ou doc pas à jour, et une bibliothèque qui évolue moins vite mais qui est bien documentée, je choisis la deuxième ....
Tout rejeter sur le dos des développeurs, c'est facile mais contre-productif
Loin de moi l'idée de trouver un coupable, simplement je déplore un état de fait. Et surtout, il y a encore des développeurs qui s'imaginent que le code source suffit, et qu'il n'y a pas besoin de documentation. Et c'est entre autre pour ça qu'en entreprise les LL se trainent une maivaise image.
C'est une vision utopique du dev de LL.
Il est impossible pour une tierce personne de déveopper une doc à jour pour du LL, sans mettre les développeurs dans la boucle, car le développement des LL va bien trop vite.
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.
D'accord avec toi, cependant les développeurs doivent en faire un minimum. Et la il s'agit plus d'adopter des conventions et des normes communes dans un développement, qui pourront être utilisés par des outils tiers pour centraliser cette doc. Il faut aussi en cas de besoin avoir un chemin inverse : reporter les modifications de la doc "en ligne" par exemple vers le code source .... un peu ambitieux mais pourquoi pas ?
Juste une queston : as-tu déjà essayé de documenter un projet que tu ne connais pas, rien qu'à partir du code source ? Moi, oui, et le temps de documenter ce que tu as compris, c'est obsolète car une ou deux autres versions du projet sont sorties et tout est à refaire.