Main

Documentation Archives

September 16, 2010

Android finds Recalls.gov mobile app

recalls-gov.jpgHere's an interesting one. Recall Corner has proved a popular element of Made By Monkeys, and here's a way of accessing a whole lot of data about the details of a whole lot of product recalls.

The mainstay of many Recall Corner entrants, the US Consumer Product Safety Commission, is making its product safety information on all recalls available to third-party businesses and developers through an API. It will also feature in its own mobile app, Recalls.gov (which is available for free for Android devices).

It states:

Continue reading "Android finds Recalls.gov mobile app" »

March 19, 2010

Marketing rule #1: Big numbers are better than small numbers

Thanks to reader Ian B. who sent this one in. He writes:
"Found this box lying around work. It's quite a powerful charger at 16,000 mA but I really don't think it will be any match for my 16,000,000 μA charger I have at home."
battery charger.JPG

March 10, 2009

Supermarket Map is a Pain in the Neck

Sainsbury_Angela.jpg



 View image

David Mery sends this example of a supermarket map with some major legibility issues!

"We were doing some shopping earlier this week when way in the supermarket on a pillar was stuck the attached map of the supermarket. Placing this poster in an aisle didn't make it particularly visible, but that was a minor issue when compared to the legibility of the poster!

To read most of the text one needs to turn one's head 90 degrees to the right, to read a single text (unless I missed other) one needs to turn one's head 90 degrees to the left ('beer' at the top in the red zone), and for a few texts and the captions at the top one can rest one's head in the usual position - without having to look like a monkey. (There are a few diagonals as well but nothing completely upside down.)

The 'captions' section at the top is again a product grouping but only of some products so it ends up adding to the confusion by being partially redundant without any clear logic to it. Is this a list of the most common/sold products?"


 

January 13, 2009

Needless Math: That "Handy" Half Gallon Measure!

 

 

stabilizea.jpgEngineers are great with calculations, but needless math can be really irritating.

Take Jon Titus' experience with this bottle of fuel stabilizer and the instructions for mixing it with gas:

"Before I fueled my new snow blower I mixed some "fuel stabilizer" with the 2 gallons of gas I got at the local market.  The fuel-stabilizer instructions explain that one ounce of stabilizer will preserve 2.5 gallons of gas.  So, I had to do the math and came up with 0.8 ounces of stabilizer.  The plastic bottle of stabilizer has embossed volumes marked in one-ounce (left side of bottle) and 50-milliliter (right side of bottle) increments.  So I dumped out about one ounce and figured that would do.  Because people buy gasoline in gallon quantities here in the US, why wouldn't the company mark its bottles in units of "gallons", so you add stabilizer right out of the bottle for the number of gallons of gas you have?  Why force people to go through the gallons-of-gas to ounces-of-stabilizer step?  Beats me."

I call this kind of inside-out--thinking the "Center of the Universe" syndrome.
 

December 15, 2008

The Case of the Disappearing Calories

P1000619a.JPG                                                                                                                            The calories just don't add up on this box of microwave popcorn. Do you suppose they assume a certain percentage of unppopped kernels or is it just bad math? 

Dish Detergent Label Contradicts Itself

preswasha.jpg

File this one under "mislabeled."

November 18, 2008

When Schematics are Useless

DEV-Monkey Editor Jon Titus posts a great rant on his blog about the lousy state of schematics that come with electronics development kits and boards, particularly when trying to print them out.

Having started a dev kit project earlier this year, I absolutely agree!

Writes Jon: "Most of the schematics I see fall into the "awful" category. Lines appear tiny, legends seem unreadable, and part numbers and pin designations look like smudges.  I use an HP LaserJet 1100 printer and it produces clear, clean diagrams from schematic-capture software.  But the schematic diagrams that accompany development kits or evaluation boards look more like bits of gray connected by what might be lines.  To me, these schematics are unreadable and thus, useless."  Read more....

So can someone tell us-- just why are they so bad?? And what could be done to make them better?

 

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.

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."

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 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.


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" »

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!"" »

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.
ElectronicsNews on Twitter Follow ElectronicsNews

Recent Comments

  • Alun Williams - Electronics Weekly.com on Sainsbury's auto-generated coupon fails to tempt: 'Today's shop was the same price as everyone else' Like read more
  • Graham Franklin on Sainsbury's auto-generated coupon fails to tempt: Yes - I had a £0.01 last week, and this read more
  • Alun Williams - Electronics Weekly.com on Video: Toshiba shakes, rattles, and rolls its solid state drives: Like it, Tony. We need to document that spectrum of read more
  • Tony on Video: Toshiba shakes, rattles, and rolls its solid state drives: Thats not vibration or shock, its a mild wobble. A read more
  • Alun Williams on The cost of mobile handsets: Very fair points - not all the data has been read more
  • Les-M on The cost of mobile handsets: That's a pretty useless graph without knowing the numbers of read more
  • Glen beestone on The cost of mobile handsets: Blackberry OS runs on hardware made by RIM Apple IOS read more
  • Keith on The cost of mobile handsets: Erm.... isn't comparing hardware faults by platform like comparing car read more
  • LJ on Video: Toshiba shakes, rattles, and rolls its solid state drives: Fine, but if it's inside the laptop and it's vibrating read more
  • Richard on Home-brewed phone charger: "What can go wrong?" Almost nothing. Using a car charger read more

Archives