About

I'm Mike Pope. I live in the Seattle area. I've been a technical writer and editor for over 30 years. I'm interested in software, language, music, movies, books, motorcycles, travel, and ... well, lots of stuff.

Read more ...

Blog Search


(Supports AND)

Google Ads

Feed

Subscribe to the RSS feed for this blog.

See this post for info on full versus truncated feeds.

Quote

Eat food. Not too much. Mostly plants.

Michael Pollan



Navigation





<September 2017>
SMTWTFS
272829303112
3456789
10111213141516
17181920212223
24252627282930
1234567

Categories

  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  

Contact

Email me

Blog Statistics

Dates
First entry - 6/27/2003
Most recent entry - 9/23/2017

Totals
Posts - 2453
Comments - 2558
Hits - 1,984,502

Averages
Entries/day - 0.47
Comments/entry - 1.04
Hits/day - 381

Updated every 30 minutes. Last: 8:30 AM Pacific


  02:25 PM

We went through an interesting fire drill at work earlier this week. We found out from the folks who watch over the geopolitical issues for our documentation about a cultural sensitivity in Japan to images of people that show only four fingers.[1] This is a real "Huh?" issue for many of us who are undereducated about Japanese culture. But it's well documented and there are some surprising examples of graphical content that has been changed for the Japanese market, to wit:



and


(Image adapted from site at preceding link.)

Word came down to us this week that we needed to do a sweep of our images to find and fix any graphics that might cause a geopolitical concern. What this boiled down to was reviewing, one by one, several thousand images. I work with programming tools and frameworks, so this seemed not only to be a tedious job, but sort of a pointless one. I mean, this is the sort of thing we have thousands of examples of:



and



And yet — saw this one coming, didn't you? — I actually found a couple of possible offenders. Here's one:



You might wonder how we'd end up with an image like this in programmer documentation, right? It's part of a topic that shows how to crop and scale images programmatically.[2] This topic is old (based on old versions, at least 8 years), so there's no telling where the image came from. There's a chance that the image was at one time part of a gallery of approved clipart that we're allowed to use in the documentation. (If so, it better be expunged from there by now.) A less preferable explanation is that the writer found the image on his or her own; this would be a great example of why doing that is not a good idea.

It just goes to show:
  • It's virtually impossible, based on just personal experience, to judge what might or might not be appropriate in other cultures.

  • It's helpful to have guidelines (teams! tools!) that alert you to issues like these so that you can avoid doing what we had to do, namely going through after the fact and fixing your documentation. (This was a big fail on our part, even and in spite of having people to help with it.)

  • Always and only use pre-approved imagery in your documentation.

  • As with any documentation (or code or project), it's always less time-consuming to catch and fix problems as early as possible in the pipeline.


[1] I don't know why we're only now finding out about this now, tho.

[2] Presumably in a short while, the topic will no longer contain that image, which is why I'm showing it here.

[categories]   ,

|