C'est bien ce que je dis, tu raisonne en livraison unique à un client garantie par contrat avec une seule documentation fixe et finale
Non, je raisonne en document _utilisable_ point barre. pour une version stable d'une bibliothèque ou d'un projet. En quoi le fait d'être libre/proptrio/contrat ou n'importe quoi change-t-il quelque chose ? On s'en fout, ce que je veux c'est pouvoir utiliser la doc sans me prendre trop la tête.
Ce n'est pas le modèle de rails par exemple. Comparer les documentations générées par ces deux formes de développement sur le critère de la validité de la doc d'une seule version V à un moment arbitraire, c'est privilégier le premier modèle où il n'y a pas beaucoup de V, alors que dans le second modèle on fait en continu des versions V, V', V'', etc. sans forcément que la dernière soit la plus stable ou la mieux documentée.
Et qu'est-ce qui empêche d'avoir une doc à jour par rapport aux évolutions de version ? Le temps que ca prend? Ca n'a pas de sens : soit tu documentes et on utilise ton code, quitte à prendre plus de temps, sit tu documentes pas et personne n'utilise ton code et la ça sert à rien d'aller vite. De plus en mettant la doc à jour au fur et à mesure ça prend moins de temps plutot que de générer une doc après que la version soit sortie (et cette doc ne sera jamais à jour car le temps d'écrire la doc, la version N+1 sort)..... Et je te répète que je ne cherche pas une doc à jour pour la derniere version non stable, mais pour une version stable.
[^] # Re: Wiki-libra?
Posté par totof2000 . En réponse au journal Documentation collaborative. Évalué à 2.
Non, je raisonne en document _utilisable_ point barre. pour une version stable d'une bibliothèque ou d'un projet. En quoi le fait d'être libre/proptrio/contrat ou n'importe quoi change-t-il quelque chose ? On s'en fout, ce que je veux c'est pouvoir utiliser la doc sans me prendre trop la tête.
Ce n'est pas le modèle de rails par exemple. Comparer les documentations générées par ces deux formes de développement sur le critère de la validité de la doc d'une seule version V à un moment arbitraire, c'est privilégier le premier modèle où il n'y a pas beaucoup de V, alors que dans le second modèle on fait en continu des versions V, V', V'', etc. sans forcément que la dernière soit la plus stable ou la mieux documentée.
Et qu'est-ce qui empêche d'avoir une doc à jour par rapport aux évolutions de version ? Le temps que ca prend? Ca n'a pas de sens : soit tu documentes et on utilise ton code, quitte à prendre plus de temps, sit tu documentes pas et personne n'utilise ton code et la ça sert à rien d'aller vite. De plus en mettant la doc à jour au fur et à mesure ça prend moins de temps plutot que de générer une doc après que la version soit sortie (et cette doc ne sera jamais à jour car le temps d'écrire la doc, la version N+1 sort)..... Et je te répète que je ne cherche pas une doc à jour pour la derniere version non stable, mais pour une version stable.