This satirical blog post really illustrates the problem with a lot of technical writing. Amazing technical writing is so good and then everything else reads like this

How I, a non-developer, read the tutorial you, a developer, wrote for me, a beginner - annie's blog
“Hello! I am a developer. Here is my relevant experience: I code in Hoobijag and sometimes jabbernocks and of course ABCDE++++ (but never ABCDE+/^+ are you kidding? ha!) and I like working with Shoobababoo and occasionally kleptomitrons. I’ve gotten to work for Company1 doing Shoobaboo-ing code things and that’s what led me to the Snarfus. So, let’s dive in!

