On m'a spécifiquement demandé de donner, ligne par ligne (ou selon le cas - par exemple, image par image, etc.) des explications ou des commentaires que mon supérieur souhaite pouvoir lire et suivre.
Puisqu'il n'est pas programmeur, il ne peut pas suivre le code, il veut donc que tout soit traduit en anglais.
A-t-on déjà demandé à quelqu'un de faire cela auparavant?
J'ai commenté tout le code source et utilisé JSDoc pour générer une documentation complète de toutes les fonctions, variables, etc., et inclus un exemple d'implémentation, ainsi que des démonstrations complètes avec commentaires.
Y a-t-il autre chose que je puisse faire pour commenter le code pour les non-programmeurs?
Ce n'est pas une demande raisonnable, n'est-ce pas?
MISE À JOUR
Finalement, j'ai réussi à expliquer pourquoi ce n'était pas une bonne utilisation du temps pour faire ce qu'il demandait. C'est un type raisonnable et il ne comprenait tout simplement pas en quoi consiste mon travail. Une fois qu'il a vu ce post, je pense qu'il a rapidement compris que ce n'était pas une demande normale.
J'ai fourni une documentation qui pourrait être suivie par un autre programmeur (commentaires JSDoc et inline - ainsi que quelques notes supplémentaires sur des problèmes techniques), ainsi qu'un très large diagramme de la logique principale du programme à suivre par mon patron.
En fin de compte, toutes les parties étaient satisfaites et nous sommes passés à autre chose.