Friday, May 25, 2012

Tech Comm Friday (May 25)



Hello everyone! I'm Jessica Behles, and I just moved to Chicago and joined the chapter earlier this month. I'm super excited to be a member of the STC Chicago Blogging Team! I am always open to feedback, so please let me know how I can make your blog reading experience more awesome.

We're entering a three-day weekend here in the US, and many STC members will be using the time to wind down from the 2012 Summit. Several have already taken the time to post some thoughts, reflections, and/or reviews of their conference experiences. I bring you STC 2012: The Aftermath.

  • Random Notes from STC12 in Chicago - Val Swisher of Content Rules summarizes the good and not-so-good aspects of the conference. Verdict: mostly positive, despite the not-so-good bits.
  • There and back again – Notes from the STC Summit 2012 conference - Ellis Pratt of the Cherryleaf Technical Authors Blog posts from London his thoughts on the Summit. He summarizes the main themes and highlights of the event and provides an interesting discussion on the differences between conferences in Europe and the USA.
  • STC Summit 2012 wrapup – STC12 - Australian blogger Sarah Maddox, author of ffeathers, provides a multimedia summary of the conference with links to her session notes, photos taken while in Chicago, and a video of the Rough Drafts performance.
  • STC 2012 Summit Experience - Roger Renteria, author of WriteTechie, sums up and assesses his conference experience in the context of goals he set prior to the event. He has deemed it mostly successful.
  • STC Summit 2012 Pinterest - Although not strictly a blog, this Pinterest page set up by Tech Whirl offers a comprehensive photo retrospective of Summit 2012.

Tuesday, May 22, 2012

We're sad to see you go!

Friday, May 18, 2012

Do you need a style guide?


Recently, I was tasked with creating a style guide for our documentation department. As a bit of a perfectionist and a stickler for grammar, punctuation, and consistency, I was (not so) secretly excited to take charge of this project. Our documentation was a mess, and our team was growing. A style guide was in order!

 

Why create a style guide

I work for a company that started in 2001 with 6 employees, and the documentation department was formed along the way as the company grew. The team comprised a mix of employees with varying backgrounds, none of them in technical communication. And - sorry guys - it showed in our documentation. Our Administrator’s Guide is over four hundred pages of rambling text with differing styles of punctuation, grammar, and diction on almost every page. 

Enter the style guide. Among its many functions, the style guide does the following:
  • Keeps everyone writing consistently
  • Defines formatting for items like bulleted lists (like this one!)
  • Provides guidelines and allows new employees to get up to speed without having to sift through our existing documentation
  • Creates an avenue for writers to bring up issues for discussion with the team

 

How to create a style guide

For our style guide, I relied on the fourth version of the Microsoft Manual of Style. I started by identifying the biggest pain points in our documentation. For us, these included general style and voice considerations (most of this hadn’t been touched since it was first created years ago, so we had lots of very formal, antiquated language), the formatting of procedures and technical content, and user interface considerations.

I focused on what Microsoft had to say about these areas and created a basic guide that covered these issues. I also added a section for miscellaneous style decisions, such as numbers, acronyms, and screenshots. The usage dictionary section rounded things out, and our style guide was created.

 

Implementing style decisions

While the style guide itself is important, implementation by the team is totally crucial. The following items have made this easier for our team.
  • Wiki development - using a wiki to create the style guide has given us a dynamic, living document, enabling real-time interaction and easy access to this information for each team member
  • Team meetings to discuss decisions - it was really helpful for us to meet as a team to make sure everyone understood the style decisions and the way to proceed
  • Forum for submitting changes, requests, or things to talk about in future - for us, this is simply a wiki page where any member of the team can add ideas or requests for the team to discuss and decide on
We’re nowhere near perfect yet, and there is still a huge amount of work to do. But the style guide is an invaluable tool and makes doing our jobs more straightforward and seamless. 

Don’t have a style guide yet? Create one!

Summit 2012 Arrivals

Some Last Items for Summit Planning



STC Chicago's Bill Leavitt is a long-time member of STC Chicago, a past chapter president, a past international president, and an STC  Fellow and has attended many STC conferences. During these last couple weeks before the Summit, Bill has some advice to help you make the most out of your visit. 

Online Planning

As you plan your trip, go to www.stc.org and familiarize yourself with the hotel details, the program, and other activities at the Summit. 

What to Pack

The most common regret of first-time attendees is running out of business cards. You'll be surprised at how many people you meet that you'll want to remain in contact with. There will be around 800 people at the Summit, and don't be surprised if you give out 100 business cards. It's better to bring some home with you than to run short. 

Regarding dress, generally business casual is good for everything at the Summit. However, most people dress a little more formally for the Honors Banquet (i.e., business suit or sport coat, cocktail dress, etc.). The Communities Reception is usually business casual; however, the Music Jam immediately follows the Communities Reception, so you might want to dress more for dancing and partying that night. 

Many attendees dress pretty casually during the daytime--shorts if it's warm, jeans and a knit shirt if it's cool. Then I dress up a little for evening. Casual or business casual, you'll be in good company. 

Selecting Sessions

You'll want to spend some time selecting which technical session you want to attend before you come to the Summit. Many of the speakers are well known and very popular. However, if you're a first-timer, you should select the sessions you want to attend based on the content descriptions. With experience, you'll  become more selective with your choices. 

Note that the sessions of more popular speakers will be full. Try to arrive as early as possible to assure getting in. Also, have a second choice for each session in case its full. 

Be careful to avoid overbooking your schedule. Many of the sessions are intense in terms of the information you'll receive, and you don't want to burn yourself out. 

In addition, there are other activities for you to attend. Some are useful for networking with fellow technical communicators. Some are educational. Some will help you to develop your leadership skills. And some are just plain fun. 

Sunday Registration and Kick Off

As soon as you arrive at the Summit hotel and check into your room, go down to the STC registration area and get your credentials, the Summit program, and other related materials. Most areas of the Summit are off-limits to those who aren't registered. 

The highlight of Sunday evening is the Welcome Reception in the exhibit hall. This is actually a reception to introduce attendees to the many interesting exhibitors. It's a must-attend activity. It's also a great networking event. 

The most well-attended event of the Summit is the keynote address on Sunday evening just before the Welcome Reception. The keynote speaker this year is Scott Berkun. The Summit program will tell you more about who he is. The keynote address is also kicked off by the STC president. 

Monday Highlights

Monday evening is the STC annual Business Meeting at 5:00 pm. If you're an aspiring leader or want to know what's going on in STC, this event is for you. 

The Communities Reception on Monday night (6:30 pm) is an opportunity to learn more about and possibly join special-interest groups of professional interest to you. It's also a fun networking event with food. Among other things, it includes a prize drawing. 

Tuesday Highlights

Besides a full day of technical sessions on Tuesday, Tuesday night is a recognition night. You'll want to dress your best and attend the Honors Reception and Banquet. You'll be able to celebrate STC's new Fellows, Associate Fellows and most successful chapters as they're honored at this gala event. Note that the Banquet is not included in your registration fee; also, you must arrange who will be at your table at the registration desk if you have friends at the Summit.

Your Last Day

After a few hours of sleep, Wednesday has more technical sessions and the closing luncheon (where you'll learn about next year's Summit). 

Extracurricular Fun

Visit the Chicago chapter hospitality table in the STC registration area for information about Chicago, tourist activities, the hotel, and STC souvenirs. Visit the 2013 Host Chapter booth in the exhibit hall area to learn more about next year's Summit. 

Remember that STC Chicago is your host, and we're always happy to answer any questions you have. 

Submitted by Mary Whalen.

Last Spots Open for Summit Tours


Architectural Boat Tour

On my Must-Do List for Exploring Downtown Chicago, I listed an architectural boat tour as one of the options. Honestly, this is my TOP recommendation for Chicago tourists, and many other people agree with me on this thought. Because even native Chicagoans enjoy and recommend this activity, STC decided to offer a group tour for the Summit.

Participants can enjoy a one-hour cruise highlighting Chicago history and architecture. The cruise takes off at Navy Pier, travels up the main branch of the Chicago River, up the north branch to the East Bank Club, and then south past the Willis Tower (formerly known as the "Sears Tower") to the old Post Office Building. Along the way, a guide offers insights from experts and delves into the fascinating and little-known details about Chicago's famous skyline.

The tour is $63.00 per ticket and includes round-trip transportation from the Hyatt Regency O'Hare. The tour is Wednesday (May 23rd). It leaves the hotel at 1:00 pm and arrives back at the hotel at 6:00 pm.
For more information, visit the River View Registration page.

Second City Comedy Theatre Tour

Another personal favorite of mine for exploring Chicago is a night at the Second City Theatre.

The Second City tour includes round trip coach transportation and ticket to the show. The bus departs from the Hyatt Regency at 5:30 pm, getting you to the theatre at approximately 6:30 pm. There are a number of restaurants close to the theatre and the STC Chicago Chapter will coordinate group reservations. You may also take advantage of the food service at the theatre

This event is on Saturday night, so register right away if you're interested. You can visit the online registration page for more information, but you need to email stc2012@stc-chicago.org if you'd like to purchase a ticket.

Submitted by Mary Whalen.

Tuesday, May 15, 2012

Representing Chicago at #STC12

The annual STC Summit is a time to connect with our long-distance colleagues. For Chicago attendees, this year can also be a good time to discover local tech comm talent. Chicagoland and the STC Chicago chapter will be contributing a respectable delegation to the speaker lineup. Speakers talked with me via email about their backgrounds and presentations.

Chicago STC Members

Speakers from the Chicago chapter include local members as well as long-distance members.

Beth Najberg

I'm an independent instructional designer/information designer. I've had my own business, Beginnings, for 21 years. I develop customized training and document systems as well as train and consult with people about developing PowerPoint® presentations.

[Presenting is] a wonderful way to push myself to grow professionally. This is my ninth presentation - and it's just as exciting as the first presentation in 1999. It's also great to see when people know they will use my ideas.

I include 61 photographs and 8 infographics in the presentation, all ideas so people can make effective presentations. I also show how to identify a theme so all the images & infographics & ideas are tied together.

Emily Kowal

I work at Walgreen Co., an American retail pharmacy chain. I'm working on some compliance policies, but because of recent shifts in the workplace, I'm actually doing more auditing right now, hopefully temporarily.

I'm a member of the Chicago STC chapter, and I did a spot of judging for them a few years ago. I'm also the co-manager, along with Dawnell Claessen, of the Policies and Procedures SIG. I presented at a progression last year and, as SIG leadership, am doing it again this year.

Adam Evans

I work at kCura, a software company in downtown Chicago. kCura creates e-discovery software for the legal industry that's used as part of the discovery phase of litigation. I work on the technical writing team creating guides and end-user documentation for our clients.

I've wanted to present at the summit ever since I attended my first summit three years ago. I got together with a previous coworker and together we submitted a proposal.

The topic we're presenting about is something we worked on for over two years at my previous job. We're pretty proud of the change in workflow we created, and we hope we can inspire other teams to truly make documentation for the user.

Chris Hester

I’m an independent consultant, working with clients on technical communication and content strategy projects. For this year’s Summit, I am the Content Delivery track manager, and I also organized the Usability, User Experience, and Accessibility progression.

With progressions, participants attend three short presentations in an hour. As the organizer, I thought the cool thing about that would be facilitating the session, plus using a stopwatch and air horn to stay on schedule. When I shared that idea with the program committee, it was gently suggested that perhaps instead, I could participate in the progression and talk about personas. So here I am, happily inviting you to “Getting Started with Personas,” in which we’ll talk about how to create personas and look at examples of personas created for a content strategy project.

Kristi Leach (Me)

I am an independent user experience designer, content strategist, and technical communicator. Over the years, as a tech writer and volunteer, I accrued UX experience, and now I'm building a client base for whom I do user research and content marketing consulting.

I presented a session at last year's Summit: a mini-workshop on usability and content testing. This year, a couple of the Summit organizers contacted me about participating in progressions. As we talked about what I've been up to (design school and job hunting), I was invited to also do a full session in the User Experience track.

My presentation is about transitioning from tech comm to UX, and I'm actually still in that transition. I am still looking for a bread-and-butter UX client, or a full time gig. But I'm advising small businesses, and I've seen a steady increase in my response rates as I'm pitching my services. I'm planning to share how I've refined my efforts.

Mollye Barrett

My consulting practice is ClearPath in Milwaukee where I am the President and Principal Consultant. My day-to-day work includes vendor-neutral content management consulting and technical communication development. My focus is on content strategy, business case, ROI, content reuse, DITA, document analysis, workflow analysis, translation, single-source writing, handling file formats and document conversions. 

I have presented at other Summits and always enjoy interacting with other technical communicators. STC Summits are a great opportunity for knowledge sharing. I'm also attending as Manager of the Single Sourcing SIG and am leading a progression on Leadership Day. 

While the session is firmly focused on ways to select a CMS without drama, the back-story is about the change management process employed during the CMS selection process. So, In addition to developing a set of requirements, attendees will also learn about how the selection process worked for a particular group.

Mary Knepper

[My company is] Ryba Associates, Inc. (RAI). RAI provides custom training and documentation to help corporations and individuals reach their business and personal development objectives. I develop training in communication and rolling mill operations along with a number of associates.

I am a member of Chicago STC and have been for over 20 years, I believe; I joined the East TN chapter maybe five or six years ago as well as the IDL SIG. I was one of the original developers of the Chicago STC Institute and am currently managing our regional conference, the Practical Conference on Communication.

A colleague and I co-presented at our regional conference and decided we would offer a version of the same topic at the Summit. Ideally, audience members would bring an email with them that demonstrates "tone" and that caused some difficulties as a result. They can analyze it as part of our workshop discussion for the structure I review and see what the author could have done better.

Other Chicago Technical Communicators

You might find these folks at a chapter meeting or another meetup. STC events like the Summit are a also a good way to connect with our colleagues in the larger tech comm, UX, and business communities.

Jen O'Brien

I work for Manifest Digital (www.manifestdigital.com) - I am the Content Strategy Director, responsible for delivering on this discipline for our clients, as well as supporting sales activities. Some of the activities I perform include content strategy and development, learning strategy and development, user experience, business analysis and project management.

I've been active in STC for several years. I am a former Senior Member of STC, Chicago Chapter, and several communities including content strategy, learning, and project management. Although I am no longer a member, when I saw that the conference was in the Chicago area this year, I submitted proposals for presentation.

The presentation not only focuses on the content audit portion of a project; it includes components of a complete content strategy lifecycle for an intranet replatform - such as content mapping, gap analysis, content migration, process and analytics.

Patrick DiMichele

I have spent the last twelve years making the internet a better place. In my current role at Manifest, I've  helped to conceive a forward-thinking intranet focused on collaboration for Walgreens, a web-based game aimed at immersing little girls in the pink-tastic world of Barbie, and a set of mobile-friendly, self-service tools for Encompass Insurance.

Before Manifest, I worked at mStoner, where I created web strategies for colleges, universities and non-profits. I've led super-successful and award-winning initiatives for the American Dental Association, Ball State University, Bethel University, College of William & Mary, George School and Princeton University.

In the session, "Card Sort Your Way to Better Information Architecture," we'll walk-through the nuts and bolts of card sorting. Beginning with what it is and how it works we'll quickly transition into a review of how and when best to deploy card sorts for maximum impact.

In the session, "Create Meaningful Online Experiences," we'll ask: what makes one website memorable and another wholly forgettable? What drives you to return to a site repeatedly? The answers are often surprising and decidedly low-tech. We'll examine the concepts and intentions driving several compelling online experiences with a focus on uncovering ideas worth putting to work at your organization.

Halcyon Lawrence

I’m originally from Trinidad and Tobago but I’ve been living in Chicago since 2008 to attend graduate school. I'm in the final year of a doctoral program in technical communication at the Illinois Institute of Technology in Chicago.   I'm also a research assistant on an NSF-funded grant for research investigating language change in the Twin Cities.  You can read more about it here.

This is the second year that I submitted a paper for the STC conference.  In 2010, I wasn’t successful, but I was later contacted about turning my presentation into a webinar for STC.  I am particularly attracted to the diversity in the STC conference program.  My topic on speech intelligibility is different and I thought it might be of interest to the TC community.  The paper I’m presenting is part of my dissertation work on accented speech in the design of speech-mediated technology.

I am looking forward to meeting with the STC community and making contact with the local chapter at this conference.  I’ve been so impressed with the support services offered to new attendees and presenters.  It hasn’t even begun and I know it’s going to be a great event.

I’m advocating for technical communicators to spread their influence into other areas of design – in this case, the design of speech interactions.  The design of speech in technology products lacks regulation, with costly consequences.  There’s a gap there that I think TCs can fill.

STC Chicago Announcements

STC Chicago

STC Blog

Society for Technical Communication