Podcast: Documentation in the Cloud

Listen here: In this podcast, Michael Hiatt at mashstream.com presents to the STC Intermountain chapter on documentation in the cloud. By documentation in the cloud, he's referring to our move to the web of everything we do on the computer -- the running of applications, the saving of our data, the way we access and interact with all the information. He covers at a lot of ground in this presentation, touching on web 2.0,...

WordPress Tip: Avoid Getting Hacked through Bluehost's cPanel

It's always hard to tell exactly why or how a site gets hacked. One of the WordPress sites I created for a client kept getting hacked. I took more extreme security measures, changing the database table prefix, adding an htaccess file to wp-admin that filtered IP addresses, adding a plugin to encrypt logins, adding a firewall, moving wp-config to another directory, and other measures. I thought the problem was with WordPress. Then last wee...

Finding Space to Breathe: Managing Overwhelming End-of-Project Tasks

I'm nearing the release of a project that I've been working on for about a year. All those deadlines that seemed to be many months in the distance are suddenly weeks away. As the project manager was reviewing the rollout schedule with me, he paused to admit that he was a little overwhelmed with everything going on. There's simply a lot to do with a product rollout -- user acceptance testing, quality assurance regression testing, change ma...

Together or Apart: Collaboration Models for Technical Writing

Today I spent a rather lonely day writing documentation. I had one team meeting, during which our team gathered for what seemed like a brief second. We then departed back to our respective portfolios, most of us working alone and in solitude toward some distant documentation goal. Some writing teams sit together. They chum with each other all day long about commas and online help layouts. At my first job as a technical writer, I sat in a...

The Art of Asking Questions

The other week Shannon and I met with our daughter's teacher for a regular parent-teacher conference. Sally is in third grade but reads books beyond her level. She's read the entire Harry Potter series. She raced through the Percy Jackson books, and will read about anything with a horse in it. The last Jazz game I took Sally to, we stopped off at Barnes and Noble to buy her a book (Diary of a Wimpy Kid) for her birthday. By halftime she h...

Praise: The Worst Feedback You Can Give Developers?

Lately I have been logging a lot of bugs in JIRA, our bug-tracking database. In one day I logged 25 bugs. This past week I logged about 60 overall. It feels good to log bugs. I feel like I'm finding valuable gaps in the application where code simply isn't working. Despite these benefits to the project team, in a recent triage meeting with the lead developer, as we discussed the bugs that needed fixing, it looked like the world was on his ...

"I never really understood that feature, so I left it alone..."

The other day I rose early to conduct some user acceptance testing with a new version of our software. As I was going through the new version of the application with a user, he got excited about a new feature we were implementing, which allowed users to collaborate on items. Noting his excitement, and realizing that the new version of the software wouldn't be released for several more months, I explained that the current version had a sim...

The Common Language Everyone Speaks

Several weeks ago, I was reading something that caused me to worry. A line in a scriptural narrative biography tells how his father taught him in all the ways of right. As a father, I thought about what I had taught my children, and it wasn't much. They weren't going to become Enochs from anything I showed them. Football on Sundays, basketball during the week, too much TV, long absences at a remote job, lots of time sitting at a computer ...

Cures for the Information Exclusion Complex

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 l...

WordPress Tip: Add More Widget Areas to Your WordPress Theme

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. Adding more sidebar sections Adding more sidebars is useful if you're using WordPress more as a content management system than a blog. Someone asked me how I did this. The process isn't hard. I've broken it down into three steps. (...

What Would a WordPress Template for Chapter Sites Look Like?

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 WordPr...

Fragmented Communities and the Chapter/SIG Web Site Problem

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 exact...

Madcap Flare's Extensibility: Adding jQuery to Flare

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...

Web Site Critique and WordPress Q&A Webinar This Thursday

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 a...

Podcast: Riding the Tide of Technical Communications Consulting

Listen here: 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 ...