Je réponds très tard, mais selon moi, ce qu'on apprend sur la documentation de code, etc., vient principalement pour 2 raisons:
Tout le monde n'est pas un real programmer1: pas mal de gens sont « moyens » en termes de programmation, et ont besoin d'une doc « à part » pour pouvoir rapidement trouver la doc des interfaces2.
Il y a des environnements où le turnover est plutôt énorme (et en France c'est encore plus vrai) : sans une doc un minimum plus détaillée que la « méta-doc » évoquée, tu te retrouves potentiellement avec une catastrophe ambulante...
La combinaison des deux points précédents peut être fatale je pense.
Oui, ça veut aussi dire que ce sont des gens qui n'ont pas bien configuré leur IDE/ViM/Emacs/etc., ou bien qui ne savent pas encore s'en servir, ou... D'un point de vue pragmatique, ce n'est pas très important. ↩
[^] # Re: Merci pour ce partage - mais la doc fouque
Posté par lasher . En réponse au journal Publication de bibliothèques c++ sous licence libre. Évalué à 2.
Je réponds très tard, mais selon moi, ce qu'on apprend sur la documentation de code, etc., vient principalement pour 2 raisons:
La combinaison des deux points précédents peut être fatale je pense.
J'exagère bien sûr. ↩
Oui, ça veut aussi dire que ce sont des gens qui n'ont pas bien configuré leur IDE/ViM/Emacs/etc., ou bien qui ne savent pas encore s'en servir, ou... D'un point de vue pragmatique, ce n'est pas très important. ↩