Re:Code speaks louder than design docs
by kccqzy on Monday December 16, 2024 @10:05AM
(#42431640)
You have nice coworkers willing to read drafts. If your coworkers are busier (if they are more senior) they might not. Or they might read half a page and then stop because there isn't enough context and background information in the doc. Or they might read something and misunderstand it because of bad writing. I'm usually not the kind to waste other people's time like that.
[ Parent
| on HN ]
Or, they won't say anything about it at all, because they (choose all that apply):
a) are not good communicators,
b) do not respect you,
c) are afraid to admit they don't understand (even if your doc is clearly shit),
d) do not care very much about the project.
Re:Code speaks louder than design docs
by ChrisMarshallNY on Monday December 16, 2024 @12:21PM
(#42433085)
In my experience, it’s usually (d), even if they are on the team.