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.
OK, seriously, you really are just load testing your web server, right? This site is has collapsed under the /. effect with only one comment posted, in the middle of the night USA time.
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?
Since the page seems to be /.-ed, I thought someone might want to read up on funny signs and stuff at www.engrish.com.
Ya know, for my job I proofread and rewrite Japanese books. I dont think there is a worse language, japanese people have just enough comprehension of english to mangle it in astounding ways. Plus, with katakana, they are under the impression that the way they write/pronounce things is the same way as english speakers. Then again, the people I work with thought Schwarzenegger was American. They also think Green Day is punk. Go Figure.
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/
Makes me think about those stupid consumer warning labels, and how dumb someone must have been to actually do something that stupid.
The warning labels are not put for the benefit of stupid people. They are put so stupid people don't sue them after doing the exact stupid thing that the label describes.
There's a mirror here. Enjoy.
You can mod your friends, you can mod your nose, but you can't mod your friend's nose.
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.
You could be thinking of This is Broken. I think it's funny and not anal, but maybe I've been hanging out around usability experts to much.
Btw, today's entry is hilarious.
The shareholder is always right.
Then the slashdot effect would be no more!
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.
Or better yet I'd highly recommend any of Donald Norman's books.
That's what you think.
That is because they are programmers, not because they are Indians. ;-)
In this case it depends upon how you look at it:
If you do it because you enjoy watching a server fry, you are a sadist.
If you do it because you enjoy your pain of having your server fry, you are masochistic.
Yes. American.
I read "revised hell of technical documentation"
Timang tinggi tinggi
parang sudah asah
alang alang mandi
biar sampai basah
Not for pressing trousers, but they do make great cheese toasties
Music is everybody's possession.
It's only publishers who think that people own it.
Fuck Beta
~John Lenno
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.
WARNING
1. With appertain rotor of screw setting pre ceiling on the under standing that scre no wield. May wield two-faced, pressboard securing. wield pre to begin with wiping ceilingof bilge dasto.
2. Thread of length need half as many again as tad.
3. Open toy of batteries shuck. Verification batteries.+,- whereafter stow down, to a certainty need locknat lest take place accident.
4. Hook through toys apside of hole.
5. Needs switches shoving NO,for pre arrows specifying of orention shoving.Pack it up time, withbold toy pate, need switches shoving OFF.
* Prythee no sport with stingy or play asperity game. Winding finger have got bloodstream not walk.
Throagh of peril.
* Tad disport of time grown man tatelage.
* Till the cowcomes home.Wield toys damage, burn-in prythee wind to a close wield.
* Give attention to open/close toys,therefore take place peril.for instance slipup batteries wield result in the emission of heat rupture liquid.vent itself prythee pay attention.
* Play at sith to a certainty bolt up power supply fetch out batteries.
* Batteries no electification dissolution.plunge ioto aquator fire.
* Not trust for tad batteries lest in advertent eat off. In the event of accident without loss of time plytheepillroller tuke order with.
May pre house the seamy side volitation!!!
WARNING [with an assortment of odd icons]
"Our interests are to see if we can't scale it up to something more exciting," he said.