FLUID-3576: The Inline Edit demo is confusing and could use better instructions

Description

Bruce Smith reported this issue to the infusion-users mailing list:

"There are no instructions visible for this demo:

http://build.fluidproject.org/infusion/demos/inlineEdit/simple/demo.html

See attached screenshot for what it looks like.

I'm using Firefox 3.6.2, Mac OS 10.5.8, and the NoScript plugin, but NoScript reports it is not disabling anything on this site (and I believe it, since the demo does work once I learn how to use it).

Maybe the lack of instructions is intentional, but I could not get it to work until I read some archived mailing list posts, which led me to try the tab key. Before reading that I was not able to edit anything (clicking on bold words and typing did nothing, and nothing else I thought of trying worked), and there were no error messages.

After trying some more, I realized that for most bold words, hovering over them highlighted them, and clicking there made them editable – but not for the only ones I tried at first, namely the word "bold" itself in the lines that say "The words in bold are editable"! I guess I only tried those specific bold words, but that was enough to make me think it was "not working". (And indeed the claim that all the bold words are editable is wrong.) So this error is amusing in hindsight, but IMHO it needs fixing on the page, either by making those words not bold or (preferably) by making them editable. (And adding some instructions would be a good idea as well.)

• Bruce Smith"

We should definitely implement better instructions for how Inline Edit works, and perhaps consider improving the demo so that the various affordances provided by the component are clearer and in-context.

Comments

• Justin Obara commented 2010-05-07T14:10:28.130-0400

  a11y issue

• Jonathan Hung commented 2010-10-12T13:01:12.834-0400

  Sufficiently addressed with the new demo.

• Colin Clark commented 2010-10-12T14:02:23.007-0400

  Jonathan's new demo should address the issues this user reported with the older demo, so we're good to go. A separate ticket will be filed to do some user testing on our new demos.