- Feature Articles
- CodeSOD
- Error'd
- Forums
-
Other Articles
- Random Article
- Other Series
- Alex's Soapbox
- Announcements
- Best of…
- Best of Email
- Best of the Sidebar
- Bring Your Own Code
- Coded Smorgasbord
- Mandatory Fun Day
- Off Topic
- Representative Line
- News Roundup
- Editor's Soapbox
- Software on the Rocks
- Souvenir Potpourri
- Sponsor Post
- Tales from the Interview
- The Daily WTF: Live
- Virtudyne
Admin
The comments about there being significant differences when dealing with teams from different cultures are quite important.
Companies which to not understand these difference in depth are bound to run into problems.
However, unlike many of the previous posters, I do NOT consider this to be a "fatal problem" or do I believe this to be that "the other cultures are idiots".
Rather I am convinced that the majority of the problem resides with the "primary" company [usually USA or Westr Europe based] having too big of an EGO, having a delusional view (or at least naive) believing that others should inherently work the same way that they are used to.
And, just for reference, I am a native New Yorker (at least 5 generations in "The States") and have run a software consulting firm here in Manhattan for over 25 years. Not only are diffeent general approaches needed when dealing with off-shore resources, the exact local must also be taken into account.
There are significant differences betwen "India", "Eastern Europe" and "Orient" work cultures; each of these typically requires a different approach both in requirements and expectations.
"Cavat Emptor" is the phrase that most often comes to mind. If the buyer of the services does not do the proper research, have realistic expectations (will the off-shore team deal with a spike in workload by adding more workers or by having existing stass work longer hours?), and institute a very well defined feedback mechanism, then the "blame" can only rst with them.
Admin
Indian schools teach in this manner: rigorous lists of steps to walk through any process. All of the devs I worked with who grew up in India used this method of learning. If they came to your desk to learn something, they would bring a pad of paper and write down in excruciating detail each move that you make to finish some task.
Admin
In other words, today's story is the programming equivalent of that classic old joke:
You: "Say hello, Steve."
Steve: "Hello, Steve."
Admin
Not exactly. By adding punctuation the proper response from Steve would be Hello. On the otherhand, "Say - Hello Steve" should prompt a response of "Hello Steve" from all listeners.
It is when this is done verbally, where the meaning can quickly become unclear....
Admin
why not just have an instruction, create directory c:\directorynoonecouldthinkofrandomnumberhere, then in all of the next steps, your instructions could just refer to c:\directorynoonecouldthinkofrandomnumberhere? Don't ever let a user pick anything.
Admin
Admin
Take those folks - if they go off-script, and it causes some minor issue down the road, they're now on the hook because they didn't follow directions. (And everyone would be kvetching about those off-shoring idiots that can't follow directions).
Admin
Of course, if the instructions had actually intended that the config file contain:
In other words, what the instruction literally said, we'd be reading a WTF about how the testers ignored the instructions and put their own path in.
Admin
If the installation instruction explicitly copy the content "precisely as listed below", there is no room for interpretation. Of course the offshore team could (and probably should) still have asked to clarify this point ...
But there are some other WTFs in this article:
For me this kind of incidents would rather damage the reputation of Juliens employer than that of the subcontractor. (Also it is of course true that when companies are not used to be specific in writing, offshoring is a disadvantage, since it makes it harder to iren out this kind of glitches; OTOH the company might also benefit from learning to be more specific...)
Admin
Why oh why is it always Ravi?
Captcha susipit A hole in the jail floor, in earlier times called a dungeon.
Admin
And you would do that manually? No Skript or something? OMG
Admin
"Common sense" is all very well, but too often I've seen it used as an excuse for sloppy documentation. I have a coworker who has become the default czar of a major piece of software because 1) her installation procedure is not at all robust, 2) her documentation is full of errors (27 steps, some of them with 5 or 6 sub-steps) 3) she has a success story of a user getting it to work without help, and 4) her boss protects her from punishment. So all it takes is common sense, anyone who can't do it is an idiot (she is quite vocal on this point), and you'd better stay friends with her.
And if you're going to have an installation procedure anywhere near this complex, scripted or unscripted, it should have diagnostic tests all along the way so that if it crashes on step 32, you can at least be sure that everything was correct as of step 31. (Corollary: anyone who writes software to temporarily survive a fatal condition should be run out town on a rail.)
Admin
Not everybody works on point and click windows software. Or even a single application, some people develop complete systems.
What's the install procedure for your companies mail server? web server? domain server? is it a single step? Do you even HAVE one?
I'm sure installing a Facebook/Twitter/Google/[Insert other random web service here] server wasn't one step when they first started, and at some levels - when you're not installing multiple a month - it doesn't make sense to spend the time to automate the procedure. Lets not go into if the systems are running Windows servers, with software such as Oracle and VMware Virtual Center - apps were not designed to be scripted to be installed.
Admin
Admin
Bet they are CMMI level 5 though
Admin
Page and a half of whining about improper documentation and lengthy installation procedures, and no one mentions the abominable wall-of-text Mark bowytched up again?
...
Suspiciously absent are the complaints agin thy story-telling... Not haunting the boards again, are ya, Bowtyz? Deleting such as offend thee?
TRWTF is your abysmal failure as a writer.
I think you both the point of the story, and half of the words:
And threw in a few logical writing fails: "newly-hired", not "newbs-we-hired". Thank #DEITY, no. I'm not. Not only do i see them as necessary, (to your credit, you at least *claim* the same), but i enjoy both the increased understanding of the system that i get from establishing the business facts, and the act of codifying them. BEFORE the system is gargantuan and treacherously unstable.With any luck, concepts such as TDD, pride in my work and personal/developer responsibilty will prevent our Venns from ever intersecting. Let alone our paths.
TL;Deleted: Let Halcyon do the story-telling, and go back to posting Error'ds....
Admin
Admin
Are you kidding? That makes at least 3 of us now. I'm sure there are more that can remember back to, eh, 3rd grade?
Admin
Admin
Admin
Admin
If Julian had to ask them to scroll up, who was TRWTF?
Admin
Thank you.
Right now I'm involved in setting up (and documenting the procedure for) several web and DB servers. So I'm looking at Apache, PHP with a selection of Pear libraries, Postfix redirection, MySQL, Postgresql, IPTables, backup scripts, configuring other servers that connect to the new ones, etc.
85 steps would make my job much easier.
Admin
Further WTF: why did nobody say something like...
"It buggers up when I copy/paste this one line in step 32" "Oh, whoops, yeah you were supposed to actually go copy/paste this other previous thing you used..."
Step 32? 45%?
There is easily enough information there to figure out where the bug is, was there really nobody involved with the bug-testing capacity to pinpoint the problem to this one instruction? They even told the people who wrote the thing roughly where the mess-up was, nobody on the coding side could go "okay 45% of the process would be about... here."?
But TRWTF is that our world is based on a system where these offshore workers are paid and trained to be drones.
Admin
Better have predictable fools than erratic fools. I will take the drones over "coder knows best" any day.
Admin
Sorry. Passwords are required to be a minimum of 32025 characters long.
Admin
To all those complaining about the 85 step installation.... You clearly have never worked on large-scale systems before. You can't exactly script installing Oracle, restoring a database, installing middleware, configuring connections, installing application layers, etc, etc, across many different tiers of hardware. My department is currently working on creating a completely new testing environment and the project is expected to take six months. It involves mainframe regions, Oracle and SQL server databases, middleware in Java, applications in .NET, etc. All told about 18 different interfacing systems. That doesn't even get into the hardware setups, network routing, etc, etc. Only 85 steps and a day would be a dream!
Admin
I totally agree. And I'm sure this application was written in VB.
Admin
And you say that like it's a good thing. It's not a badge of honor to have created some horrendously complicated setup procedure. And I'm sure Facebook/Twitter/whatever was a complicated setup the first time, but I sure as hell bet it isn't that complicated anymore. Once you've worked out the kinks you should be able to simplify.
Admin
To all those complaining about people complaining about too many steps:
2 Why haven't you ever tried to automate your job as much as possible?
Admin
My experience with outsourcing is that you have to define things so well that in the end you write "meta-code" and instructions and it would be faster to make it yourself.
Admin
Admin
Nice read. Can you please explain Flatuluminescence to me?
Admin
What? Don't be ridiculous! The main point of computers is to play video games. Don't you know anything?!?
Admin
These days "PhD" and "FUD" are virtually synonymous
Admin
Umm....shouldn't this be 11 words?
Admin
In fact, until i heard about it, freaked the fuck out and automated the deployment of the system i currently work on, it took our QA LEAD nearly a full day just to deploy the code of a "daily" build to the "already set up" (read: unknown mish-mash state of previous "upgrades") QA lab.
Now it takes under an hour (and happens automatically, during off-hours), INCLUDING: wiping the machine, restoring databases from production backups, installing required services from scratch, installing AND CONFIGURING third party systems, and deploying the code that used to take the entire day.
If you're not using your computer that way, you're doing it dumb.
Admin
Doubtful. That smacks of the pedantry of something mathy. Either that or the person tended towards Aspergers or autism.
Admin
First off: to those with the thought that an installation process should be "single click simple" let me illustrate a recent installation of MS Outlook that we broke down into two simple steps:
So how simple is that then? Or perhaps I missed some steps? </sarcasm>
Second off: Process driven individuals don't always exist in places with foreign accents, but its WAY more likely. A couple of years ago I had the pleasure of dealing with an individual that live in Bawstun who was as process oriented as the person illustrated in the article.
That is dealing with someone who is 430 miles away, yet I can call up the FSL Farsi accented Francophone in Montreal who interprets what I say and gets it right. (But that's only 330 miles.)
Third off: Why wait? In this case a little sacrificial initiative would have solved this much quicker.
I define a competent value-added reseller as someone who comes in to the office to watch me do the installation of the hardware/software I've purchased and help me understand and avoid pitfalls. An incompetent reseller just provides me with a link to a download. A reseller looking for a punch in the mouth tries to take over.
The worst installation process I have ever come across was Accpac 4.x before we started using integrated authentication, especially the application of updates and service packs. The instructions were a scanned image of a handwritten fax pasted into a Note in Outlook which didn't include updates to datastore location changes or definitions of particular folders. We didn't change the documentation because it was an excellent tool for testing the competence of the IT employees we hired. If you could retain the information for 3 weeks and do a successful installation it was worth a beer.
I now work for americans and don't get free beer.
Admin
Example: "Press any key to continue"
Response 1: "Where is the 'any' key"?
Response 2: "I keep pressing the shift key and nothing happens"!
My experience: Being told that a requirement in the installation book needed to be followed (the sector size of the SP area must be the same as the BT area) after I had already gotten around the problem. It was the mid 70's and I had just gotten a new "supervisor" who liked to read the installation manuals. He didn't understand the reason for the limitation, and how I had gotten around it (SIGH).
Admin
If you're doing it that repetetively then yeah, a script is well and good. But -
It is nice (and I have managed to do it) to have scripts that simply say
Sometimes your system is isolated, sometimes the installers don't understand working from remote shares, sometimes your installation process requires the resultant of an environmentl varialbe only available after the restart of the system with nothing running in memory aside from the CLI, sometimes your security gurus won't allow the installation of third party drivers that allow reading ISOs. (basterds - oh wait, that's my rule).
sometimes you aren't doing it silently sometimes the system is too stupid to be convenient - like a subway rider standing in the doorway. (You know who you are, I'm pointing right at you!)
Admin
In only several months? How did you get it done so quickly?
CAPTCHA: ASCI when ASCII is more than you need.
Admin
Most people are missing the point here that these "the world-class, high-quality engineers" can't even recognize a configuration file and make the startling difficult leap of logic that pasting the line verbatim is NOT the proper way to update the config file. I work in mainframes and assembly, never never worked in windows or linix or web development and I know what the hell a config file looks like. I'm obviously universe-class. Gonna put that on my next resume.
Admin
Sometimes people can be too literal no matter who they are. I work in the electrical field. I had the fun one day of watching one of my coworkers "strictly follow the procedure" as the boss had told him. Nowhere in the procedure did it call for him to disconnect the $1500 test equipment before he turned on the 208VAC. Of course the poor 5VDC test gear went up in a puff of magic blue smoke. My fellow tech had tested hundreds of these units before and never had a problem, until he "strictly" followed the procedure.
I also, when having just started at this job, almost killed the same tech by accident because I literally followed his instructions for wiring a 208VAC unit. I had at least thought to ask the question of how to wire the unit, but he had given me the wrong instructions. Followed exactly his instructions put 208 on the (metal) chassis. Caused quite the stir.
What did I learn from all that? Be careful when you write (or speak) instructions, because you never know how closely someone will follow them.
Admin
What? Don't be ridiculous! The main point of computers is to watch porn. Don't you know anything???
Admin
Ooo, look at the pixels on her!
Admin
FTFY
Admin
Why the person should have clued in, you didn't help matters with the poor punctuation. By enclosing "the first name of your Indian TA" and "your old office number" in quotes you're saying that's the literal words to use. If you had just omitted the quotes I imagine it would have been easier to understand.... Still you gotta wonder why the user still didn't take a minute and figure this out themselves....
Admin
Yes, and why wouldn't you write a batch file that does the entire installation interrupted by some PAUSE commands. Then the offshores can push <ENTER> some times.
Admin
neosenshi: "I work in the electrical field."
That must be hair-raising.