My PhD advisor rewrote himself in bash (2010)

Tooling and Alternatives

  • Many like the shell scripts for quick checks (passive voice, weasel words, duplicates), especially outside Emacs.
  • Others prefer integrated tools: Emacs modes, vale.sh, and classic Unix diction/style. Vale is praised for CI integration and configurable style rules.
  • A web UI port of the scripts appears useful but had early regex/context bugs; these were iteratively fixed.
  • Several argue LLMs could do richer, context-aware editing than brittle bash/regex, though one person reports LLMs missing obvious typos.

Adverbs, Weasel Words, and Nuance

  • Some strongly endorse stripping adverbs and “weasel words” (“quite”, “very”, “surprisingly”) to reduce fluff and vague claims.
  • Others counter that this often changes meaning: “quite difficult” ≠ “difficult”; “various methods” carries extra information.
  • There is extensive debate on “quite” in English: meanings range from “somewhat” to “completely” or sarcastic negation, depending on dialect and tone—making it risky in technical writing.
  • Critics suggest replacing beholder words with data and explicit comparisons (e.g., “3% vs expected 10%”) rather than emotional framing.

Technical Writing vs. Readability

  • Some readers of technical docs and papers plead for maximal concision and structure; flowery prose and soft qualifiers are seen as time-wasting.
  • Others insist slight “fluff” and qualifiers can prevent over-precision and better reflect messy reality (“very close” vs “close”).
  • A humanities-oriented view warns that rule-based scripts lack semantic understanding and may push blind prescription; tools should flag, not auto-edit.

Discipline-Specific Issues

  • In mathematics, there is a debate over whether “monotonically increasing” is redundant or clarifying compared to “increasing”; commenters give conflicting definitions and examples.
  • One thread contrasts expectations in medicine vs “hard sciences” about error bars and claims like “surprisingly low” rates.

Academia, Training, and Resources

  • Several note that in many fields, writing quality ranks below speaking skills and politics, though poor writing can still hurt reviews.
  • Multiple books and talks on mathematical/scientific writing are recommended as primary training, with linters as a final polish.