Friday, January 04, 2019

Well, I've moved on (not entirely of my own free will) from my day-job UX writing position, and there's a whole post I should write about how writers (and particularly UI/UX writers) are still being devalued in the tech industry.

However, instead I'd like to direct your attention to:

a: My new blog, Twaddlespotter, which replaces this one, and is associated with my business site (to which I heartily refer you),
b: A fabulous third-party article:

Wednesday, July 01, 2015

When More Friendly Is Less Friendly

Everyone is talking about TONE these days, not only for web pages but for apps and operating systems. The notion is that now, more than ever, text that users see on the screen should be friendly and human.

Well, fine. We in the UX and UI text biz have been saying that for decades. Nice to see that the industry has finally caught up to us.

However, it's another thing when the style guides for that tone are driven by management and inflated by marketing and, as usual, the last folks who get a word on the matter are those people for whom language really matters, the writers.

The fact of the matter is that not all users need or even like sizzle. Snappy tone doesn't fit with every scenario or every product. And when it comes right to it, when you have non-writers at the wheel, the play of language design and visual design can get downright counterproductive.

Here's a case in point.

Everyone by now knows how a check box functions and what it means. It works the same whether on paper or onscreen. You check the box to specify that you want the item, or uncheck it if you don't. It's beautifully simple. The only text you need is the label that tells what you're choosing or rejecting.

But what if the design mandates that check boxes are too "robotic" and should be changed to on/off switches? Skeumorphism aside, these controls are not intuitive without labels. Words must be used to distinguish one position from the other. Depending on how the original label is worded, Yes and No might be sensible for the on/off positions, or perhaps On and Off. But either pair conversely affects the label text too; they have to logically fit the English syntax.

Especially troublesome are options that have been worded in the negative. Now, this is something that at least Microsoft Style has recommended against for some years, but of course it still occurs.

    Understandable, if a bit odd:
    Do not print [ ]
    (User thinks: "I do want to print, so I'll leave that blank. Although I wonder why it doesn't just say "Print"?)

    "Friendly" double negative:
    Do not print [No]
    (User thinks: "Hmmm...does that mean 'No, I do not want to not print'? That's weird.")

    "Friendly" nonsequitur:
    Do not print [Off]
    (User thinks: "Hmmm...does that mean turn printer off? Or...what?")

Below, the simple porting of a control from a desktop app design to a new, web-based design, necessitates a new label, which is supposed to equate to a friendly, human "experience."

Here it works pretty well. When you click the slider switch to No or Yes, it answers the implied question of the label. Still, the option on the left is phrased negatively, so what does it mean to choose No? It would be a lot clearer to word this as "Task effort IS equal to..." and change the default to Yes.

Another thing to watch out for is labelling consistency. Yes and No work well with verbs because the question is implied: [Do you want to] specify production order?   However, "Cost category" is a noun, and Yes and No is ambiguous at best. 

Another issue arises when some check boxes are not turned into switches - particularly if sitting cheek-by-jowl with switches! Is it intentional? If so, why? 

Or, for that matter, why not go whole hog and change Yes/No dropdown menus to either a check box or a switch?

But those are design issues. This being a UI Text blog, my main bugaboo is trying to reply to a non-question with a Yes or No, especially when a labelless check box was doing the job simpler, more elegant, and - dare I say it - friendly manner.

Friday, November 28, 2014

On Not Reinventing a Square Wheel

A couple of months ago, a mess of my content publishing colleagues were unceremoniously let go from their positions at Microsoft. This was just the latest of a painfully extended series of layoffs in the service of “streamlining” the company. Honestly however, the real mess appears to be what's left of their product teams afterwards. Let alone the mess that customers may be faced with in the next release.

See, it's like this... the overarching notion seems to be that in order to “flatten the org” and save money, layers are removed from the management structure. In reality, it's not that the admittedly multitudinous layers of management are thinned out, it's that the people in the trenches, or at the bottom of the totem pole, if you prefer that metaphor, are let go, thus leaving the managers with no one to manage. Voila, a slimmer org.

Right. Well, when you still have a need for writing and editing, but little if any writing and editing staff, then who provides and QA's the content? (Understand that I'm talking about UI text as well as documentation here.) So, it turns out that a corporate subgoal is to give more “ownership” of the product to the program managers. As if they didn't have enough ownership already. Yes, you're correct, I'm saying that the PMs are now to write the content, to “own” the UI. The few writers that remain on staff (who needs editors, anyway?) are relegated to “strategizing,” and only to assist the PMs in actual writerly pursuits “as time allows.”
why not ensure that writers write the most critical info rather than pinch-hit?
It's an... interesting... plan, which is, to say the least, not wholly thought out yet. For starters, there's a lot of “handwaving” about using automated task recorders to, well, record tasks – that is, record clicks in the UI – and then somehow port that output to a text deliverable which is almost ready for prime time. I say “somehow” because the tool and required templates don't exist yet, nor does a team exist for building it.
templates only provide a structure, not the intellectual process that writing demands
And the problem with “almost” is that in reality it will require a lot – a lot – of manual work to turn this output into user-friendly localizable English. Who does that manual work if not writers? By and large, PMs aren't experts in language. Even if English is their native tongue, which these days is often not the case. And then there's PMs' unfamiliarity with corporate style, localization and accessibility and legal requirements, and so on.
will nonexperts even know to ask the right questions?
The funny thing is that this brave new plan hurls the development/UX paradigm back to the Golden Age – er, Dark Ages – when devs and PMs produced all the UI text; User Assistance, as it used to be called, virtually never got a chance to see it, let alone polish it. At best, if they had trouble documenting functionality, they might be able to faintly ameliorate bad UI text with an explanation in Help or perhaps (once they had been invented) a tooltip. The resulting UI, as we know from experience, was all too frequently techy, unhelpful, unlocalizable, and strewn with typos and bad grammar. This made a bad esthetic impression on users, not to mention harming usability. Costly support calls soared. Reviews were bad. Enterprise customers were unhappy as well, where a stymied employee might cost a company some real money.

So between wanting to boost user goodwill and incidentally increase ROI (we're talking many millions), the Powers That Be – and not just Microsoft, this is industry-wide – finally grokked that if you provide accurate, helpful UI text you can achieve those goals, in part by reducing the need for such hefty documentation.

And now, with a new generation of management who seem to have forgotten or never learned about the lessons of the past (and have been seduced by the"modern design" zeitgeist), the subject matter experts and professional writers and editors, some of whom earned their stripes from decades of dedicated work, are tossed out as cosmetic “wordsmithers,” and their jobs are “in-sourced” to people with no background in the field. (Permanent employees as well as contractors were let go and, reportedly, new vendors won't be brought in to Microsoft, off-shore or not.)

As I say, this is not a new phenomenon, but it's somewhat surprising that failed ideas have to be tried again and again. Reinventing a square wheel. Giving still more responsibility to a single person hardly seems feasible given the already tight schedules. Especially if the person needs ramp-up time and special knowledge to do a decent job.

Behind the outmoded process paradigm is the thoroughly disproved mindset that words don't matter and users don't care.

I direct your attention to the following articles that explore the area of:

    The Goodness of Good UI text

  • oft-layoffs-impact-exchange-technical-writers-where-
    "Eliminating some technical writing jobs is not the point. What’s really upsetting is that subliminal message that Microsoft is no longer interested in providing the very best technical information to its customers. That’s something that all of us should be worried about – unless of course, you really are due to be absorbed by the cloud and can therefore rely on the Kool-Aid. You’ll need it."
    Everyone has done layoffs,” notes Patricia Seybold, CEO of the Patricia Seybold Group in Boston…. But the best companies focus on keeping customers happy. “They’re convinced that keeping the quality of customer experience front and center is the key to survivability, then viability, then profitability…”
    "...language experts should play a more active role in shaping the interface because the interface is text."
    "If a software design team hands you a finished interface and wants you to spray some words on it, you’re too late. Why? Because the writing *is* the user interface, and UI needs to be designed with language in mind from the ground up."
    "The idea that you can credibly address a client’s concerns before you’ve actually started working with them is ludicrous, and, frankly, damaging. It undersells the magnitude and importance of our work, suggesting that hard problems can be tackled in such trivial fashion. … the people who best understand user engagement are often the least empowered to do anything about it, while those who have little true understanding of the medium are put in charge."

     And, because the link he gives to his follow-up is broken:

    "Usability problems usually fall into two categories; either it’s not clear how to do something, or something is too cumbersome to do. The latter is fixed by a better understanding of what the key tasks are, and the former is usually resolved by adding clarity. Often the best way to do this is through the writing of the interface."
    "Accumulated across your entire website or app, consistently good writing will help reduce your users’ confusion, and your customer support burden to boot."

  • Wednesday, May 30, 2012

    Advertising Algorithm FAIL

    Today was perhaps the worst of a series of bad days in Seattle. Gun violence here has been incredible.

    A man suspected of shooting five people at a University District cafe — and a woman later on First Hill — shot himself as police closed in.

    Turns out today's maniac — mentally ill of course, god forbid we hospitalize these folks — once lived next door to my son Nick, who called me this afternoon to mention that the SWAT team was in his back yard and cops were busting into the neighbors' place. (One of the shootings took place in a coffee shop down the street which Nick frequents.)

    What has this to do with UI text, you might ask?

    Well, see, I spent a fair amount of time on Facebook today monitoring the situation and chatting back and forth with friends, family, and Nick.

    And here, several hours after the fact, FB blithely displays for me a bunch of Recommended Pages in the sidebar, including "Books" (3 of my friends like) and "Shooting" (1,668,817 people like).

    Aside from that nauseating statistic, why the frack does Facebook want to recommend THAT to ME, TODAY of all days?

    Oh, and when I delete that one, I get "Guns" (1,987,504 likes). I guess I should be grateful that there are 318,687 weirdos on Facebook who just like guns but not shooting them.

    And my point is?

    I figure it has to be that FB is monitoring my posts, or the posts I recently commented on, and finding the common denominator. Which in the case of chatting about movies or music or cars or Twinkies or whatever would be insidious enough, but where their algorithm FAILS is not deducing that I'm posting about guns and shooting not because I like them but because I think they're an abomination.

    Monday, May 28, 2012

    Icons That No Longer Make Sense

    Must be a sign of harmonic resonance or something. I was just talking about this sort of thing with my 14-year-old daughter (and she was the one who brought it up!) the other day.
    Icons That Don't make Sense Anymore

    By the way, Blogger, since when do I use a pencil to create a new blog post?

    Thursday, May 03, 2012

    The perils of appearing accurate

    At work the other day, we were looking at a prototype of some software. The concern arose that, when we unveiled the prototype to the PTB (Powers That Be), they might get the wrong impression: if it looked too finished, they would take the demo UI too literally. At the very least the PTB could begin unnecessarily nitpicking... "rat-holing," in the common parlance.

    Oddly, this misapprehension can occur with released products too. They look so darn good, so authoritative. In fact, most products out there will have some flaws, but the trick is to not let the consumer see them. Naturally this requires a bit of smoke and a couple of mirrors.

    But the example of deceptive accuracy that sprang to mind as I was looking at our prototype was a set of IKEA assembly instructions. Now, by and large these are pretty decent, not least because they use little or no language, just illustrations, hence you get none of the infamous "Engrish". But the illustrations look very convincing. The number of screws is listed, there are helpful dotted lines showing where they go, and so on. They are of course too small to be really super-clear, but they do look pretty dang painstaking.

    The key syllable, though, is "pain." Seldom have I assembled an IKEA item without at some point having to undo some or all of my work and attack it again — not necessarily because of human error (mine) but because some vital morsel of information has been left out, or is unclear. A screw may not have been drawn correctly. The number of screw holes drawn may not match the number of screws in my packet. In short, the seeming accuracy, the spiffy “fit and finish” product feature (in this case the manual rather than the object to be built) fools me into trusting it.

    Now, there’s always the chance that I’m simply so anal that I fixate on the “perfection” or lack thereof, rather than just using my common sense and building the darn bookcase using the Occam’s Razor approach. But perhaps in some cases it is better to be vaguer in the implementation: "describing rather than prescribing" might be a way to think about it.

    Saturday, April 14, 2012

    The Pleasure of a Simple Early Morning Interface

    Here's an example of UI text and design that warms my cockles. This is an automatic coffee-maker in the lobby of the Mark Spencer Hotel in Portland, Oregon.

    All in all, especially given the initially intimidating array of controls, it is actually pretty easy to get what you came for: a cuppa joe "grilled to your order."

    Granted, the interface is biased toward left-to-right readers, but your eye may be drawn first to the bright blue LCD screen at the upper right, which prompts you to "select drink." This box acts as status text, changing as you make your selections.

    There is helpful, concise, instructional text, in a different color from the options (for the non-colorblind), with nice big numbers.

    Group boxes contain your drink options. Minor point, I don't think the select/scroll arrows are necessary design-wise, you ought to be able to get the job done just by pressing the desired choice (especially when you just have two choices, such as hot versus cold drink). Also they probably could have reduced the number of lines around the boxes.

    The "OK button" is large, clear ("Start") and color-coded green for Go.

    The one thing I'd pick at is the pair of buttons (Clean and Program) above the Start and Cancel buttons. Very few people should use these, and I think a better placement would be under Start/Cancel just to clarify that they're not in the standard order of navigation.

    Wednesday, April 04, 2012

    The Embarrassment of Insufficient UI Text

    I discovered the following user-interface at my local Jewish deli.  Each booth has a little Windows touch screen, from which you can perform various tasks while awaiting your meal, including viewing their menu and, for those with no inner resources, as John Berryman would say, playing video games.  

    One of the games offered seemed just too intriguing (especially in the context of a family restaurant!) to resist: it was called “Dress the Waitress.”

    To begin with, the screen did not respond very well to my taps and presses.  But more importantly, the UI text (or lack thereof) deserves our attention.

    Upon my tapping the “Dress the Waitress” menu icon, a picture of a waitress appeared, shown wearing a standard black “waitress” outfit, and carrying a tray of cocktails in each hand.

    Strangely, the title of the game now appeared as “Dress the Doll.” Anyway, large magenta buttons on the right side of the screen let me know I could change such attributes as her skin color, eyes, hair, blouse, skirt, stockings, and shoes.

    I tapped “Blouse”: accordingly, a sort of dialog box opened on the left side of the screen, displaying a variety of tops.  Assuming since it was a touch screen that I should tap an item to select it, I tapped a modest blue top. 

    Instantly the pigeon-toed waitress's was stripped down to her red underwear. 

    Hmm. I tapped the blouse again, to no avail.  I double tapped.  I tapped some other blouses.  I tried dragging a blouse into the figure.  Nothing.

    I tapped Cancel – at least THAT worked! – and then tried putting stockings, and then trousers on her ... again, neither tapping nor dragging achieved anything.  So I knew that it wasn’t just a glitch in the Blouses dialog box.

    But, I thought, was I doing something wrong? Was the touch screen broken? Was the game broken? Was my finger insufficiently electrostatic?  I had tried tapping with several fingers, with both tips and pads... nothing restored her outfit. 

    There were no instructions on the screen, no error messages or prompts. 

    What seemed by all appearances to be a fairly clear interaction (assuming the user has used a touch screen before) not only produced an unexpected and undesired result, but refused to be further amended except by cancelling altogether.


    Please forgive the dreadful photo, I had only my cellphone camera at hand. 

    Thursday, March 08, 2012


    For what it's worth, I not only applied a new template to the site but cleaned out the list of UX links and added few new ones, including a link to my new editing/writing consultancy, No Nonsense.

    Wednesday, March 07, 2012

    Marketers vs. My Mother

    I trust I am not alone in noticing, and detesting, the preponderance of advertising that has, in the last few years, begun to appear in all sorts of places one might not expect it, much less desire it.

    Billboards that cover up bus windows... Big ol' text-based ads that have replaced the once pictorial bottom half of the newspaper TV section... The front page of the newspaper replaced with a full-page ad! An ad plastered on the cover of the phone book, for crying out loud...

    And on envelopes. I mean, on envelopes that contain something other than more advertising. Like bills. Take Comcast, for example (which has, for some inexplicable reason, exchanged for another "word" that doesn't even make sense, Xfinity, but I'll let that go for now).

    My elderly mother recently discovered (with my sleuthing) that her Comcast cable TV was shut off because she (that is, I) hadn't paid her bill in three months. My theory: the envelope was so covered in unnecessary advertising that it no longer looked like a bill — it looked like, well, an ad! And thus it got recycled.

    I mean, she already subscribes to cable, why should she need to see more ads? Oh, I know, it's Capitalism at its best. But she got whacked with suspension of service AND a late fee because of, essentially, the bad design of the envelope. Oh, and Comcast's well known greed.

    Bentley's Rule of Singularity of Purpose: If you want the user to complete Task A, don't throw them off track by a big gaudy 'Task B' label (e.g., the ad) that has nothing to do with the real controls (e.g., the bill payment stub). There are places where advertising simply is not necessary, much less appropriate.

    This kind of bait and switch happens constantly on web sites, where you click one thing, thinking it's another, simply because it's big and bright and flashing at you. Or, more to the point, you don't click what you ought to click, because it looks like — or is totally overshadowed by — spam.

    Do we really, really, have to be bombarded with marketing during every miniscule action, every place we happen to cast our eyes? Does anyone — and I even mean the companies these ads represent! — really, really benefit from constant advertising? There needs to be some downtime for the user, some time to reflect, to — let's go out on a limb here — to use our minds!

    I stopped watching TV several years ago because the advertising was simply unbearable. Maybe I'm just neurotically sensitive, but I like to immerse myself in what I'm doing, whether it's reading, watching a film, talking to someone... I don't want to be interrupted every 30 seconds. My kids are grown up and I don't have to endure that any more, thanks very much, I paid my dues!

    And for those folks who have a hard time figuring out reality in the first place, such as my mom, can we just give them a break and stop polluting the message? A bill should be a bill. An ad should be an ad.