Slashdot Mirror
Revised Hall of Technical Documentation Weirdness
DBarefoot writes "Last August, my Hall of Technical Documentation Weirdness was submitted to Slashdot. Some folks found it at least mildly amusing, and I received a bunch of submissions of documentation weirdness from Slashdotters and others. So we've just posted an updated version of the Hall, with more than twice the images and easier navigation."
That is pretty weird. But not as weird as some stories I've read here.
The weirdness in my work project is that the documentation is missing. I keep meaning to write a comment or two, but with 12000 lines now, I just never seem to get around to it.
I'm gonna need a spec.
Lets see, average of 5k.. multiply by the average amount of slashdot readers.. that works out to arouuunnnnnddd...
*ahem*, remember to tell me what the afterlife is like.
hi i am an software engineer from india, can someone pliz explain what is documentation?
The kicker is that my (ex) girlfriend decided she'd rather have the MREs. I mean, come on, even bad stir fry is better than an MRE, and I know from first hand experience. Except for that one time I found a Band-Aid in my Buddha's Delight....
http://www.rootstrikers.org/
Room: Slashdot Main Page
Directly in front of you are several stories. You notice a story about Quake with the notice 'Read More' beneath it.
>click notice
Room: Weekly Obfuscated Quake Story
You are now in an area that seems vaguely familiar. You immediately notice several trolls that are already attacking both the Quake story and a purple dinosaur.
Your score is currently +5 moderator points.
>attack trolls with mod points
You use all of your moderator ammo on the trolls, taking out a handful. There are still a few trolls left, but they leave you alone. The Quake story is now being protected by sensible readers, but the purple dinosaur is a hill of beans.
You see an opportunity for a karma kit. You see a notice marked 'Reply'.
>hit reply
You now see a Quake story with your post listed near the bottom, but in front of the trolls who are now attacking each other. Two moderators enter the room, closely followed by an Anonymous Coward and two morons who don't know how to read.
>hit submit story
Your post has drawn the attention of the others in the room. The faint smell of flamebait seems to be coming from just below your post. Five trolls have suddenly come back to life!
>attack flamebait with witty reply
Your witty attack has shot down one of the non-reading morons. One of the moderators takes care of the Anonymous Coward - he runs off to foul up some other room. The other moderator leaves behind a karma point.
Victory is yours!
insignificant sig
It sends you on wild goose chases for years, trying the silliest of things, eventually leading to the point where you give up and do it yourself.
This is a funny article that featured on slashdot a couple of years ago. I describes the differences in culture one has to pay attention to while writing technical documentation for international audiences. For instance:
And while Italian and French users were very happy with printer documentation that included pictures of naked women with slim, strategically placed tinted bars showing how colors were reproduced, Esposito doubts that particular manual will be used anywhere else.
Posted by simoniker on Thursday April 01, @08:26AM from the you-only-live-twice dept.
DBarefoot writes "Last August, my Hall of Technical Documentation Weirdness was killed by Slashdot. Some folks found it at least mildly amusing that a poor server should die in such agony, and I received a bunch of submissions of documentation weirdness from Slashdotters and others. Given that I've run out of spoons to gouge my eyes out, I've decided that I might as well kill the server for a second time."
Avantslash - View Slashdot cleanly on your mobile phone.
"Crod", I think you mean.
That's what you think.
Yes. American.
I read "revised hell of technical documentation"
Timang tinggi tinggi
parang sudah asah
alang alang mandi
biar sampai basah
One of the oddest things I've seen as far as documentation goes would have to be on the back of a package of doorstops I bought at Wal-Mart a couple years back. Take a look at this.
If you can read this, you are the enemy.
Is the Hall of Technical Documentation Weirdness also technical documentation weirdness, so it should include itself?
That's why it's usually stated as "This side towards enemy", thereby eliminating the confusing "which way is front" question.