Main

Documentation Archives

August 10, 2007

Freescale MCU Dev Kit Doc - In a Word, "Aaaaargh!"

DEMOQE128PHOTOTN.gif

Engineers buy and use development kits and evaluation boards to minimise their risk and speed the design cycle -- many say they expect to get something working on a new board in a mere 30 minutes or less. So when the documentation sucks, often contradicting itself or leaving out critical details, it can be insanely frustrating. And it's especially wrenching when the hardware is interesting and useful, as engineer/writer Jon Titus recently discovered trying out a new microcontroller dev kit from Freescale.

"I have a Freescale kit here that could let engineers compare performance of
8- and 32-bit MCUs in the company's new Flexis family. The same code should
run in either processor type, which sounds like an interesting capability
for engineers. But the written instructions are so awful many engineers
will give up. And, nowhere in the instructions does the kit explain its
purpose or provide examples readers can use to compare performance, code
size, and other characteristics for each of the two processor types.

Continue reading "Freescale MCU Dev Kit Doc - In a Word, "Aaaaargh!"" »

October 29, 2007

IKEA Shelf Assembly Instructions a Tad Murky

The curse of bad instructions struck again in the booklet that accompanies a shelf unit Jon Titus bought from IKEA.IKEA%201b.jpg

The original instructions for Step 1 show how to attach two brackets and eight screws and dowel pins to the top, bottom, and sides of the shelf. But, if you're not mechanically inclined, it's easy to miss where the items go. Jon's marked-up instructions, below, explicitly show where the pieces go. The brackets (A) look fairly obvious, but someone with poor vision might miss where to put the other parts, B and C. IKEA%202b.jpg


Things get even sillier, as underscored in another cartoon from the instructions:

Continue reading "IKEA Shelf Assembly Instructions a Tad Murky" »

November 1, 2007

Warning: Mist Maker May Cause Local Pains

mister.JPG
I bought this Chinese-made mist maker for Halloween from a mail order catalog, excitedly planning how I would awe party goers by creating "a magical mist from water in seconds" -- or so the promotional material promised.

Submerged in water as directed, the unit did not produce the highly anticipated effects --in fact, the centerpiece of my graveyard tableau looked more like a sad little gasping fountain that occasionally belched out a gush of liquid. As the evening wore on, it was surrounded by increasingly big puddles of water.

To be totally fair, the mist maker did produce a modicum of entertainment with some rather scrambled English safety instructions View detailed instructions here.


November 19, 2007

Road Sign Design by Committee aka Faulty Directions

globearticle.bmp

You want to go where? The Boston Globe's article Street Smarts? illustrates perfectly why even locals are flummoxed by the exploding number of increasingly ambiguous road signs around town. But now at least we know why -- they're designed by a committee!

Continue reading "Road Sign Design by Committee aka Faulty Directions" »

November 20, 2007

When Semantics Fail

Nandos%20card%20small.JPG

EW Editor Alun Williams found the use of the double negative on this loyalty card for Nando's - a Peri-Peri Chicken cheap and cheerful restaurant chain - to be a bit of a mind-bending exercise. "The deliberate / coy attempt at miscommunication got me wondering, 'Should I tick the box or not?' But, somehow, the promise of 'enjoying free chicken' didn't seem worth the effort of figuring it out."

January 29, 2008

Disgruntled Employee Deletes Data -- Lots of Data

delete.jpg

And you thought you were having a bad day?

Fox News reports that an angry employee (no kidding), wreaked havoc at an architectural firm when she deleted 7 years of drawings and blueprints valued at $2.5 million.


"She decided to mess up everything for everybody," Jacksonville Sheriff's Office spokesman Ken Jefferson told reporters. "She just sabotaged the entire business."

Though the company was able to retrieve the data, it cost them a bundle. And it certainly does make you think twice about data security, or the lack thereof.

About Documentation

This page contains an archive of all entries posted to Made By Monkeys in the Documentation category. They are listed from oldest to newest.

Development kits/tools is the previous category.

Electrical/Electronics is the next category.

Many more can be found on the main index page or by looking through the archives.

RSS Subscribe to this blog's feed
[What is this?]

Sign up for the fortnightly Made By Monkeys eNewsletter. Get the blog highlights straight to your email inbox, no fuss. Just tick the option for Made By Monkeys.

Tag cloud

Archives

Go back to ElectronicsWeekly.com