Excellent content written in the worst possible way. The deliberately bad language is fun for a few sentences, but quickly becomes painfully obfuscating. Ironic for something that advocates reduced complexity.

  • avoid complex implementations (because they are unmaintainable)
    • if unavoidable (due to business requirements), then try to be as minimal as possible - only make an MVP or even just 80% of an MVP
  • readability/maintainability is far more important than DRY, and more important than “does it work” (!) (if others can understand it they can fix it)
  • don’t obsess over layout/(re)factoring too early in a project, otherwise you may pick an inappropriate layout which will harm long-term development
  • when more mature, try to keep refactoring PRs small & incremental
  • don’t overdo closures
  • don’t prematurely optimise
  • simpler is better for concurrency models (e.g. stateless request handlers & job queues with no inter-dependencies)
  • if you’re exploring/prototyping (i.e. don’t yet fully understand the problem/use case) then avoid test-driven-development
  • write tests after prototyping
  • unit tests often too tiny, end-to-end often too vague/big/flaky. Try in-between (integration) tests instead, i.e. test interfaces between units
  • avoid mocking
  • when a bug is reported, write a test for it before fixing it
  • don’t be over-zealous about dev processes (agile isn’t always perfect)
  • don’t delete code you don’t understand. Understand it, decide it’s bad, then delete
  • master debugging tools
  • (:warning: random opinion) typing is mostly about helping autocompletion than helping guarantee correctness
  • (:warning: loaded opinion, worth its own TL;DR) SoC might miss the point, LoB might be better
  • (:warning: loaded opinion) the visitor pattern is bad
  • (:warning: loaded opinion) splitting dev into FrontEnd and BackEnd causes unnecessary duplication of efforts
  • log a lot, especially for cloud apps
    • major logic branches (if/for)
    • request IDs (to trace across a network)
    • ideally dynamically controlled verbosity
    • ideally per-user controlled verbosity
  • design APIs thinking of their use (rather than implementation/domain). KISS and remember the MVP
  • be sceptical of an revolutionary idea. It’s probably been tried before & failed
  • better to ask for help than live in FOLD (fear of looking dumb)/impostor syndrome