Depuis longtemps, ils n'arrêtent pas de sortir toutes sortes de kits avec une foule de fonctionnalités gadgets complètement inutiles, comme si c'était quelque chose d'extraordinaire... fidèle à Apple, en effet. Un vrai cadeau empoisonné.
C’est un contexte un peu différent, mais si l’enfer des tutoriels se produit, c’est aussi parce que les tutoriels de framework ne sont pas utilisés comme des supports de formation de base en informatique.
Un débutant qui a suivi le tutoriel Django et créé une application de sondage ne peut pas, à lui seul, créer un blog, parce que le tutoriel Django est un texte destiné à expliquer Django à des personnes qui savent déjà ce qu’est HTTP, ce que sont les templates, ce qu’est WS, ce qu’est une base de données, etc. ; ce n’est pas un texte qui explique le web. Un très grand nombre de contextes sont omis dans le tutoriel Django, et je pense que c’est peut-être l’une des causes de l’enfer des tutoriels.
Réécrire le tutoriel Django pour qu’il s’adresse à quelqu’un qui programme pour la toute première fois aujourd’hui serait aussi un exercice intéressant. En commençant par expliquer d’abord la structure de HTTP, puis en montrant comment Django gère chacun de ces éléments, par exemple.
J’utilise le Wi-Fi gigabit de KT, et comme la bande du canal était réglée sur 80 MHz, j’ai comparé les résultats de networkQuality de macOS en la passant à 40 MHz. Dans mon cas, quand je la mets à 40, la réactivité comme les performances chutent nettement.
Je me suis dit qu’il devait y avoir quelques autres cas de ce genre, alors j’ai essayé diverses choses. Ce n’est pas cohérent, mais il arrive parfois que l’étoile de mer (starfish) tombe elle aussi dans une boucle. Si on répète l’essai, même sans boucle, on obtient au moins quelques réponses qui montrent qu’il est désorienté. En revanche, il faut poser la question en anglais, pas en coréen. J’imagine que la combinaison de deux mots (Star + Fish) et le fait que ce soit un animal qui pourrait plausiblement exister en emoji sont probablement la clé haha.
Je croyais que j’étais le seul à être trop bête pour comprendre la doc officielle mdr.
Franchement, il suffit de balancer un vrai exemple avec juste un peu d’explication, et on comprend tout de suite…
PHP serait à la fois un bon exemple et le pire exemple.
C’est un bon exemple dans la mesure où la documentation officielle permet de publier du contenu contribué par les utilisateurs, ce qui permet de consulter divers exemples de code,
...mais c’est aussi le pire exemple, parce que PHP a beaucoup de subtilités de compatibilité ascendante dans ses fonctions intégrées, et que les contributions d’exemples datent toutes de Mathusalem, si bien qu’on y trouve des choses subtilement différentes du comportement réel, ce qui ne fait qu’ajouter à la confusion... lol..
Dans les anciennes documentations de développement iOS ou Cocoa, il y avait une section de cas d’usage distincte ; n’est-ce pas la bonne manière de documenter ? Il faut tout : des exemples, les signatures de fonctions et l’explication du fonctionnement.
Si autrefois la pauvreté de la documentation officielle était compensée par Stack Overflow et les recherches Google, aujourd’hui ce sont les LLM qui semblent combler ce manque.
En voyant les commentaires, certains disent sur un ton que c’était déjà comme ça avant, mais à mon avis ce n’est qu’une excuse. Une fuite de mémoire est un problème qu’on peut clairement détecter en faisant tourner le programme ne serait-ce qu’un minimum de temps, donc cela veut dire qu’ils ne l’ont même pas fait, et ça a quand même quelque chose d’assez ahurissant.
Je pense que ce n’est encore que le début. Si l’on entre dans un monde où l’IA peut désormais être directement reliée à des actions physiques et même à des transactions financières, on pourrait alors assister à une catastrophe majeure.
J’aimerais qu’ils améliorent un peu la stabilité de l’Explorateur de Windows 11.
Ce serait bien aussi que le détachement des onglets soit aussi rapide et fluide que dans un navigateur Chromium..
Dans l’écosystème Java et dans la culture orientée objet, il y a eu particulièrement beaucoup de phrases explicatives dénuées de sens et de documentation formelle, et les frameworks de l’écosystème Python qui ont hérité de cette ambiance sont eux aussi particulièrement pauvres en exemples.
Exemple de documentation dénuée de sens
add(left, right) - additionne l’opérande de gauche et l’opérande de droite
En revanche, ils n’expliquent pas les éléments vraiment importants, comme le type de données des paramètres, les exceptions pouvant être renvoyées, la forme de la valeur de retour ou la structure de fonctionnement.
Avec quelque chose comme les man pages du langage C, même une brève explication suffit pour pouvoir l’utiliser, ne serait-ce qu’en le déduisant à partir du nom de la fonction et des paramètres.
J’aime les deux outils. Ils ont des écosystèmes et des objectifs qui se recoupent en partie, mais ce ne sont pas exactement les mêmes outils, donc on ne devrait pas les juger selon leur niveau de difficulté. Avec vite, on peut écrire des scripts de manière très large et très fine. Stimulus ou Hotwire sont plutôt mieux adaptés pour minimiser le développement de scripts.
Le code est la documentation : venez chez Go~
Chez nous, on développe en épluchant les tests, même sans README
Depuis longtemps, ils n'arrêtent pas de sortir toutes sortes de kits avec une foule de fonctionnalités gadgets complètement inutiles, comme si c'était quelque chose d'extraordinaire... fidèle à Apple, en effet. Un vrai cadeau empoisonné.
C’est un contexte un peu différent, mais si l’enfer des tutoriels se produit, c’est aussi parce que les tutoriels de framework ne sont pas utilisés comme des supports de formation de base en informatique.
Un débutant qui a suivi le tutoriel Django et créé une application de sondage ne peut pas, à lui seul, créer un blog, parce que le tutoriel Django est un texte destiné à expliquer Django à des personnes qui savent déjà ce qu’est HTTP, ce que sont les templates, ce qu’est WS, ce qu’est une base de données, etc. ; ce n’est pas un texte qui explique le web. Un très grand nombre de contextes sont omis dans le tutoriel Django, et je pense que c’est peut-être l’une des causes de l’enfer des tutoriels.
Réécrire le tutoriel Django pour qu’il s’adresse à quelqu’un qui programme pour la toute première fois aujourd’hui serait aussi un exercice intéressant. En commençant par expliquer d’abord la structure de HTTP, puis en montrant comment Django gère chacun de ces éléments, par exemple.
J’utilise le Wi-Fi gigabit de KT, et comme la bande du canal était réglée sur 80 MHz, j’ai comparé les résultats de
networkQualityde macOS en la passant à 40 MHz. Dans mon cas, quand je la mets à 40, la réactivité comme les performances chutent nettement.Datastar - un framework hypermédia léger pour créer des applications web interactives
Je me suis dit qu’il devait y avoir quelques autres cas de ce genre, alors j’ai essayé diverses choses. Ce n’est pas cohérent, mais il arrive parfois que l’étoile de mer (starfish) tombe elle aussi dans une boucle. Si on répète l’essai, même sans boucle, on obtient au moins quelques réponses qui montrent qu’il est désorienté. En revanche, il faut poser la question en anglais, pas en coréen. J’imagine que la combinaison de deux mots (Star + Fish) et le fait que ce soit un animal qui pourrait plausiblement exister en emoji sont probablement la clé haha.
Conversation ChatGPT
Évitez Ryanair quoi qu’il arrive… c’est le pire.
Settings > Accessibility > Display & Text Size > Reduce Transparency
Settings > Accessibility > Display & Text Size > Increase Contrast
Settings > Accessibility > Display & Text Size > Differentiate Without Colour
Ces réglages m’ont sauvé la vie
Je croyais que j’étais le seul à être trop bête pour comprendre la doc officielle mdr.
Franchement, il suffit de balancer un vrai exemple avec juste un peu d’explication, et on comprend tout de suite…
PHP serait à la fois un bon exemple et le pire exemple.
C’est un bon exemple dans la mesure où la documentation officielle permet de publier du contenu contribué par les utilisateurs, ce qui permet de consulter divers exemples de code,
...mais c’est aussi le pire exemple, parce que PHP a beaucoup de subtilités de compatibilité ascendante dans ses fonctions intégrées, et que les contributions d’exemples datent toutes de Mathusalem, si bien qu’on y trouve des choses subtilement différentes du comportement réel, ce qui ne fait qu’ajouter à la confusion... lol..
C’est bien.
Dans les anciennes documentations de développement iOS ou Cocoa, il y avait une section de cas d’usage distincte ; n’est-ce pas la bonne manière de documenter ? Il faut tout : des exemples, les signatures de fonctions et l’explication du fonctionnement.
Sur le moment, je me suis demandé de quoi il s’agissait mdr
Les exemples sont la meilleure documentation.
Si autrefois la pauvreté de la documentation officielle était compensée par Stack Overflow et les recherches Google, aujourd’hui ce sont les LLM qui semblent combler ce manque.
En voyant les commentaires, certains disent sur un ton que c’était déjà comme ça avant, mais à mon avis ce n’est qu’une excuse. Une fuite de mémoire est un problème qu’on peut clairement détecter en faisant tourner le programme ne serait-ce qu’un minimum de temps, donc cela veut dire qu’ils ne l’ont même pas fait, et ça a quand même quelque chose d’assez ahurissant.
Je pense que ce n’est encore que le début. Si l’on entre dans un monde où l’IA peut désormais être directement reliée à des actions physiques et même à des transactions financières, on pourrait alors assister à une catastrophe majeure.
J’aimerais qu’ils améliorent un peu la stabilité de l’Explorateur de Windows 11.
Ce serait bien aussi que le détachement des onglets soit aussi rapide et fluide que dans un navigateur Chromium..
Les exemples sont la meilleure documentation
Dans l’écosystème Java et dans la culture orientée objet, il y a eu particulièrement beaucoup de phrases explicatives dénuées de sens et de documentation formelle, et les frameworks de l’écosystème Python qui ont hérité de cette ambiance sont eux aussi particulièrement pauvres en exemples.
Exemple de documentation dénuée de sens
add(left, right) - additionne l’opérande de gauche et l’opérande de droite
En revanche, ils n’expliquent pas les éléments vraiment importants, comme le type de données des paramètres, les exceptions pouvant être renvoyées, la forme de la valeur de retour ou la structure de fonctionnement.
Avec quelque chose comme les man pages du langage C, même une brève explication suffit pour pouvoir l’utiliser, ne serait-ce qu’en le déduisant à partir du nom de la fonction et des paramètres.
Ils n’ont toujours pas vraiment repris leurs esprits.
Pour les NVMe, la politique est encore maintenue..
J’aime les deux outils. Ils ont des écosystèmes et des objectifs qui se recoupent en partie, mais ce ne sont pas exactement les mêmes outils, donc on ne devrait pas les juger selon leur niveau de difficulté. Avec vite, on peut écrire des scripts de manière très large et très fine. Stimulus ou Hotwire sont plutôt mieux adaptés pour minimiser le développement de scripts.