nprofile1qyt8wumn8ghj7un9d3shjtnyd968gmewwp6kytcqypay0tqsy7t7w3xx0awdm729emg7fs6m9trwtjxplzd4e460kgszy54zemh (nprofile…zemh) s/Linux/tout/ ?
À un moment où je m'étais mis en tête de contribuer au site de documentation sur le packaging Python, je me rappelle de questions « votre doc dit de faire ça, mais sur cette réponse StackOverflow d'il y a 7 ans, je trouve autre chose, quelle est la bonne méthode ? ».
Il y a plein de problèmes qui se superposent :
(1) les gens n'aiment pas lire la doc, mais aussi
(2) la doc est souvent merdique voire inexistante, et on s'est structurellement habitués à ce que ce soit la normalité, et
(3) quand elle est détaillée, elle est au contraire trop technique pour le néophyte (rares sont les logiciels qui ont une doc introductive accessible ET une doc technique détaillée),
(4) les gens écrivent des choses dans leur propre doc au lieu de pointer vers la doc canonique (“voici les instructions pour installer bidule <commandes qui ne marchent que sur une config et sont obsolètes deux ans plus tard>” au lieu de “voir <lien> pour les instructions officielles sur l'installation de paquets en $LANGAGE”),
(5) le Web est saturé de sites à la con optimisés en SEO qui veulent te faire regarder un maximum de pub avant de trouver ta malheureuse commande, et maintenant d'AI slop.
Jean Abou Samra (new account)
npub14p…htzwd
2025-10-25 20:39:48 UTC
in reply to nevent1q…l9fs
Author Public Key
npub14pv6xjcsz2qa6tctew034s5wsj5p2xuh65q86qe6gpegaslstc6qjhtzwdSeen on
wss://relay.ditto.pubPublished at
2025-10-25 20:39:48 UTCEvent JSON
{
"id": "d425423c7b1afeb3e181a3f51ced86b89a28712df6c66ea314ca6af57c3835d2",
"pubkey": "a859a34b101281dd2f0bcb9f1ac28e84a8151b97d5007d033a40728ec3f05e34",
"created_at": 1761424788,
"kind": 1,
"tags": [
[
"p",
"7a47ac102797e744c67f5cddf945ced1e4c35b2ac6e5c8c1f89b5cd74fb22022",
"wss://relay.ditto.pub/"
],
[
"p",
"e85f36b0d1fcf03617a0a98996cfdfe4f28c44d12447543bc606d2733d61a2ca",
"wss://relay.ditto.pub/"
],
[
"e",
"b1cc1a99ff768ef74c85522bd566420c6cd96fa1f20b3914b6770babd95aed32",
"wss://relay.ditto.pub/",
"reply"
],
[
"proxy",
"https://mathstodon.xyz/users/jeanas/statuses/115436734963697750",
"activitypub"
],
[
"client",
"Mostr",
"31990:6be38f8c63df7dbf84db7ec4a6e6fbbd8d19dca3b980efad18585c46f04b26f9:mostr",
"wss://relay.ditto.pub/"
]
],
"content": "nostr:nprofile1qyt8wumn8ghj7un9d3shjtnyd968gmewwp6kytcqypay0tqsy7t7w3xx0awdm729emg7fs6m9trwtjxplzd4e460kgszy54zemh s/Linux/tout/ ?\n\nÀ un moment où je m'étais mis en tête de contribuer au site de documentation sur le packaging Python, je me rappelle de questions « votre doc dit de faire ça, mais sur cette réponse StackOverflow d'il y a 7 ans, je trouve autre chose, quelle est la bonne méthode ? ».\n\nIl y a plein de problèmes qui se superposent :\n\n(1) les gens n'aiment pas lire la doc, mais aussi\n\n(2) la doc est souvent merdique voire inexistante, et on s'est structurellement habitués à ce que ce soit la normalité, et\n\n(3) quand elle est détaillée, elle est au contraire trop technique pour le néophyte (rares sont les logiciels qui ont une doc introductive accessible ET une doc technique détaillée),\n\n(4) les gens écrivent des choses dans leur propre doc au lieu de pointer vers la doc canonique (“voici les instructions pour installer bidule \u003ccommandes qui ne marchent que sur une config et sont obsolètes deux ans plus tard\u003e” au lieu de “voir \u003clien\u003e pour les instructions officielles sur l'installation de paquets en $LANGAGE”),\n\n(5) le Web est saturé de sites à la con optimisés en SEO qui veulent te faire regarder un maximum de pub avant de trouver ta malheureuse commande, et maintenant d'AI slop.",
"sig": "13e65c2bede7c4a46ee0c22de6bec6fb8337505912bc91e3b842d4507495b8c1674ef0fa6b8bd90ff8a8307d906800a138e27bb7dba01b6920d70e776a962f7b"
}