Duffblog has moved to a new home. Update your links!

Calendar

January 2004
Sun Mon Tue Wed Thu Fri Sat
        1 2 3
4 5 6 7 8 9 10
11 12 13 14 15 16 17
18 19 20 21 22 23 24
25 26 27 28 29 30 31
Dec   Feb

Brian Duff's Old Weblog

 Tuesday, January 13, 2004


Plain English and UI

While surfing wiki, I found a link to the Plain English Campaign. I often see their little diamond symbol on forms and terms of agreement from UK companies. The Plain English Guide is an incredibly useful explanation of how to make writing clearer. It is, of course, very clearly written itself.

Writing clearly is an important skill when developing user interfaces. Many years ago, I worked in the development team responsible for UML modeling tools. Back then, we had the luxury of a dedicated technical writer reviewing every single line of text that was displayed to the user by the tool. Jump forward to JDeveloper 10g: there's so much user interface text it would be a huge burden on our technical writers to review all of it. Instead we rely on a set of guidelines, diligent developers and occasional peer reviews.

In practice, this approach has worked well. The user interface text guidelines written by our usability group are very specific and easy to follow. Not everyone has the luxury of a usability group, which is why freely available guides such as the Plain English Guide are so valuable.

... and for some light comic relief, try Plain English Campaign's Golden Bull awards...


2:28:43 PM     comment []


weblog   |   articles
© Copyright 2004 Brian Duff. Last Updated 1/24/2004; 3:05:35 PM. Java is a trademark or registered trademark of Sun Microsystems, Inc. in the United States and other countries.