1 Kommentare

 
GN⁺ 2024-12-15
Hacker-News-Kommentare
  • Wer diesen Artikel mag und mehr über einen effektiven Schreibprozess für Dissertationen erfahren möchte, sollte sich [1] ansehen. Dieses Video ist für alle nützlich, die ihre Kommunikationsfähigkeiten verbessern möchten, und auch kostenpflichtig sehenswert.

  • Zwei Ressourcen, die beim Schreiben von Arbeiten hilfreich waren, sind Paul R. Halmos’ "How to Write Mathematics" und Donald E. Knuth u. a. "Mathematical Writing"

    • Halmos’ Buch hilft dabei, klare und präzise Kommunikation anzustreben
    • Aus den Vorlesungsunterlagen von Knuth u. a. ist besonders der Vorschlag "Bad/Better/OK" in Erinnerung geblieben
    • Der als dritter Schritt vorgeschlagene Linter kann nützlich sein, wenn Fehler auftreten
    • Diese Materialien sind für alle unverzichtbar, die über Themen mit Definitionen schreiben
  • Ich stimme vielen Beispielen nicht zu

    • Zum Beispiel hat "sehr schwierig" eine andere Bedeutung als "schwierig"
    • Die Information, dass verschiedene Methoden verwendet wurden, fehlt im zweiten Satz
  • Das Bash-Skript wurde in eine Web-UI portiert, sodass man den Code direkt einfügen und das Ergebnis ansehen kann

  • Mit vale.sh kann man Stilrichtlinien hinzufügen

    • Es wird eine GitHub Action verwendet, die vale bei PRs ausführt
    • Nützlich, um Stil durchzusetzen, aber nicht vollständig ausgeschöpft
  • In frühem Unix gab es die Befehle <i>diction</i> und <i>style</i>, die Ähnliches taten

    • Diese Befehle sind bei GNU erhältlich und in homebrew vorhanden
    • Soweit ich mich erinnere, waren sie nicht besonders gut, und diese Programme scheinen ähnlich abzuschneiden
  • Um eine Arbeit zu vermarkten, muss man überzeugen, dass die Idee es wert ist, Ressourcen dafür einzusetzen

    • Wie der Autor sagt, können triviale Tippfehler den Ausschlag geben
    • Man sollte nicht vorgeben, objektiv zu sein, sondern akzeptieren, dass Journale die Vorlieben und Meinungen der Herausgeber widerspiegeln
    • Man kann alles an Standardorten wie arxiv veröffentlichen
  • In meinem Fachgebiet war die Qualität des Schreibens nicht am wichtigsten

    • Für Doktoranden könnte es sinnvoller sein, Fähigkeiten im öffentlichen Sprechen zu entwickeln als klares und prägnantes Schreiben
    • Besonders nützlich, wenn man mit feindseligen Fragen konfrontiert wird
  • Das Entfernen von Adverbien aus aller technischer Dokumentation könnte positiv sein

    • Auch Stephen King mag keine Adverbien
    • Allerdings kann es schwierig sein, alle Adverbien zu entfernen
    • Adverbien wie "randomly" spielen im Satz eine wichtige Rolle
  • Verwandte Materialien:

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