Ubuntu-fr

Pam547

Documentations développeurs VS Documentations utilisateurs

Bonjour,

Difficile d'avoir une documentation à jour pour un utilisateur, non ?
En ce moment je me réfère de préférence à ce qui est sur le disque. (En lisant au choix avec less ; man ; ou yelp).
Tout y est très technique, trop pour un simple utilisateur.

Je me demandais donc où coince la chose pour que les différents environnements graphiques utilisent des moteurs de documentation comme ceux utilisés par les développeurs ?

Dernière modification par Pam547 (Le 09/11/2020, à 15:12)

---

Art.9.(code civil)  Chacun a droit au respect de sa vie privée.

Art.12.(déclaration universelle des DDH) Nul ne sera l'objet d'immixtions arbitraires dans sa vie privée, sa famille, son domicile ou sa correspondance, ni d'atteintes à son honneur et à sa réputation. Toute personne a droit à la protection de la loi contre de telles immixtions ou de telles atteintes.

Compte anonymisé

Re : Documentations développeurs VS Documentations utilisateurs

Une documentation technique n'est pas la même chose qu'une documentation pour développeur. En fait, tu peux avoir une documentation utilisateur très compliquée pour un logiciel en ligne de commande, et une documentation développeur très simple dans le cas de certaines plateformes de développement.

Écrire la documentation est bien souvent ce qu'il y a de plus difficile à faire, à maintenir, à traduire ..., surtout quand il s'agit de documenter une interface graphique. Personne n'a envie de faire cela. Et il faut un très bon niveau d'anglais.

Dernière modification par abakkk (Le 09/11/2020, à 22:02)

Pam547

Re : Documentations développeurs VS Documentations utilisateurs

Vous avez certainement raison. Tout le monde devrait savoir programmer en C .

Mais c'est quand même bizarre, autant de système de gestion de version pour les programmeurs et si peu pour les utilisateurs.

Des programmeurs à qui l'on met à disposition des documentations régulièrement mises-à-jour.

----------------------------------------------------------------------------------------

On en est à de la web application portable, où l'application est paramétrée par un administrateur pour être mise à disposition de "télé-travailleurs" ou assimilé.

Quelque chose me gêne dans cette organisation, le prix que fait payer l'administrateur au télé-travailleur pour lui avoir fourni un outil peut-être.

Va falloir faire une étude de coût.

---

Art.9.(code civil)  Chacun a droit au respect de sa vie privée.

Art.12.(déclaration universelle des DDH) Nul ne sera l'objet d'immixtions arbitraires dans sa vie privée, sa famille, son domicile ou sa correspondance, ni d'atteintes à son honneur et à sa réputation. Toute personne a droit à la protection de la loi contre de telles immixtions ou de telles atteintes.