Discussion :

[montesq]

Regarde mon premier post :

En quoi n'est-ce pas clair ????

Si nous ne saisissons pas ce que tu écris, soit nous sommes en deçà du niveau intellectuel pour discuter avec toi, soit tu n'as pas été clair...

Ce sont TES incompréhensions qui viennent d'un problème de vocabulaire..

Un Document de Spécification a une signification dans le domaine de l'informatique depuis plus de 40 ans...

Effectivement je n'utilise pas le vocabulaire "informatique", qui dépend essentiellement de la méthode, de l'organisation...
Pour moi, le processus de production se base sur un seul et unique document que l'on peut appeler cahier des charges, recueil des besoins, spécifications, backlog, design... Peu importe le nom du moment qu'il informe sur ce que dois faire l'application et qu'il inclut tout ce qui est nécessaire pour expliquer au mieux le futur fonctionnement de l'application (maquette, scénario...)

Je ne dis pas de faire 2 documents. Comme le fais très justement remarquer Kaeru No Uta, il existe tout un tas d'outils permettant de faire des annotations, des couches, dans un document.

Oui idéalement/théoriquement, mais dans les faits il faut adapter e manuel à chaque catégorie d'utilisateur. Tu ne mets pas à disposition des clients le manuel utilisateur de l'administrateur.
Par contre, je pense qu'on peut dire qu'il y a une stricte équivalence entre spécifications ET "documentation utilisateur". (vocabulaire...)

[souviron34]

Oui idéalement/théoriquement, mais dans les faits il faut adapter e manuel à chaque catégorie d'utilisateur. Tu ne mets pas à disposition des clients le manuel utilisateur de l'administrateur.

Je n'ai jamais vu 2 manuels utilisateurs, l'un pour les admnistrateurs, l'autre pour les utilisateurs lambda..

A la limite un chapitre spécial, mais 2 manuels ?????

Par contre, je pense qu'on peut dire qu'il y a une stricte équivalence entre spécifications ET "documentation utilisateur". (vocabulaire...)

Ben je suis désolé, mais le vocabulaire est la chose permettant de se comprendre...

Et une spécification a une signifcation précise..

Comme dit plus haut, dans CE contexte, on peut dire qu'il y a PLUS OU MOINS équivalence, mais pas équivalence stricte, puisque ne doivent pas figurer dans le Manuel Utilisateur les fonctionalités uniquement destinées à l'informatique.

[Nebulix]

Un manuel utilisateur peut-il être considéré comme un document de spécifications fonctionnelles ?

Indépendamment de la réponse, est-il possible ou souhaitable de baser les efforts de développement sur le manuel utilisateur du futur logiciel ?

Celà me semble la bonne façon de faire :
Le logiciel peut faire ceci, si vous lui demandez comme celà
Que peut-on vouloir de plus ?
reste à faire le "comment" mais qui sera moins diffusé

[montesq]

Je n'ai jamais vu 2 manuels utilisateurs, l'un pour les admnistrateurs, l'autre pour les utilisateurs lambda..

A la limite un chapitre spécial, mais 2 manuels ?????

Bah oui, pourquoi veux-tu renseigner les utilisateurs lambda sur les fonctionnalités de l'administration?
Et imagine si ton application est mise à disposition des clients...

Ce n'est pas parce que Môsieur n'a jamais vu que ça ne peut pas être fait...

Ben je suis désolé, mais le vocabulaire est la chose permettant de se comprendre...

Et une spécification a une signifcation précise..

Comme dit plus haut, dans CE contexte, on peut dire qu'il y a PLUS OU MOINS équivalence, mais pas équivalence stricte, puisque ne doivent pas figurer dans le Manuel Utilisateur les fonctionalités uniquement destinées à l'informatique.

En dehors de tout contexte méthodologique stricte, je me réfère à la définition du dictionnaire français qui à preuve du contraire est le référentiel commun pour ceux qui parlent notre langue que ce soit des informaticiens ou des utilisateurs (user centered).
Donc un document de spécification (alias une spécification) n'a d'autre but que de spécifier le besoin/produit et pour atteindre ce besoin, tous les moyens sont bons, l'important étant d'être compris par tous...

[rad_hass]

Dans une approche agile il est fortement conseillé comme le dit souviron34 de se baser sur le besoin client ... dans une approche dirigé par le comportement, on défini des user-stories qu'on complète avec des critères d'acceptation (et les tests associés) et la possibilité de réutiliser cette partie pour générer le guide utilisateur me semble de plus en plus frappante ... D'ailleurs c'est un sujet sur lequel je suis entrain de me pencher pour avoir un support commun, sujet super intéressant.

[hegros]

Ma réponse croisée sur un autre fil