Tutoring Remote Clients

blog@undefinedrange.com (Vincent Woo) — Tue, 07 Oct 2008 22:35:00 -0700

Recently, our team spent a great amount of time tutoring a remote client. In this case, the client needed help understanding the basics for an off the shelf e-commerce package. Our usual channels of communication were not adequate since the client was not web-savvy and was easily confused with our instructions. We had to adapt, re-evaluate our assumptions, and find ways to get the client up to speed. How could we teach the essentials without face to face conferences and without a shared lingua franca? We rejected our usual suspects, tried a few new strategies, and found another one that, in hindsight, could have been very useful in tutoring remote clients.

Screen Sharing

The best solution is to use realtime chat involving a shared desktop. This is as close to a face to face conference as possible.

My preference is iChat screen sharing but not everybody uses Apple computers. a VNC derivative or Windows remote desktop would have been fine too.

Screen sharing is very close to a face to face conference but it does have its problems. The biggest is that the setup could be difficult for non web-savvy clients. Troubleshooting remotely is falling back to square one. Only recommended for clients with a reasonable chance of setting it up or who have lots of patience.

Existing Documentation

Usually, there is documentation for users to study. Have a look around the software website and you’ll probably find official manuals and screencasts. Chances are good that a web search will find some great user created tutorials as well. This is a good first step and many times it’ll work well to point clients to these resources instead of creating the content yourself.

In our case example, there are plenty of documentation for the software chosen by our client. Sadly, in response to some of the client’s questions, references to selected manual pages and 7 minute video tutorials from the original developers were too confusing so we had to look at other solutions.

Phone Conferences, Email, Instant Messenging

Phone calls, email, and instant messenging are lousy for demoing or tutoring purposes. It’s not meant for walking through a website or explaining multi-step tasks. However, they’re great for answering questions that don’t require great detail and if the team and remote client have a shared jargon.

Services such as Skype and Vonage could help keep long distance call costs down while still acting like a regular phone line.

Campfire is a web based instant messaging tool. No worries about setup and it retains chat histories accessible by all members of the team.

Highlighted Screenshots

Our aft-mentioned client was paralyzed and frustrated with the complexity of the website admin panel. The interface was too cluttered and the client was unable to navigate the menu to even begin performing administration tasks. Clarity is the key goal to strive for.

Try highlighting certain page elements to clarify what exactly the client should be concerned with. Another way of looking at it is the opposite: to de-emphasize as much of the non-essentials of a busy screen as much as possible.

Any additional text has immediate context. Consequently, text stays concise by only explaining the significance of the highlight elements. No need to describe page elements beforehand.

I tried a couple of highlighting techniques and the one I like best involves darkening, and thus lowering the contrast, of the entire screenshot. The background still preserves enough prominence such that the client can still figure out detail if desired. Since the page is dark, it is then easy to accentuate the important elements: make it bright and full of contrast.

Here is a screenshot to illustrate how easy it is to recreate the effect in Photoshop. Of course, many variations are possible so experiment until you find something to your liking.

While these screenshots can be made fairly quickly, a whole series of them sucks up precious time. Still, they are effective in getting the message across and can be worth the effort. Because I took into account what the client knowledge level was and customized it to answer questions directly and concisely, the client was able to learn at an accelerated rate.

Desktop Recording

The other day I came across this software called Jing that captures the video of the computer screen while recording from the computer’s sound input. It isn’t realtime like screen sharing, but is valuable for constructing quick and dirty tutorials that require little or no post processing.

The premise of a streamlined workflow is what sold me on the idea. First, record a demonstration as you would normally present it. Jing will then automatically upload the movie so that it is accessible through the web.

Jing can be configured to automatically upload the movie through FTP to a web accessible directory. If you don’t have a web host, they do offer complimentary 2GB webspace accounts at screencasts.com. You can signup for this account during the Jing program installation.

So far, I’ve created a few test movies and the quality is great. movies are about a megabyte for every 20 seconds but your mileage will vary.

I can’t say Jing is perfect though. It doesn’t integrate well with the OSX environment with its custom yellow and black theme. Worse, switching to and from some of Jing’s dialog boxes is a hassle since they’ll disappear and are unrecoverable through the dock or expose. Sometimes application windows are unmovable and are set to appear above all others. Jing needs an interface overhaul.

Another downer is that files are encoded in only .swf format. That’s fine for quick throw away movies but is not post processing friendly. Finally, the greatest sin is that Jing crashed too many times to ignore. I wasn’t keeping track but it felt like there was a 50% chance it’ll crash every time I record. I will need to find a more robust desktop recording software for more involved work.

Despite the negatives, Jing has a clear and productive purpose. I’ll keep Jing installed.

Revisory Project Reflection

blog@undefinedrange.com (Vincent Woo) — Sun, 08 Jul 2007 16:59:00 -0700

Demo movie [1MB]. Revisory: Summer 2006.

Description

Online discussion space on graphical assets or unpolished concepts through message threads and image manipulation tools. Revisory facilitates non-linear design processes between people in distributed teams to better explore brainstormed ideas.

Development

The primary goal of this project to begin an introductory exploration of various web scripting technologies:

Ruby on Rails
HTML5 canvas element
Prototype and script.aculo.us frameworks
Javascript

The initial technical feasibility assessment concluded that the project was not commercially viable. A crucial factor was that the canvas element lacked current and future support by Internet Explorer. However, it was included in the latest version of Firefox, Safari, and Opera at the time. A decision was made to build a simple conceptional tech prototype as a learning experience through a project lifecycle.

Athestics is based on the simplicity of a blank canvas. The low key design encourages quick freeform sketches regardless of artistic ability. With its monochrome nature, the site design should fall back into the background and stand in contrast to the color possibilities of the user generated content.

End Results

Some testing was conducted near the end of this experiment. Revisory was utilized in highlighting the various design considerations given to a dynamic PDF document for review by a client. We found that keeping images updated and in context as per discussion point through appropriate zooming, panning, and highlighting held great value. The web app was relevant when visual communication was desired.

One area needing of improvement is in the generalized drawing tools. Most marks were kept simple to merely augment the existing image. Also, tools do not suggest efficient uses. Instead, future iterations should involve testing for more common behaviors to automate before any additional development starts.

Image used in demo is “More Fun Than Tekken” by Sevenflow and Kultdesign.

Active Resource Cheatsheet

blog@undefinedrange.com (Vincent Woo) — Wed, 16 May 2007 20:50:00 -0700

PNG | PDF

References
The Ins and Outs of ActiveResource
ActiveResource Gets Custom Methods
Active Resource Tutorial
Taking ARes Out For a Test Drive
active resource rdoc