Design Reviews and Posting Without Answers

Recently our technical writing team at work (Information Strategies and Design) started holding regular design reviews. The review sessions are patterned after meetings that our interaction designers hold regularly, in which they get together and critique each others designs and approaches toward user interfaces.

In our design review sessions, a couple of members from our eight-person team share what they’re working on and ask questions about challenges they’re facing. We provide feedback and critique their project.

These design review sessions are one of the coolest things we’ve done as a team. We don’t have a strict team style guide or set of standard deliverables. (We do follow the Microsoft Style Guide and, at times, a thin organizational style guide.) But as far as branding the help material, there can be a lot of variation among the online help files, quick reference guides, landing pages, context-sensitive help, interface text, e-learning, video tutorials, or other help materials we create.

If you’ve ever participated in a creative writing group, the design review works similarly. Team members use common sense and experience to guide their questions and reviews. Somewhat in contrast to a creative writing group, though, you don’t have to bring a finished piece to share.

For example, the other week I was coordinating who would share materials for our design review, and one of our team members told me he wasn’t ready to show it. What? I said. The design review is not about showing finished material. It’s better, in fact, to show what you’re currently working on, while it’s still early in the process, before you’ve cemented everything. Oh, he said. In that case, yes.

Parallels with Blogging

I find that the same mindset works with blogging as well. Often times we think we can’t publish a post until we’ve finished a cool thought, or until we’ve finalized a solution to something. But this past week, I added a couple of posts in which I wasn’t quite sure what I thought. In my Theme Parks and External and Internal Input post, I was only part way into a thought. Commenters added to the discussion and helped me better see insights and perspectives on the issue.

I also wrote a post on working with wikis, A Few Surprises in Using a Wiki for Documentation. I’m not an expert on wikis, especially Mediawiki, and there are many things about wiki authoring that I need to learn. But this didn’t stop me from posting about it. Instead, I shared some of the challenges and issues I was facing. And some of the commenters added information that proved incredibly helpful. For example, see this informative comment by Amalia.

Had I waited until I finished in putting together an entire strategy and methodology for authoring on Mediawiki before posting about it, I would have missed out on the guidance and direction early on. It’s from the helpful information early in the process, particularly with challenges I’m facing, that comments on a blog become the most useful. A blog is, remember, a journal, so it contains thoughts and ideas and experiments in progress — not always finished solutions, completed ideas, or tried-and-true methodologies.

What’s true in design review is just as true in blogging. Sharing the current challenges you’re facing will make your experience in the blogosphere or design review process more helpful and rewarding.

Adobe RobohelpMadcap Flare

By Tom Johnson

I'm a technical writer working for the 41st Parameter in San Jose, California. I'm interested in topics related to technical writing, such as visual communication, API documentation, information architecture, web publishing, JavaScript, front-end design, content strategy, Jekyll, and more. Feel free to contact me with any questions.

  • Susan Grant Slattery

    This was a great post. I had read the Theme Parks and External and Internal Input Post and felt that the comments really articulated well the different points of view that I felt. The post, here, takes it a step further by tying the approach together with community. Thank you.

  • http://www.noassemblymusic.com/ brainnadict

    [MARKED AS SPAM BY ANTISPAM BEE | CSS Hack]
    Drug Dtection Times http://www.noassemblymusic.com/ – zoloft
    buy zoloft online Medication or seeing a therapist can be scary at first, but Zoloft, which is FDA approved, by the way, can help you to get your life back on track. http://noassemblymusic.com/ – sertraline medication

  • http://www.noassemblymusic.com/ brainnadict

    [MARKED AS SPAM BY ANTISPAM BEE | CSS Hack]
    Hangover Hangover Pills Hangover Supplements http://www.noassemblymusic.com/ – zoloft
    sertraline medication The longer you wait, the worse you will feel. http://noassemblymusic.com/ – sertraline without prescription

  • http://www.noassemblymusic.com/ brainnadict

    [MARKED AS SPAM BY ANTISPAM BEE | CSS Hack]
    War Agianst Drugs http://www.noassemblymusic.com/ – zoloft
    cheap zoloft Zoloft – combats anxiety and depression Buy cheap Zoloft (Sertraline) drugs at one of reputable online pharmacies. http://noassemblymusic.com/ – zoloft anxiety

  • http://www.noassemblymusic.com/ brainnadict

    [MARKED AS SPAM BY ANTISPAM BEE | CSS Hack]
    Plasmapheresis Drug http://www.noassemblymusic.com/ – zoloft
    discount zoloft Depression for no apparent or logical cause may be from an imbalance of serotonin that Zoloft tries to correct. http://noassemblymusic.com/ – zoloft drug

  • http://www.noassemblymusic.com/ brainnadict

    [MARKED AS SPAM BY ANTISPAM BEE | CSS Hack]
    Drug Withdrawal Cattle http://www.noassemblymusic.com/ – zoloft
    buy zoloft online Panic attacks that strike out of nowhere and general anxiety can be embarrassing and come from nowhere. http://noassemblymusic.com/ – sertraline 100mg

  • http://www.easylearnspanishreview.com/ brainnadict

    [MARKED AS SPAM BY ANTISPAM BEE | CSS Hack]
    Get Cat To Take Pills ativan no prescription medication
    Doctors and patients alike prefer Ativan because it starts to work quickly so there is no waiting period and symptoms can be managed in a timely fashion. http://www.easylearnspanishreview.com/ – buy ativan lorazepam

  • http://www.bramptonrealty.net/ flincinna

    [MARKED AS SPAM BY ANTISPAM BEE | CSS Hack]
    Free Application For Free Medicine http://www.bramptonrealty.net/ – cheap phentermine pills
    When doctors prescribe this medication they do so with the recommendation that the patient begins exercising, engages in a healthy diget, and also changes their attitudes toward a healthy lifestyle. cheap phentermine 37.5

  • http://bestwaytoloseweightsite.com/ Owemecope

    [MARKED AS SPAM BY ANTISPAM BEE | CSS Hack]
    Hello, Asthma Prescription Medication Advertisements discount xenical Those who take Xenical, eat better, and adopt an active lifestyle usually lose about six pounds more than those who do not take the drug over a course of a year. http://bestwaytoloseweightsite.com/ – xenical online

  • http://www.jbswharf.com/ Vesssaituar

    [MARKED AS SPAM BY ANTISPAM BEE | CSS Hack]
    Free Journal Medicine purchase accutane Interestingly, Accutane wasn?t created to treat acne, it was actually formulated for the treatment of brain cancer and is often used in the treatment of neuroblastoma today. http://www.jbswharf.com/ – accutane online pharmacy

  • http://www.youmaynowkisstheblog.com/ Rartliainly

    [MARKED AS SPAM BY ANTISPAM BEE | CSS Hack]
    Veterinary Medicine Avc http://www.youmaynowkisstheblog.com/ – levitra
    http://www.youmaynowkisstheblog.com/ Рdiscount levitra In today’s day we no longer have to be a slave to our deteriorating bodies thanks to the help of medical science. vardenafil 20mg Generic Cialis