Date: prev next · Thread: first prev next last
2013 Archives by date, by thread · List index


Bonsoir,

Le 29/01/2013 18:13, pierre-yves samyn a écrit :
Suite...

Merci Sophie pour les renseignements "techniques". Mais mon 
interrogation ne porte pas trop là-dessus. Du moins pas tout de 
suite... Quel que soit le support (wiki ou non, xhp, soumission de 
patch, etc.) il faut "avoir de la matière" pour rédiger une aide, savoir 
ce que fait la fonctionnalité, dans quel contexte on l'utilise, les limites,
etc.


sophi wrote
Ça ne s'est jamais fait, même du temps de OOo l'aide venait après
l'inclusion des fonctionnalités.

Ok, je propose alors justement de changer cela : de même qu'un code doit 
être "approuvé" par un autre développeur, ne pourrait-on pas (ne  devrait-on 
pas) élargir le travail en commun, travailler avec la doc. dès ce niveau et 
demander que l'inclusion d'un code soit dépendante d'un minimum de  
documentation utilisateur si ce n'est de l'existence de l'aide ad hoc ?

Les testeurs sauraient quoi et comment tester... et la documentation
ferait partie des tests dès le départ.

Le problème c'est qu'avec un modèle de développement itératif, il est
illusoire de produire la doc en parallèle à l'écriture du code car
celui-ci évolue très vite et parfois change de direction sous l'effet
des tests "en direct" et des difficultés de codage. Il y a des fonctions
qui changent ou disparaissent, etc. Le cas du gestionnaire de modèles
est typique de cela. Il faut donc attendre que le développement ait
atteint un état stable (à partir duquel il n'y aura probablement plus de
grosses remises en question) avant de commencer à produire la
documentation.

En revanche dans le cas de l'ajout d'une case à cocher dans un dialogue
d'options, on pourrait espérer que la production de l'info-bulle, de
l'info-ballon et du paragraphe de documentation dans l'aide de ce dialogue.

Je pense qu'il y a, avec ce problème de la documentation, un créneau sur
lequel des non-codeurs peuvent intervenir sur le code pour produire la
documentation de base en anglais. C'est à mon avis une part manquante du
processus de développement qui reste à mettre en place. On pourrait sans
doute élaborer le processus avec le gestionnaire de modèles. La première
étape est de savoir comment on crée et intervient sur l'aide.
Apparemment il n'y a pas de tuto pour l'expliquer.

Bonne soirée
JBF

-- 
Seuls des formats ouverts peuvent assurer la pérennité de vos documents.

-- 
Envoyez un mail à qa+help@fr.libreoffice.org pour savoir comment vous désinscrire
Les archives de la liste sont disponibles à http://listarchives.libreoffice.org/fr/qa/
Tous les messages envoyés sur cette liste seront archivés publiquement et ne pourront pas être 
supprimés

Context


Privacy Policy | Impressum (Legal Info) | Copyright information: Unless otherwise specified, all text and images on this website are licensed under the Creative Commons Attribution-Share Alike 3.0 License. This does not include the source code of LibreOffice, which is licensed under the Mozilla Public License (MPLv2). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our trademark policy.