DEV Community

Discussion on: "Can't we just...?"

Collapse
 
emcain profile image
Emily Cain

The documentation bit is interesting because often, as with code, an improvement to documentation means making it shorter. Or spending hours understanding all the contingencies and edge cases enough to feel comfortable directing users to do a single thing.

Collapse
 
nimmo profile image
Nimmo • Edited

Yeah, I understand where you're coming from. Our situation though is that we're a team with remote workers (one of whom is myself!), and a lot of domain-specific stuff that should have been documented wasn't.

Something I'm pretty keen on is thinking about things from the perspective of someone on their first day, and this thought process re: "just" has really helped highlight things that could and should be documented, but weren't.