1 commentaires

 
GN⁺ 2024-12-15
Commentaire Hacker News
  • Les personnes qui ont aimé cet article devraient regarder [1] si elles veulent en savoir plus sur un processus efficace de rédaction de thèse. Cette vidéo est utile à toute personne souhaitant améliorer ses capacités de communication, et elle vaut même le coût d’un accès payant

  • Deux ressources qui m’ont aidé pour la rédaction de ma thèse étaient "How to Write Mathematics" de Paul R. Halmos et "Mathematical Writing" de Donald E. Knuth et al.

    • Le livre de Halmos aide à viser une communication claire et précise
    • Dans les notes de cours de Knuth et al., la suggestion "Bad/Better/OK" m’est particulièrement restée en mémoire
    • Le linter proposé comme troisième étape peut être utile lorsqu’il y a des erreurs
    • Ces ressources sont indispensables pour toute personne qui écrit sur des sujets comportant des définitions
  • Je ne suis pas d’accord avec beaucoup d’exemples

    • Par exemple, "très difficile" n’a pas le même sens que "difficile"
    • L’information selon laquelle diverses méthodes ont été utilisées disparaît dans la deuxième phrase
  • J’ai porté le script Bash vers une interface web afin qu’on puisse coller directement le code et voir le résultat

  • Avec vale.sh, on peut ajouter des règles de style

    • J’utilise une action GitHub qui exécute vale lors des PR
    • C’est utile pour faire respecter le style, même si je ne l’exploite pas entièrement
  • Au début d’Unix, il y avait les commandes <i>diction</i> et <i>style</i>, qui faisaient un travail similaire

    • On peut obtenir ces commandes chez GNU, et elles existent dans homebrew
    • Si je me souviens bien, elles n’étaient pas terribles, et ces programmes semblent offrir des performances comparables
  • Pour faire le marketing d’un article scientifique, il faut convaincre que l’idée mérite de recevoir des ressources

    • Comme le dit l’auteur, une simple coquille peut être le facteur décisif
    • Il faut accepter que les revues reflètent les goûts et opinions de l’éditeur, sans prétendre à l’objectivité
    • On peut tout publier dans des lieux de référence comme arxiv
  • Dans mon domaine, la qualité de l’écriture n’était pas le facteur le plus important

    • Pour un doctorant, il peut être plus utile de développer ses compétences en prise de parole en public qu’une écriture claire et concise
    • C’est particulièrement utile lorsqu’on fait face à des questions hostiles
  • Supprimer les adverbes dans toute documentation technique peut être positif

    • Stephen King n’aime pas non plus les adverbes
    • Cependant, supprimer tous les adverbes peut être difficile
    • Des adverbes comme "randomly" jouent un rôle important dans une phrase
  • Ressources liées :

    • <i>Shell scripts to improve your writing</i> - janv. 2017
    • <i>Shell scripts to improve your writing, or "My advisor rewrote himself in bash."</i> - juil. 2010