Skip to main content

Show, Don't Tell

Inbox

  • https://recursion.slack.com/archives/D03LD0P3J11/p1668615491319809
  • Applies to code reviews as well
  • App.js refactor PR
  • Had long, loooooooong PR discussions in English and couldn’t align
  • Another reviewer made a small code suggestion (in code) and we all immediately agreed
  • Show, don’t tell
  • Discuss code in code, not English whenever possible
  • The English discussion opened up a broader tangent about coding “rules” and other dogma that was a lot to articulate and understand
  • A quick draft PR showing a two-file code change suggestion required no English and made perfect sense and skipped all the “should”ing and debatable philosophy stuff