| ▲ | andix 2 hours ago | |
I could deduct some of that from this sentence, sure. But I wrote this comment because the article was frustrating for me to read. One single sentence would've made it much less confusing:
I'm also known to flag this kind of shortcoming in all technical documentation I review, and it annoys a lot of people that I do. I've put my judgement to the test already a few times in team meetings when someone objected this specific remark. Many times I could prove that there are always a few people in the room that would've benefited a lot from such a simple clarification. They just didn't speak up or ask, because they thought they were the only ones that didn't know a specific term.My intention is also not to be rude, just creating some awareness for this issue. | ||