Definitely agreed - I read my own documentation more than anyone else, and writing it out does make for a better system design, but I never refer to documentation until I _need_ to and I don't expect others to do any differently
Re:Why Engineers Need to Write
by ryanlpeterman on Friday March 24, 2023 @08:23PM
(#35297573)
Reading is somewhat painful for people if it isn't entertaining. When I write things that are information dense at work, I try my best to condense it to be mindful of people's time. It has worked well for me
As for communication, it depends. One problem with writing is that it generates something to read, and people don't want to read.