La documentation nutritionnelle est en cours. Il y une vingtaine d’applications a ecrire la documentation pour l’utilisateur. Ce faisant, je verifie aussi les programmeset en cas de modification du programme, je dois aussi mettre a jour la documentation technique de ce programme.
En date du 12-11-2023, la documentation utilisateur a porte sur 23 options/23 (100 %) qui ete corrigees et dont la documentation technique mise a jour. La documentation utilisateur compte presentement environ 45 a 48 pages.
Voici un exemple de l’Option Nutriment Recherche qui vous permet de voir la liste des produits classes par ordre decroissant de la quantite du nutriment selectionne, parmi les produits de la liste publiee dans “Valeur nutritive de quelques aliments usuels”(Sante Canada)”.
Pourquoi la redaction de la documentation utilisateur est si rapide? Parce que durant la pandemie, l’essentiel de la documentation technique a ete ecrite et elle a ete mise-a-jour recemment suite aux
dernieres modifications de la revison 20. Il ne s’agissait plus que d’ecrire le fonctionnement des options pour l’utilisateur, qui, individuellement sont tres simple a utiliser. Finalement, ce n’est preque que de la mise en page… avec les nouvelles captures d’ecran qui incluent celles de l’IA…
La raison qui m’a incite a choisir cette structuration des options (Structure de fractionnement de travail-SFT ou WBS en anglais) c’est parce que l’ensemble des options est complexe et que cela rebuffe aux utilisateurs qui ne sont pas des experts en informatique. J’ai decoupe l’ensemble de Black Box Logiciels DMSB en unite simple a operer (et aussi a maintenir ou corriger le cas echeant). Ce qui fait que cela a resulter en une centaine de petites options aisees a entretenier et a utiliser. Et c’est aussi une des raisons principales pourquoi il ne se produit que tres peu d’erreurs dus aux petits programmes. Au Final, un design tres performant et de haute qualite.
Premiere lecon a tirer: Au lieu de faire des saloperies aux autres, vous devriez envisager un retour aux etudes specialisees… en d’autres domaines que l’esoterisme.
Tiens… ca me rappelle quand H. Mintzberg etait a la redaction de son ouvrage Structure et dynamique des organisations (Éditions d’Organisation), parue en 1982. Il racontait lui-meme, qu’il avait demande a sa secretaire de tout mettre ses textes sur des disquettes et il s’est rendu en France pour terminer la redaction… Il n’a jamais vraiement explique pourquoi aller en France… seulement pour terminer la redaction d’un ouvrage? Il n’y avait pourtant rien de subversif, sauf si on considere la science comme etant en soi, subversive?
Exemple Option Comparatif (produits alimentaires)
VOICI LA TABLE DES MATIERES DE LA DOCUMENTATION DES OPTIONS NUTRITIONNELLES
Documentation utilisateur
-gestion des documents 61 pages
-options comptables 46 pages
-options nutritionnelles 53 pages
-Installation 37 pages
Au final, la documentation utilisateur 197 pages
Ce matin. c’est la FIN avec la reconstruction de l’installateur revision 20.
blackbox-logiciel-linux-2-0-rev20.tar.gz
et des paquets de la documentation:
blackbox-logiciels-linux-documentation-rev-20.tar (technique)
blackbox-logiciels-linux-utilisateurs-rev-20.tar (utilisateur).
Et evidemment que cela ajoute d’une maniere importante a la valeur de mes actifs.
Maintenant tout peut etre reproduit: gestion des documents, options comptables et options nutritionnelles.
