Re: [fr-qa] Re: Développement - Rédaction de l'aide

On Tue, 2013-01-29 at 23:20 +0100, Jean-Baptiste Faure wrote:
> 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.

Oui tout a fait d'accord. Meme encore a l'heure actuelle, je ne sais pas
si l'UI du template manager ne va pas encore evoluer un peu etant donne
les problemes remontes par l'equipe UX (fondes ou pas).

> 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.

Oui, pour des modifications mineures il est plus facile d'avoir l'aide
avant (meme certains developpeurs l'ecrivent eux-meme).

Par contre pour des gros morceaux comme le template manager, je ne me
sens pas l'ame d'un redacteur ;)

> 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.

Ca pourrait surement aider de produire un tutoriel, en effet.

--
Cedric


-- 
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