1) La documentation vous a t'elle permis de réimplémenter le processus originel?

(réponse oui/non)

Oui.
 
2) Quelles difficultés, liées à la documentation où à des insuffisances de celle ci, avez vous rencontrées durant la réimplémentation du processus?

J'ai trouvé la documentation de bonne qualité, donnant suffisamment de détails et répondant à la plupart des questions que je pouvais me poser. Voici quelques points sur lesquels j'ai été gêné :

a) Lors de ma première lecture, j'ai été surpris par l'ordre dans lequel les définitions sont données au début du document :
- les signaux sont définis de constantes et d'opérateurs mathématiques que l'on ne connaît pas à ce stade de la lecture
- de même les premiers signaux sont définis à partir de signaux décrits ultérieurement
- le fait que les signaux valent 0 à t<0, indispensable pour enclencher la récursivité, n'est indiqué que plus loin
- les constantes sont définies à partir du paramètre f_S qui lui aussi n'a pas encore été décrit
ainsi, il faut avoir lu la section 3 pour bien comprendre la section 1.
Cela dit, je comprends le choix actuel de présentation où les informations clés, spécifiques à chaque processus, sont données en premier.

b) Je n'ai pas su lire le diagramme de boîte de la section 2.

c) J'aurais aimé qu'un exemple soit fourni sur chaque processus pour tester mon implémentation, mais je comprends que de bons exemples soient difficiles à générer.

d) Enfin, deux points de détail concernant test2:
- Section 1, item 3 : je n'ai pas compris ce que signifiaient les écritures "test2/echo 1000/" et "millisecond", "feedback".
- Section 1, item 4 : je pense que le \land est un ET bit à bit, mais ce n'est pas indiqué.

3) Avez vous été aidé dans cette tâche en faisant appel à des ressources extérieures à la documentation mathématique, et différentes de celles habituellement utilisées par vous dans votre activité (par exemple, expert personne physique, ressource "en ligne" spécifique au traitement du signal audio...)
       Non, je n'ai utilisé que les ressources mises en oeuvre habituellement dans mon activité.

Non.
 
       Oui, j'ai utilisé des ressources extérieures (préciser lesquelles) :
 
4) A votre avis, une évolution de la documentation permettrait elle de résoudre ce ou ces difficultés (pour chacune des difficultés rencontrées, avec éventuellement une piste pour ces évolutions, non obligatoire)

a) Peut-être donner quelques informations de la section 3 avant la définition des signaux, ou simplement ajouter une ligne comme quoi des informations sur f_S, int, etc. sont données dans la section 3.

b) Si, comme je le pense, le diagramme est une représentation graphique du code, il pourrait être mis après la section 3.

c) J'ai peur qu'il ne soit pas facile, dans le cas général, de produire automatiquement des exemples intéressants.

5) A l'issue de cette expérience, diriez vous que :

a) la réimplémentation n'a posé aucun problème
b) la réimplémentation a posé des problèmes mineurs qui peuvent être résolus avec des améliorations de la documentation

b)
 
c) la réimplémentation a posé des problèmes majeurs qui ont nécessité l'aide de ressources extérieures
d) la réimplémentation a été impossible

Très cordialement,

Vivien Maisonneuve