‹ BackHN Continuity

Thread

I don't want to read what you didn't write

1070 points · 460 comments · mooreds

  1. zmmmmm · · focus · HN ↗
    It's funny, i push back on pull requests because there is too much description now - a 20 line change has pages and pages of generated description, rationalisation for why it is safe, defense of each design decision, analysis of risks and side effects. People are indignant, you're rejecting my change because there is too much documentation? And my response is, I don't have time to read it and you put me in the position where I can't afford not to - because approving the PR implies I did and accepted it. The investment to read all that for the value of a code change that I'm one prompt away from doing myself if I cared is just not high enough. So it's rejected.
    1. Sharlin · · focus · HN ↗
      Maximizing the amount of documentation was never the goal, and people who assume that have entirely misunderstood what the point of documentation is.
Open on Hacker News to reply ↗

Unofficial Hacker News client; not affiliated with Y Combinator.