this post was submitted on 05 May 2026
399 points (98.3% liked)
Just Post
1505 readers
47 users here now
Just post something ๐
Lemmy's general purpose discussion community with no specific topic.
Sitewide lemmy.world rules apply here.
Additionally, this is a no AI content community. We are here for human interaction, not AI slop! Posts or comments flagged as AI generated will be removed.
founded 2 years ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
when I read it, i feel like I know why technical documentation is so stupid and obtuse instead of clear and obvious.
tech people generally have a poor grasp of how to communicate information effectively, let alone in a style that isn't tedious and boring.
everytime i read a technical document I ask myself who the hell wrote this and what the hell were they thinking. then i re-write it for my employees in a way that is actually understandable and applicable to reality, instead of paragraphs and paragraphs of self-referencing jargon.