But then one day, I discovered that someone had blown away the custom emacs profile that I had gotten comfortable with. It took about a week for me to get it restored, and in the meantime, I switched to vi, and got hooked.
haaaa … ok. je n'avais pas compris le rapport entre le fait que le contenu d'un journal soit affiché sur la page des journaux et sa note.
Je trouve aussi que c'est pas la meilleure idée qui soit. A mon avis (étayé par rien du tout), les journaux dont la note pourraient osciller autour de 0 sont désavantagés, et tombent plus souvent dans le négatif qu'ils ne devraient avec ce système. Ça pourrait être pas mal un seuil avant le déclenchement du masquage (genre -10 ou -15).
à lire ton commentaire précédent, c'était pas flagrant que toi aussi tu interprétais cette phrase différemment "des benêts et des lâches".
Le fait que tout le monde interprète n'importe quoi n'importe comment ne me paraît pas justifier de détourner l'idée de départ dans une discussion argumentée. Tu peux déplorer que les gens qui s'en réclament explicitement le fasse souvent à tort, mais tu as aussi le droit de présenter ça comme ça au lieu d'utiliser une formulation à l'emporte pièce, qui, du coup, n'éclaire pas vraiment la discussion.
contresens absolu. Desproges ne dit pas qu'il ne faut pas rire d'un accident avec une victime d'un accident. Par contre, rire d'un accident avec un chauffard, c'est plus compliqué.
plutôt un appel à un peu de modération.
Évidement, il faut le virer, mais faut pas non plus en faire une jaunisse. C'était une connerie de choisir cette valeur hexa. Ça sent l'erreur de stagiaire ou de mec fatigué qui pète un peu les plombs, qui met n'importe quoi et qui oublie de repasser au propre.
On acquitte que c'était une connerie, on remplace par un truc sérieux, et pis voilà. Il y a p-e des endroits plus adaptés que le source du noyau pour combatte efficacement le sexisme.
Quand je vois combien de personne viennent aux réunions annuels des syndics de propriétés. Je me dis qu'il y en a qui trouve un peu facile de se défiler en permanence.
J'ai l'impression que ça varie beaucoup selon que le proprio habite ou investisse. (Les proprios habitants participent plus que les investisseurs). Y-a-t-il beaucoup d'investisseurs pour le syndic auquel tu penses ?
Je reformule, j'aurais du dire "zéro doc en tant que tel" plutôt que "zéro doc".
"You should always write your code as if comments didn't exist. This forces you to write your code in the simplest, plainest, most self-documenting way you can humanly come up with."
le commentaire explicite, c'est quand on n'a pas réussi à transmettre tout ce qu'il fallait mettre dans le code. Je trouve l'exemple dans l'article en lien ci dessus très parlant.
ça me rappelle aussi un peu le DOET The_Design_of_Everyday_Things. Je viens de farfouiller sur le net pour me rafraîchir la mémoire. Je pensais au chapitre 3. Knowledge in the Head and in the World". mais vaut mieux le lire in extenso, je trouve le résumé un peu aride.
Appliqué au dev, l'objet qu'en veut concevoir serait le code proprement dit, et le commentaire, le "knowledge in the world". Si on peut s'en passer, c'est mieux.
Le agile manifesto, en essayant de mettre tous les trolls de côté, est une liste de couple de "concepts" opposés. Ensuite, tout est dans la façon dont on équilibre la colonne de gauche et la colonne de droite. Pour certains, le bon équilibre concernant la doc, c'est pas de doc.
voilà j'espère quelques éléments de réflexions. Sur le plan personnel, je commente assez peu, et très très rarement sur des éléments techniques.
Pour finir, la seule documentation vraiment à jour, c'est le code !
tout est une question de l'endroit ou tu mets le curseur entre trop de doc et pas de doc. Dans certaines méthodes à Gilles, la règle, c'est zéro commentaire dans le code. (option "Si le code a besoin d'être commenté pour être compris, c'est du mauvais code")
Il faut distinguer la doc interne et la doc d'API à destinations de développeurs tiers. Si getTitle fait partie d'une interface externe, il faut la documenter au moins succinctement (ne serait-ce que pas un lapidaire "self explaining"). Si c'est un bout de doc interne à un module, perso, je ne documenterais pas, parce ce que le développeur qui coincerait déjà à ce niveau là, ce serait pas la peine qu'il regarde plus loin.
En fonction du contexte dans lequel est englobé ce bout de code, les 4 lignes de commentaires seront plus ou moins utiles. J'aurais tendance à dire plutôt moins, mais c'est un exemple un peu caricatural. Les IDEs qui génèrent des getter/setter en profitent parfois pour écrire les 3 lignes de doc qui vont avec.
concernant ton titre, cf mon commentaire plus haut. La doc obsolète, en plus d'être inutile, peut-être nuisible si on ne sait pas qu'elle est obsolète.
un journal bien touffu ma foi.
Concernant la doc, j'ai un peu honte de répondre avec un commentaire bookmark, mais je ne pourrais pas écrire mieux (et même j'en ai compris plus sur le sujet après l'avoir lu qu'avant).
Effets néfastes car quelqu'un de sensé a forcément plus de confiance dans les produits crées par des gens qui savent se tenir, argumenter et s'exprimer sans être grossier ou vulgaire.
mouais … je me considère comme relativement sensé, et à choisir entre l'avis d'un gars qui consacre sa vie à un projet qui le passionne et d'un porte parole d'une multinationale, je ferais plutôt confiance au premier, même s'il est parfois grossier.
Mais je t'accorde que sur ce domaine, je suis un initié. J'ai donc vérifié il y a quelques jours sur les fils de news google (en et fr): l'incident est repris principalement sur des sites de techos. A part un petit article sur 20minutes.fr ou équivalent et un article d'un lecture sur le site du nouvel obs, je n'ai vu aucune reprise dans les media grand public. Dans le Monde, il y a un article qui parle de Torvalds, mais pas de bol, c'est pour le fait qu'il aie remporté le Millenium Prize, qui devrait avoir assez peu d'effets négatifs.
Du coup, l'effet néfaste éventuel, je demande à voir. En tout cas, ça m'étonnerait que la courbe de vente des téléphones sous Android soit beaucoup impactée.
oui. Par chez moi, 66 % d'abstention au second tour, mais quand il ne reste plus qu'un seul candidat parce que le second s'est désisté, ça se comprend. Ça serait plus parlant d'avoir le pourcentage d'abstention en ne prenant en compte que les circonscriptions où il y avait au moins deux candidats au second tour.
Si ton employeur insiste lourdement sur cet aspect des choses, tu peux désarmer ça en montrant ta bonne foi: soit en remettant ton e-mail pro à la place du perso, soit en l'attribuant à un alias e-mail de ta boite (ce qu'il aurait en fait été bien de faire dès le début si ton employeur avait vraiment eu envie de continuer sur ce projet).
à te lire, j'ai quand même du mal à comprendre la position de ton employeur qui trouve d'un seul coup que c'est projet super important qui lui appartient alors qu'il en a rien eu à battre pendant longtemps. Qu'aurait-il dit si tu avais abordé le sujet il y a 3 mois, c'est à dire avant qu'on te contacte pour proposer un contrat de support ?
est-ce qu'il est toujours aussi motivé pour investir là dessus si tu lui annonces que tu laisses tomber ?
bref, je vois le mal partout chez les méchants patrons ;-)
ou alors, faudrait vraiment que son poste pro n'était plus du tout sur ce projet par exemple, de manière explicite
c'est ce qu'il ressort de son explication. Une fois la livraison faite au client, hors un peu de support, le projet est tombé dans l'apathie. Même sans que ça soit explicite, il suffirait de montrer que ses tâches professionnelles ultérieures l'occupait à temps plein, ce qui ne laissait que le temps perso pour travailler sur ce projet.
[^] # Re: ◉ Aucun
Posté par gaaaaaAab . En réponse au sondage Avez-vous migré vers Gnome 3 ?. Évalué à 10.
ça me rappelle une petite anecdote :-)
[^] # Re: Il ne faut pas renverser la charge de la preuve
Posté par gaaaaaAab . En réponse au journal Du mauvais usage de la notation sur linuxfr. Évalué à 5.
haaaa … ok. je n'avais pas compris le rapport entre le fait que le contenu d'un journal soit affiché sur la page des journaux et sa note.
Je trouve aussi que c'est pas la meilleure idée qui soit. A mon avis (étayé par rien du tout), les journaux dont la note pourraient osciller autour de 0 sont désavantagés, et tombent plus souvent dans le négatif qu'ils ne devraient avec ce système. Ça pourrait être pas mal un seuil avant le déclenchement du masquage (genre -10 ou -15).
[^] # Re: sexisme ou blague ?
Posté par gaaaaaAab . En réponse au journal B16B00B5 : Sexisme dans le source du Kernel. Évalué à 3.
c'est pas du tout ça. cf commentaire précédent.
[^] # Re: sexisme ou blague ?
Posté par gaaaaaAab . En réponse au journal B16B00B5 : Sexisme dans le source du Kernel. Évalué à 2.
à lire ton commentaire précédent, c'était pas flagrant que toi aussi tu interprétais cette phrase différemment "des benêts et des lâches".
Le fait que tout le monde interprète n'importe quoi n'importe comment ne me paraît pas justifier de détourner l'idée de départ dans une discussion argumentée. Tu peux déplorer que les gens qui s'en réclament explicitement le fasse souvent à tort, mais tu as aussi le droit de présenter ça comme ça au lieu d'utiliser une formulation à l'emporte pièce, qui, du coup, n'éclaire pas vraiment la discussion.
[^] # Re: sexisme ou blague ?
Posté par gaaaaaAab . En réponse au journal B16B00B5 : Sexisme dans le source du Kernel. Évalué à 4.
contresens absolu. Desproges ne dit pas qu'il ne faut pas rire d'un accident avec une victime d'un accident. Par contre, rire d'un accident avec un chauffard, c'est plus compliqué.
[^] # Re: sexisme ou blague ?
Posté par gaaaaaAab . En réponse au journal B16B00B5 : Sexisme dans le source du Kernel. Évalué à 6.
comme un vrai homme ;-)
[^] # Re: C'est SQL mais pas sexiste.
Posté par gaaaaaAab . En réponse au journal B16B00B5 : Sexisme dans le source du Kernel. Évalué à 2.
plutôt un appel à un peu de modération.
Évidement, il faut le virer, mais faut pas non plus en faire une jaunisse. C'était une connerie de choisir cette valeur hexa. Ça sent l'erreur de stagiaire ou de mec fatigué qui pète un peu les plombs, qui met n'importe quoi et qui oublie de repasser au propre.
On acquitte que c'était une connerie, on remplace par un truc sérieux, et pis voilà. Il y a p-e des endroits plus adaptés que le source du noyau pour combatte efficacement le sexisme.
[^] # Re: pas glop
Posté par gaaaaaAab . En réponse au journal La définition de démocratie, quelle est-elle selon vous ?. Évalué à 3.
ah ok. désolé, l'avait pô compris.
[^] # Re: Démocratie directe
Posté par gaaaaaAab . En réponse au journal La définition de démocratie, quelle est-elle selon vous ?. Évalué à 3.
J'ai l'impression que ça varie beaucoup selon que le proprio habite ou investisse. (Les proprios habitants participent plus que les investisseurs). Y-a-t-il beaucoup d'investisseurs pour le syndic auquel tu penses ?
[^] # Re: pas glop
Posté par gaaaaaAab . En réponse au journal La définition de démocratie, quelle est-elle selon vous ?. Évalué à 2.
oui, et ?
[^] # Re: Le titre est trop long
Posté par gaaaaaAab . En réponse au journal Typage statique versus typage dynamique. Évalué à 3.
tout langage est trop permissif :-)
[^] # Re: Organisation de GitHub
Posté par gaaaaaAab . En réponse au journal De tout, de rien, des liens, bla bla bla. Évalué à 3.
je traduirais ça par "heures sup" plutôt que le fait d'être en dehors des plages horaires.
oui !
[^] # Re: La doc est toujours utile
Posté par gaaaaaAab . En réponse au journal De tout, de rien, des liens, bla bla bla. Évalué à 3.
Je reformule, j'aurais du dire "zéro doc en tant que tel" plutôt que "zéro doc".
le commentaire explicite, c'est quand on n'a pas réussi à transmettre tout ce qu'il fallait mettre dans le code. Je trouve l'exemple dans l'article en lien ci dessus très parlant.
ça me rappelle aussi un peu le DOET The_Design_of_Everyday_Things. Je viens de farfouiller sur le net pour me rafraîchir la mémoire. Je pensais au chapitre 3. Knowledge in the Head and in the World". mais vaut mieux le lire in extenso, je trouve le résumé un peu aride.
Appliqué au dev, l'objet qu'en veut concevoir serait le code proprement dit, et le commentaire, le "knowledge in the world". Si on peut s'en passer, c'est mieux.
Le agile manifesto, en essayant de mettre tous les trolls de côté, est une liste de couple de "concepts" opposés. Ensuite, tout est dans la façon dont on équilibre la colonne de gauche et la colonne de droite. Pour certains, le bon équilibre concernant la doc, c'est pas de doc.
voilà j'espère quelques éléments de réflexions. Sur le plan personnel, je commente assez peu, et très très rarement sur des éléments techniques.
Pour finir, la seule documentation vraiment à jour, c'est le code !
[^] # Re: Et ben…
Posté par gaaaaaAab . En réponse au journal De tout, de rien, des liens, bla bla bla. Évalué à 10.
gaffe quand même. On va finir par t'appeler CrEv_g ;-)
[^] # Re: La doc est toujours utile
Posté par gaaaaaAab . En réponse au journal De tout, de rien, des liens, bla bla bla. Évalué à 4.
tout est une question de l'endroit ou tu mets le curseur entre trop de doc et pas de doc. Dans certaines méthodes à Gilles, la règle, c'est zéro commentaire dans le code. (option "Si le code a besoin d'être commenté pour être compris, c'est du mauvais code")
Il faut distinguer la doc interne et la doc d'API à destinations de développeurs tiers. Si getTitle fait partie d'une interface externe, il faut la documenter au moins succinctement (ne serait-ce que pas un lapidaire "self explaining"). Si c'est un bout de doc interne à un module, perso, je ne documenterais pas, parce ce que le développeur qui coincerait déjà à ce niveau là, ce serait pas la peine qu'il regarde plus loin.
En fonction du contexte dans lequel est englobé ce bout de code, les 4 lignes de commentaires seront plus ou moins utiles. J'aurais tendance à dire plutôt moins, mais c'est un exemple un peu caricatural. Les IDEs qui génèrent des getter/setter en profitent parfois pour écrire les 3 lignes de doc qui vont avec.
concernant ton titre, cf mon commentaire plus haut. La doc obsolète, en plus d'être inutile, peut-être nuisible si on ne sait pas qu'elle est obsolète.
# doc
Posté par gaaaaaAab . En réponse au journal De tout, de rien, des liens, bla bla bla. Évalué à 2.
un journal bien touffu ma foi.
Concernant la doc, j'ai un peu honte de répondre avec un commentaire bookmark, mais je ne pourrais pas écrire mieux (et même j'en ai compris plus sur le sujet après l'avoir lu qu'avant).
[^] # Re: Déçu et impact négatif.
Posté par gaaaaaAab . En réponse au journal Quand Linus énervé, Linus faire ça !. Évalué à 4.
mouais … je me considère comme relativement sensé, et à choisir entre l'avis d'un gars qui consacre sa vie à un projet qui le passionne et d'un porte parole d'une multinationale, je ferais plutôt confiance au premier, même s'il est parfois grossier.
Mais je t'accorde que sur ce domaine, je suis un initié. J'ai donc vérifié il y a quelques jours sur les fils de news google (en et fr): l'incident est repris principalement sur des sites de techos. A part un petit article sur 20minutes.fr ou équivalent et un article d'un lecture sur le site du nouvel obs, je n'ai vu aucune reprise dans les media grand public. Dans le Monde, il y a un article qui parle de Torvalds, mais pas de bol, c'est pour le fait qu'il aie remporté le Millenium Prize, qui devrait avoir assez peu d'effets négatifs.
Du coup, l'effet néfaste éventuel, je demande à voir. En tout cas, ça m'étonnerait que la courbe de vente des téléphones sous Android soit beaucoup impactée.
[^] # Re: Merci !
Posté par gaaaaaAab . En réponse au journal Relations entre projet libre et entreprise. Évalué à 3.
note l'échelle de temps: dans "quelques dizaines d'années", je pense qu'il y aura prescription !
[^] # Re: Merci !
Posté par gaaaaaAab . En réponse au journal Relations entre projet libre et entreprise. Évalué à 5.
et un journal dans quelques dizaines d'années pour qu'on sache enfin de quel projet il s'agit ? ;-)
[^] # Re: Pour les vieux tromblons...
Posté par gaaaaaAab . En réponse au message Quelles distributions choisir? (Débutant). Évalué à 3.
paf dans l'actu
un article sur osnews sur le sujet (pour anglophone)
[^] # Re: j'ai voté au 1er, me suis abstenu au 2nd
Posté par gaaaaaAab . En réponse au journal A propos du devoir électoral. Évalué à 9.
j'ai dépouillé pour la première fois ce we, et c'est vrai que le bulletin pour Chewbacca, c'était assez fendard !
[^] # Re: Ah
Posté par gaaaaaAab . En réponse au journal A propos du devoir électoral. Évalué à 6.
oui. Par chez moi, 66 % d'abstention au second tour, mais quand il ne reste plus qu'un seul candidat parce que le second s'est désisté, ça se comprend. Ça serait plus parlant d'avoir le pourcentage d'abstention en ne prenant en compte que les circonscriptions où il y avait au moins deux candidats au second tour.
[^] # Re: Regardez la vidéo en entier
Posté par gaaaaaAab . En réponse au journal Quand Linus énervé, Linus faire ça !. Évalué à 3.
petit contresens sur la fin. cf ce commentaire
[^] # Re: Qui est le patron
Posté par gaaaaaAab . En réponse au journal Relations entre projet libre et entreprise. Évalué à 6.
nan mais faut relativiser un peu aussi.
Si ton employeur insiste lourdement sur cet aspect des choses, tu peux désarmer ça en montrant ta bonne foi: soit en remettant ton e-mail pro à la place du perso, soit en l'attribuant à un alias e-mail de ta boite (ce qu'il aurait en fait été bien de faire dès le début si ton employeur avait vraiment eu envie de continuer sur ce projet).
à te lire, j'ai quand même du mal à comprendre la position de ton employeur qui trouve d'un seul coup que c'est projet super important qui lui appartient alors qu'il en a rien eu à battre pendant longtemps. Qu'aurait-il dit si tu avais abordé le sujet il y a 3 mois, c'est à dire avant qu'on te contacte pour proposer un contrat de support ?
est-ce qu'il est toujours aussi motivé pour investir là dessus si tu lui annonces que tu laisses tomber ?
bref, je vois le mal partout chez les méchants patrons ;-)
[^] # Re: Qui est le patron
Posté par gaaaaaAab . En réponse au journal Relations entre projet libre et entreprise. Évalué à 4.
c'est ce qu'il ressort de son explication. Une fois la livraison faite au client, hors un peu de support, le projet est tombé dans l'apathie. Même sans que ça soit explicite, il suffirait de montrer que ses tâches professionnelles ultérieures l'occupait à temps plein, ce qui ne laissait que le temps perso pour travailler sur ce projet.