3 ms·
Writing is pretty easy, reading is the hard part. Between the ridiculous amount needed to read, plus the fact that maintaining up-to-date information is really
by gilbetron 5y ago
Writing is pretty easy, reading is the hard part. Between the ridiculous amount needed to read, plus the fact that maintaining up-to-date information is really difficult and how that makes reading even worse ("Should I bother reading this when it is out of date, or just talk to the person that has it all in their head?").
Written works have an over-exaggerated finality to them. They can be good for capturing some of the reasoning behind a decision, but even then, it is only somewhat spotty.
- dllthomas 5y agoI've been liking ADRs with cross-references that are checked in CI and surfaced in code review.
- resonious 5y agoI'll agree that reading is hard, but I think it's also fair to say that reading good writing is easier. Then, we can say that it's hard to write well, and it follows that reading most writing is hard (including this comment probably...)