Ca peut etre un soft (du point de vue end-user) ou une API (du point de vue développeur)
C'est tout à fait vrai pour une API, mais ça l'est à mon avis beaucoup moins pour une application pour laquelle la plupart des utilisateurs ne liront jamais la doc et se contenteront d'utiliser les fonctionnalités qu'ils ont comprises intuitivement... et le problème en général avec la doc des applications, c'est que sont documentées que les fonctionnalités que l'on peut comprendre tout seul, c'est-à-dire, par exemple, qu'on va avoir un bon gros paragraphe sur le menu "edit" pour nous dire que "copier" correspond à "placer le texte sélectionné de la fenètre d'édition dans le presse papier", mais dans le menu "tool", l'entrée "conversion" sera documenté comme "effectue la conversion" sans savoir quelle source, quelle destination, quels formats etc... Le pire des exemples de ce genre est l'aide de windows dont le texte est complétement redondant par rapport à l'interface...
Sinon, dans un aute domaine,, aucun des 3 liens ne parlent des différentes licences utilisables pour une doc... quelqu'un a plus d'infos dessus, ou une doc?
[^] # Re: Réponse
Posté par calandoa . En réponse à la dépêche Documentation et projets libres commerciaux : sondage. Évalué à 4.
C'est tout à fait vrai pour une API, mais ça l'est à mon avis beaucoup moins pour une application pour laquelle la plupart des utilisateurs ne liront jamais la doc et se contenteront d'utiliser les fonctionnalités qu'ils ont comprises intuitivement... et le problème en général avec la doc des applications, c'est que sont documentées que les fonctionnalités que l'on peut comprendre tout seul, c'est-à-dire, par exemple, qu'on va avoir un bon gros paragraphe sur le menu "edit" pour nous dire que "copier" correspond à "placer le texte sélectionné de la fenètre d'édition dans le presse papier", mais dans le menu "tool", l'entrée "conversion" sera documenté comme "effectue la conversion" sans savoir quelle source, quelle destination, quels formats etc... Le pire des exemples de ce genre est l'aide de windows dont le texte est complétement redondant par rapport à l'interface...
Sinon, dans un aute domaine,, aucun des 3 liens ne parlent des différentes licences utilisables pour une doc... quelqu'un a plus d'infos dessus, ou une doc?