Fifteen minutes long, because you're in a hurry, and we're not that smart.

A Midweek Writing Exercise: “Statement of Problem”

Howard here. Let me cut straight to the exercise:

Describe the problems you currently have with the Writing Excuses website, but do so without describing solutions to those problems. 

and then…

Describe things that work the best for you, or things that you enjoy the most at the Writing Excuses site, but do so without simply naming the feature.

We’re giving writingexcuses.com a redesign, an overhaul, and we need use-cases. From you!

In the world of web design (and in the larger world of software design, and the even larger world of product design) the engineering team will do the wrong thing when presented with a long list of instructions from end-users. What they need is a concise list of instructions from an architect, who has looked at the various use-cases in their correct contexts.

Here is one way you might respond to this exercise without having paid attention to the instructions:

“Use a bigger font, and make the buttons bigger, too.”

Okay, but will a bigger font actually solve the problem? Let’s reword this and see.

“I can’t read the site when I’m using my phone, and when I try to click on links or buttons I usually miss.”

Oh-ho! Now we know that what this user actually needs is a version of the site that comes up for mobile devices, and which is optimized for use there. (Note: yes, we know this! And we also hate when mobile sites don’t provide the full feature set. Both of these things are already in our requirements list. And we also know that even for laptop/tablet/PC/Mac users, the existing font is often too small.)

More examples:

I like the tag cloud.

Well, okay. Producer Jordo hates tag clouds, and I don’t like tagging things when I write episodes up, but we’ll go ahead and leave that alone, I guess.

I find episodes using the tag cloud, and sometimes I find super-helpful episodes that I didn’t expect would help.

Wait, you mean it works? Well, that changes things. I’m encouraged to keep tagging episodes as I create them, even though (confession time!) I don’t use the tag cloud myself, and I worry that it might not be useful. And hey, for some of you it might not be! That’s why this writing exercise is so important. One person’s solution or favorite feature may be another person’s problem, and unless we describe the problems and the functional use-cases, we won’t catch that.

Let’s do this one more time…

Don’t make the site all bloated and graphics-heavy! I hate sites that do that.

There’s no value assigned to “bloated” or “graphics-heavy.” Why do you hate sites like that? Are you offended by color? Is it a mobile phone issue? This totally ties our hands, because adding ANYTHING might be problematic here.

I like how quickly the site loads. Episodes take a while to stream, but the UI comes up fast.

This statement identifies load-time as the thing we need to not break. Taken in context of other problems and other successful use-cases, we can see exactly what we need to do.

This writing exercise is especially tricky the more you know about web site design and software design, because you probably already know the solution we’ll end up using. You want to save time and just jump ahead. If you’re passionate about the solution you’re offering, that’s yet another difficulty level. They stack! That means this is a great writing exercise for the engineers among you! It’s like “show, don’t tell,” only with more descriptions of eye-strain and less pre-formatted XML.

Producer Jordo and I interact with the site differently than you do, and Izzy and Tiffany (our development team) are even further disconnected. But if you give us the right information, we’ll give you a new, improved writingexcuses.com that will amaze you, and part of that amazement will be that we gave you good stuff without taking any of the old stuff away.

Unlike our writing prompts, this exercise goes into the comments. And we’ll actually read it! (No critiques, though.)

For your handy-dandy, below-the-fold reference, here is the exercise again:

Describe the problems you currently have with the existing Writing Excuses website, but do so without describing solutions to those problems. 

Describe things that work the best for you, or things that you enjoy the most at the Writing Excuses site, but do so without simply naming the feature.