I’d Rather Be Writing – Tom Johnson

Some years ago, I used to suffer from developer neglect, or to use a more scientific term, from a kind of information exclusion complex. You know what I’m talking about. Developers make updates to the interface, often at the last minute, and don’t let the tech writer know what changed. As a result, the help is wrong and out of date. It’s a frustrating experience from the writer’s perspective.

Information exclusion is fairly common. Just last week I learned about an application that had a new version nearing release in a week, but the developers hadn’t told me about it. I documented the previous version, and although the developers made the help button more visible, they never told me they were releasing a new version. They never mentioned to me what they had updated. Read the rest of this entry »

You can add more than one sidebar section to your WordPress site. For example, with the stc-intermountain.org site, I added a whole bunch of additional sidebar sections in the Appearance > Widgets section. Read the rest of this entry »

Last week Will Sansbury mentioned to me that one of his ideas with the Atlanta chapter site was to provide an example or template of how WordPress could be used for chapter sites. I got to thinking, why isn’t there a standard WordPress template for chapters and SIGs to use?

Further, in WordPress 3.0, WordPress MU and regular WordPress will be merged. This is huge, because it means you’ll be able to create child blogs with a regular WordPress install. Essentially we could have one site like stcchapter.org with dozens of child blogs, containing subdomains such as intermountain.stcchapter.org, wyoming.stcchapter.org, and so forth. Read the rest of this entry »

Recently Will Sansbury and I gave a webinar to STC community leaders on chapter and SIG websites. Rather than giving a static, one-way presentation about theoretical concepts with web design, or boring people with technical details they probably didn’t care about, we held the webinar more like a design review workshop, not too different from a writing group workshop.

Although I spent three years in a creative writing program holding exactly these types of writing workshops, in which a group of people provide feedback on the story or essay someone submits, it never crossed my mind that designers probably sit around tables doing the exact same thing with websites. Read the rest of this entry »

Alistair Christie recently published a podcast about Unscripted Screencasts and Flare Extensibility. In the podcast, he considers whether scripts are necessary for corporate screencasts –  a good topic for exploration and testing. But he also gets into something a little more interesting: extending Flare with jQuery.

jQuery is the new Javascript. It provides smooth functionality that shows and hides components, slides objects around, and animates graphics in a sexy way. As an example, ProPhotoBlogs’ support section incorporates jQuery functionality. And the drop-down menus on Will Sansbury’s site are also jQuery driven. Here are a few jQuery animation effects. And slide-down effects. And fade effects. Read the rest of this entry »

Date: Jan 28, 2010
Time: 1 pm EST
Platform: Genysys (on the web)
Cost: Free for STC members
Registration required

Will Sansbury and I are giving a webinar on web design and WordPress this Thursday as part of the STC Community Leaders series. In the webinar, we plan to look at about five chapter/SIG sites in depth, examining what they’re doing well and how they could be improved. The sites will merely provide examples to spark discussion about web concepts and techniques (helping us move in a descriptive rather than prescriptive direction). Read the rest of this entry »

Audio clip: Adobe Flash Player (version 9 or above) is required to play this audio clip. Download the latest version here. You also need to have JavaScript enabled in your browser.

Download MP3
Length: 90 min.

Lyn Worthen presented to the STC Intermountain chapter tonight on running your own business as a technical communications consultant. She covers almost everything you need to know as a consultant, including rates, billing, contracts, marketing, taxes, business structures, hours, salary, tools, locations, niche services, portfolios, client communications, and more.

Here’s her presentation description:

Unlike the consistent schedule, workload, and wages of a 9-5 technical writing job, going it on your own as a consultant or contractor is a lot like riding the tide. Sometimes the tide is “in” and you have plenty of work to keep you happily tapping away on your keyboard; the projects are queuing up, the money is flowing, and all’s right with the world.

Other times, the tide is “out” and you find yourself walking on a desolate beach, staring out at the horizon, waiting for your ship to come in — and, if you’re lucky, picking up the occasional small job still lurking in a hidden tidal pool; money is scarce, and as the siren song of Corporate America tempts you back into the relative stability of captured employment, you question the wisdom of continuing to go it alone.

And then there are the “tsunamis,” those times when you have more work than one person should ever be expected to handle; yet in spite of the fact that you’re barely keeping your head above water, you’re reluctant to say “no” to any of it because you don’t know how high the floodwaters will rise or how long the drought that is sure to follow will last.

About Lyn Worthen

Lyn Worthen’s company is Information Design Co: Technical Communications Consulting, based in Utah and serving local, national, and international clients. Lyn is a member of the STC, the Utah Women Tech Council (WTC), and National Association of Women Business Owners (NAWBO). You can find out more about her through her Linkedin page. To contact Lyn, send her an email at lynw@xmission.com.

This Wednesday, Jan 20, there’s an Intermountain STC Chapter meeting at 7 pm. in the Sandy library. Lyn Worthen will be speaking on running your own technical communications consulting business. Here’s an excerpt from her description:

Unlike the consistent schedule, workload, and wages of a 9-5 technical writing job, going it on your own as a consultant or contractor is a lot like riding the tide. Sometimes the tide is “in” and you have plenty of work to keep you happily tapping away on your keyboard; the projects are queuing up, the money is flowing, and all’s right with the world.

Other times, the tide is “out” and you find yourself walking on a desolate beach, staring out at the horizon, waiting for your ship to come in — and, if you’re lucky, picking up the occasional small job still lurking in a hidden tidal pool; money is scarce, and as the siren song of Corporate America tempts you back into the relative stability of captured employment, you question the wisdom of continuing to go it alone.

And then there are the “tsunamis,” those times when you have more work than one person should ever be expected to handle; yet in spite of the fact that you’re barely keeping your head above water, you’re reluctant to say “no” to any of it because you don’t know how high the floodwaters will rise or how long the drought that is sure to follow will last.

Everyone is invited, both STC members and non-members. Cost is free (since it’s held in a public library). Read more details here.

In Screencasts: So what?, Kristi Leach tells an engaging story about a turnaround screencast. She explains how one good screencast can change users’ attitudes about software. Here’s an excerpt:

I rarely watch video online. Unless it’s a funny meme I have deliberately searched for, or a show that I missed, or Netflix, I won’t press play. If a blog post is all video, I skip it. I rarely appreciate video instructions, either–they take too long, because I’m pausing, following the step, playing, pausing again. I was having trouble imagining how videos were going to improve our help systems or fit into our schedules.

Scriptorium is presenting a free webinar on the DITA features in Madcap Flare this Tuesday at 11 a.m. EST. Here are the details:

Presented by Sarah O’Keefe, this webcast demonstrates using MadCap Flare to create WebHelp from DITA-based content. Topics covered include:

• Importing DITA content into Flare
• Map file handling
• Cross-references and links
• Relationship tables
• Conrefs
• Conditional processing

By the way, you can keep up with other upcoming webcasts from Scriptorium by subscribing their newsletter, keeping up with their site’s feed, or clicking the Scriptorium graphic in my sidebar.