When the “right” tool isn’t the “best” toolWhen the “right” tool isn’t the “best” tool

Posted August 1st, 2010 by paul | 2 Comments »
Category: MadCap Flare, Opinion, Software, TW Tools, Technical Writing, Work |

Not too long ago, I found myself stuck between a rock and a hard place. I work for a large organization (30k+ world wide workforce), and I’m just one tiny fish in a very large lake.

I was asked to provide help content in the form of a getting started guide for a piece of software that was going to be released world-wide.

I started working on the project using my tool of choice, a help authoring tool called MadCap Flare. This is a tool I really like, and have been using for several years. I’m something of an expert on Flare, so it is my first choice for pretty much any authoring project.

I started working within my group, however, and found that Flare wasn’t going to be the right solution for this project because of project constraints outside of my control. We have an in-house translation group that does all our content translation. They have their tools in place and are not interested in obtaining and learning to use a new tool (MadCap’s Lingo tool). There are certain strings in the project (specifically surrounding variables and master pages) that wouldn’t get sent to translation if they didn’t use Lingo. This project is going to go out in 24 languages, so simplifying the process is essential.

Read the rest of this entry »

Print this post, or send it to a frend: Print This Post Print This Post Email This Post Email This Post

Giving Student Members of STC a VoiceGiving Student Members of STC a Voice

Posted July 30th, 2010 by paul | 5 Comments »
Category: Opinion, stc |

Recently on the Techwr-L list, there was a firestorm of controversy regarding allowing student members the right to vote in STC Society-level matters.

The STC Board recently conducted a survey, asking for input on whether or not to allow student members to vote at the Society level. (The right of student members to vote at the chapter or community level is determined by the chapter or community’s bylaws. However their right to vote at the Society level is specifically prohibited by the Society bylaws.)

Much of the discussion on the listserv was focused on the results of the survey including whether or not to make individual responses public (anonymously). That’s an interesting discussion, and if you’d like to have it, I recommend the thread on Techwr-L. Instead, I’d like to focus on the topic, and why I think students should have the right to vote.

First, lets talk about the community level. (For the purposes of this discussion, I’m including both chapters and SIGs (Special Interest Groups) in the concept of “communities”.) Should STC communities allow student members a vote in community business? I say yes. Here’s why: Student members who join a community do so like any other STC member: they pay an additional fee to join the community. The fee to join the community is the same for students as for regular members. Their membership in the community, therefore, represents an interest in that community and its members. From that standpoint, I can’t see why student members should be treated any differently than regular members of the community.

Some people believe that student members–because they are students–are less reliable than regular members. Maybe they think this is because Society-level membership for students is less expensive, so students are less committed to the profession and thus the community. I disagree. First, I think it is erroneous to assume all student members are typical college age students. That simply isn’t true. There are lots of student members who, mid-career, have gone back to school to improve their skills, or get an advanced degree to help improve their marketability. Are some student members typical 18-25 year olds? Yes. But certainly not all, so it is unfair to judge the group based on our perceptions (or stereotypes) of 18-25 year olds.

Some people believe that those students who are in the 18-25 year old group are too inexperienced to provide a balanced perspective on what the community direction should be. To me, that just sounds like age discrimination. In the United States, we allow these people to serve in the military and we allow them to vote in political elections. We expect them to research the issues and vote based on their beliefs. Do we somehow believe that an STC member is qualified to vote for the US President, but can’t understand the complexities of STC, and so therefore shouldn’t be allowed to vote in Society issues? I don’t buy it.

I also believe that student members are hopefully learning the latest trends and technologies, and can provide the Society with needed perspective regarding these issues. When I was in my undergrad English program with a tech comm emphasis ten years ago, I was taking classes on XML programming–a class that directly affected my ability to get my first job out of college. I believe many of our student members are learning using the latest software and tech comm tools. Let’s hear what they think about trends in the field and how we can solve some of the problems we face. A different perspective on an old problem is sometimes what is needed to solve it.

At the Society-level, I think the same reasoning applies.

Some argue that because student members paid lower dues than regular members, the student members are less inclined to feel ownership in the Society, or care about the issues they would be voting on. I don’t think that is a fair argument. I would be interested to know how many “regular” members have their STC dues paid for (wholly or partly) by their employers. I’d also be interested to know how many students have their STC dues paid for by their educational institutional.  My personal experience is this: When I was a student STC member during my undergrad years, I paid my own dues. All of them. And because I was a student, it was a bigger chunk of my total income. Every job I’ve had since I graduated (three companies) has paid for my STC dues. Now I recognize that isn’t the case for all members. Many of our regular members are paying out of their pockets, but I know that many people are having their STC dues paid (at least in part) by their employer. Plus, most of our regular members are paying a lower overall portion of their annual income to STC dues than manyof our student members.

Considering all of that, I think that our Student members joined because they have an interest in the profession and the Society. Most of them are paying out of their (smaller) pocket to be a member. Many of our regular members are not. I don’t think that lower membership fees for students is, of itself, a reason to deny them a vote in Society business. In fact, I can’t think of any compelling reason why students shouldn’t be allowed to vote.

When the Intermountain Chapter presents its new bylaws next month, you will almost certainly see in them the right guaranteed to all members–student and otherwise–the right to vote in chapter business. I hope the Society-level board will carefully consider their reasoning for not allowing student members to vote, to see if the reasoning is valid.

Do you disagree with me? Let me know your thoughts on student membership voting in the comments below.

Print this post, or send it to a frend: Print This Post Print This Post Email This Post Email This Post

Among the eliteAmong the elite

Posted July 30th, 2010 by paul | 1 Comment »
Category: General/Random |

I’m flattered that I was listed by Mindtouch as one of the Most Influential Technical Communication Bloggers. I think it is really cool to see social media used by people in our profession. I’m also gratified to see two of my work colleagues on the list: Tom Johnson and Ben Minson. It is awesome to work each day with such great people, and I’m glad to be on their team.

If you are looking for some great technical communication blogs, you should start with Mindtouch’s list. There are some great, great people on that list. I’m proud to be included among such illustrious company!

Print this post, or send it to a frend: Print This Post Print This Post Email This Post Email This Post

MadCap introduces new community-written newsletterMadCap introduces new community-written newsletter

Posted June 16th, 2010 by paul | Comments Off
Category: TW Tools, Technical Writing |

Today MadCap Software released a new community-written newsletter. Up to now, if you’ve received one of MadCap’s newsletters, you’ll know that they have been written by people on MadCap’s staff. They have sales-focused newsletters and support-focused newsletters, but they have all come from the MadCap staff.

This new newsletter, MadNewz, will primarily be written by community members. The inaugural newsletter is a commentary post featuring ten “best practices” for single sourcing. (Read it.)

In this first newsletter, the author uses a conversational, informal tone that doesn’t sound like corporate-speak (which I think was intentional). It contains some useful information for current Flare users, the primary audience. This is a cool idea, as it will give community members a chance to contribute and let their ideas and work be showcased by MadCap. The bottom of the article includes an e-mail address to write to if you would like to contribute to a future article.

Some things I would change: first, the weird gradient background doesn’t work for me. It distracts me from what I’m reading, which isn’t great design. Second, it was only after I read the article twice that I noticed the author’s information in the sidebar. I would have preferred to see the author’s name beneath the post title. When I’m reading articles on the web, I generally tend to ignore sidebars because they generally include navigational information, or other content not directly relevant to the article I’m reading. I found it confusing that the author info was in the sidebar—so much so that I almost posted here that I was disappointed that the author wasn’t given credit. These are very minor shortcomings, however.

All in all, I’m pleased with the direction, and look forward to some quality community-driven content in the newsletter.

Print this post, or send it to a frend: Print This Post Print This Post Email This Post Email This Post

Friday Brain teaser: TrianglesFriday Brain teaser: Triangles

Posted June 11th, 2010 by paul | 6 Comments »
Category: Friday Brainteaser, General/Random |

It’s Friday, and you want to give your brain a break for the week, right? Before you put your brain away for the weekend, try this brain teaser. I grant you, this has little to do with technical communication, however you might argue that it is an exercise in looking at things from multiple perspectives. Anyway, give your answer in the comments. First correct answer wins. I don’t know what you win. Respect, maybe. Or something non-tangible like that. Anyway, have a go and see what you come up with.

(Googling is cheating, just so you know. Remember the honor code?)

How many triangles can you find in the following diagram?

Hint: Drawing and using a highlighter to mark each triangle is helpful so you can be sure you don’t double-count or miss one.

Read the rest of this entry »

Print this post, or send it to a frend: Print This Post Print This Post Email This Post Email This Post

Bad Behavior has blocked 538 access attempts in the last 7 days.