Ca sert a quoi de faire des fichiers de demo si tu ne prends meme pas le temps d'expliquer ce que fait le code?
La question était : est-il bien nécessaire de passer du temps à créer des symboles pour des valeurs numériques de configuration si HWA fournit des fonctions permettant de ne pas avoir à manipuler des valeurs de bits. L'important ici n'était pas la signification de cette valeur particulière mais comment on affecte une valeur à un ensemble de bits.
Franchement, vous ajouteriez un commentaire ?
Oui, certainement. A la fois dans le fichier d'exemple (voir au dessus) et probablement en prod aussi (au niveau de la fonction, pour expliquer pourquoi).
Sur les commentaires dans le code, puisque cela semble être une question fondamentale, je considère qu'il est primordial pour la lisibilité d'un programme que les libellés soient correctement choisis pour les fonctions autant que pour les variables. HWA permet de remplacer des constructions à base d'affectations et d'opérateurs logiques qui nécessitent d'être commentées pour ne pas rester opaques par des instructions dont l'effet doit sembler évident à celui qui lit le code. Pour moi, les commentaires sont utiles pour expliquer pourquoi ou comment on fait les choses, pas pour expliquer le fonctionnement d'une fonction. S'il est nécessaire d'expliquer ce que fait une fonction, c'est que son libellé est mal choisi.
Alors ? Il n'a pas quelques qualités mon HWA ?
Surement, mais comme tu te comportes comme un douchebag avec ce genre de phrases (Pourquoi Ducros y se décarcasse ? et Mais vous faites les poubelles !), tu vas pas attirer grand monde.
Je pourrais reprendre : « Ça sert a quoi de faire des fichiers de démo si les gens ne prennent même pas le temps de les lire ».
Il me semble avoir bien indiqué qu'il n'y a pas de doc mais seulement des fichiers de démo qui essaient de montrer par étapes ce que fournit HWA.
Le premier retour reçu pointe un fichier de test qui n'a rien à voir avec le côté utilisateur de HWA pour dénoncer son illisibilité et l'absence de commentaire. On croirait une scène dans laquelle on remet un appareil à quelqu'un pour qu'il l'essaie mais qui au lieu de cela le démonte puis fait remarquer que l'appareil est salissant.
Second retour, on me dit qu'en regardant dans l'ordre demo-04.c puis demo-03.c, on comprend ce que fait le second grâce aux commentaires. La logique de l'approche qui consiste à commencer par la fin m'échappe.
Bien. J'ai clairement loupé ma présentation de HWA. Je n'ai rien à vendre, c'est du libre. Il me semble que ça peut rendre service et comme je n'ai pas l'intention de faire tous les portages possibles de HWA, je vous ai soumis cette présentation pour recueillir des avis et des critiques constructives sur le premier jet. J'aurais peut-être dû m'abstenir avant qu'une documentation exhaustive et en français ne soit disponible.
Je reste disponible pour répondre aux questions s'il y en a malgré mon comportement de douchebag .
« J'ai pas Word, j'ai pas Windows, et j'ai pas la télé ! »
[^] # Re: code code fait la poule
Posté par Christophe Duparquet (site web personnel) . En réponse au journal HWA : accéder au matériel autrement. Évalué à 0.
La question était : est-il bien nécessaire de passer du temps à créer des symboles pour des valeurs numériques de configuration si HWA fournit des fonctions permettant de ne pas avoir à manipuler des valeurs de bits. L'important ici n'était pas la signification de cette valeur particulière mais comment on affecte une valeur à un ensemble de bits.
Sur les commentaires dans le code, puisque cela semble être une question fondamentale, je considère qu'il est primordial pour la lisibilité d'un programme que les libellés soient correctement choisis pour les fonctions autant que pour les variables. HWA permet de remplacer des constructions à base d'affectations et d'opérateurs logiques qui nécessitent d'être commentées pour ne pas rester opaques par des instructions dont l'effet doit sembler évident à celui qui lit le code. Pour moi, les commentaires sont utiles pour expliquer pourquoi ou comment on fait les choses, pas pour expliquer le fonctionnement d'une fonction. S'il est nécessaire d'expliquer ce que fait une fonction, c'est que son libellé est mal choisi.
Je pourrais reprendre : « Ça sert a quoi de faire des fichiers de démo si les gens ne prennent même pas le temps de les lire ».
Il me semble avoir bien indiqué qu'il n'y a pas de doc mais seulement des fichiers de démo qui essaient de montrer par étapes ce que fournit HWA.
Le premier retour reçu pointe un fichier de test qui n'a rien à voir avec le côté utilisateur de HWA pour dénoncer son illisibilité et l'absence de commentaire. On croirait une scène dans laquelle on remet un appareil à quelqu'un pour qu'il l'essaie mais qui au lieu de cela le démonte puis fait remarquer que l'appareil est salissant.
Second retour, on me dit qu'en regardant dans l'ordre demo-04.c puis demo-03.c, on comprend ce que fait le second grâce aux commentaires. La logique de l'approche qui consiste à commencer par la fin m'échappe.
Bien. J'ai clairement loupé ma présentation de HWA. Je n'ai rien à vendre, c'est du libre. Il me semble que ça peut rendre service et comme je n'ai pas l'intention de faire tous les portages possibles de HWA, je vous ai soumis cette présentation pour recueillir des avis et des critiques constructives sur le premier jet. J'aurais peut-être dû m'abstenir avant qu'une documentation exhaustive et en français ne soit disponible.
Je reste disponible pour répondre aux questions s'il y en a malgré mon comportement de douchebag .
« J'ai pas Word, j'ai pas Windows, et j'ai pas la télé ! »