Posted in Uncategorized

If Tech Comm had its own Coachella, how would it be done?

coachella[WARNING: this is a long post, but jam-packed with information!]

Every industry has its own rock stars. Those are the people who have lived, spoken, and written about topics in a particular field. The information and perspective they provide are considered out of this world.

As technical communicators, we are fortunate that we have lots of tech comm rock stars among us.  There are several events that happen over the course of a year that allow several of those rock stars to come to one place to dazzle us with their brilliance, and we are the better for it.

Among the ultimate organizers for such events is Adobe. For the 2013 STC Summit’s “Adobe Day,” they put together a lineup that would make any tech comm groupie squeal with joy to be able to hear some of the leading minds and pacesetters in technical communications. The best part is that, as always, the events are not product sales pitches, but truly a compilation of thought leadership.

The speakers included headliner Charles Corfield, the inventor and “father” of Framemaker, content strategist Rahel Anne Baillie, online learning educator John Daigle and content strategist Mark Lewis. I’ll be writing more about each of their talks soon.

For this post, I’m going to start with the panel discussion that was at the end of the event first. The panel discussion wrapped up Adobe Day well,  and I’m using it first as I think it will to help set the tone for the next blog posts about the event.

ScottAbel
Scott Abel, “The Content Wrangler” asks the panel a question.

Scott Abel, “The Content Wrangler,” served as our trusty moderator for the discussion titled, “The Changing Role of Technical Communication Professionals–Looking at the Decade Ahead.” This was a similar theme to the Lavacon Adobe Day, but with a different set of panelists, the attendees were sure to get a different perspective this time around.

The panelists for this talk included:

panel
L to R: Joe Welinske, Ray Gallon, Sarah O’Keefe,
Bernard Aschwanden and Kevin Siegel

Scott started the panel out with the questions, “What do you think will be going on in technical communication in the next 10 years? What are the necessary things for tech comm going forward?”

Kevin Siegel replied first, saying that technical communicators need to learn how to write content so that content can be consumed quickly, as the average attention span of online consumers is about fifteen seconds, and the mobile is the most viable means of getting content out, so think mobile!

Bernard Aschwanden felt that networking was most important going forward. Face-to-face discussions–not social media discussions–with subject matter experts, your audience, and anyone else who is going to consume your content will help you learn what is required for your content. He stressed that ideas and tools are constantly changing, and technical communicators need to be able to adapt. Bernard continued by saying, “No one wants to read what you write.” He emphasized that readers read the output of tech writers because they have to, so tech writers should making information easier to find and easier to read.

Sarah O’Keefe emphasized that the biggest skill gap in technical communication is how content and information is relevant to business. Business needs content because of…why? The most important skills required in Sarah’s eyes bring relevance–like ROI (return on investment)–so technical communicators need to learn how to write business cases for tools and other resources to be able to deliver effective products and outputs.

Ray Gallon agreed with Sarah’s point of view, and also emphasized Bernard’s point about adaptability.  Ray stressed that technical communicators have a unique view, so using that special view plus being adaptable will help technical communications go forward. He believes that software is driving content and making decisions, so we must create it on how software creates things today.

The second question that Scott posed asked, “What is the global impact with tech comm?”

Ray responded first by declaring that all technical communicators should have an understanding of at least three languages, as knowing three languages lends to their global credibility.  Since I know that localization is a big emphasis these days in technical communications, Ray’s comment made a lot of sense to me.

Joe felt that in ten years, technical communicators will still be the same people, but traditional tech comm documentation will be less relevant, and QA (quality assurance testing) of documentation will be more prevalent. He emphasized that by testing the documentation, it allows us to truly understand what part of content is not being used, and what part really matters.  He also agreed with Charles Corfield (more on his talk in a future post) that voice and multi-screen publishing will be important going forward. He stressed that access to multiple devices are needed as you write, especially to test usability and “Google-ability.” He felt that a technical publications department needed at least three smart phones and three tablets for testing content on commonly used mobile devices as emulators don’t work as well. Real devices, including the ones you don’t like, are needed to see how well your content works.

The next question posed was, “Have you had an ‘ah-hah’ moment with things going forward?”

Scott chimed in his own response, saying that he thinks looking at internationalized English is important going forward. He felt that having a controlled vocabulary and other English language standardization will allow content to be created in form of English that machines can understand.

Kevin thinks localization is highly important, backing this claim up with the fact that the most popular article in his company’s weekly newsletter is about localization. He felt that soon enough, we’ll be converting books to other languages more quickly and easily.

Bernard’s “ah-hah” moment was when he realized that people are the key, not products or tools. He felt that typing was dying, and that technology is leap-frogging. He talked about how younger people today commonly connect and communicate without face-to-face person contact, not caring about political correctness and preferring to connect with those who are like-minded. He said, “Teens have few barriers with race, gender or sexual orientation. We must get over our own barriers to address needs of future consumers.” He emphasized that people are needed in order to work collectively, we need to be able to connect effectively with people.

Sarah’s “ah-hah” realization involves the “rise of the machine” and the machine integration of content.

Ray concurred with Sarah, pointing to Google Glass as an example, declaring that Google Glass is the “caveman” version of the next generation of machines that technical communicators with encounter.

Joe’s “ah-hah” was understanding that mobile apps are not interested in being help documentation. Instead, mobile apps involve how to have product integrated in everyday use.

At this point, the floor was opened to attendees who had questions. The first audience question asked if technical communicators need to be the drivers of change and adaptability. Ray answered for the entire panel with a resounding, “YES!”

The next question asked if there was any empirical data to back up the statements made in this panel discussion. Sarah answered that that her responses were derived from the anecdotal data from client requests. Joe said he based his responses on the QA testing done  he’s done over time, and stressed knowing one’s audience. Bernard agreed with both these responses.

The last question asked about relevance–is this a PR problem for technical communication, or is this more of a marketing communication issue? Scott piped in that marketing communication is meant to dazzles customers, but technical communication provides the real customer experience, so in essense, tech comm IS marketing!  Customer service is central.

Ray felt that content is permeable and will get more so over time. Various departments will disappear due to unified content strategy; things will get blurred and content will get unified, so tech comm will be an integral part of teams.

Bernard reminded us that, “We must get to know the ‘language’ of our audience in order to stay relevant.” Scott reiterated that idea, stating that globalization is going to be really key going forward, which will affect ROI.

Joe had the last word, stressing that how we present what we do is going to make a difference!

As you can see, it was quite the lively conversation, and the ideas presented here were more concentrated on localization, technology and networking with people going forward. It’s amazing to me to hear a different perspective to the similar questions asked at the Lavacon Adobe Day panel just seven months ago! It does prove to me that adaptability and understanding the bottom line of what content is needed, and how to disseminate content with ever-changing technology is key going forward.

Thanks to all the panel participants for your insights! (Also thanks to Maxwell Hoffman, as I used both my notes and his notes on Twitter to recall this panel discussion.)

To any of the panel participants–if I misquoted or mis-paraphrased you, please feel free to comment below to correct me!

So, this was the closing act of our tech comm “Coachella?” Impressive! Stay tuned to learn more about the main acts of this gig!

Posted in Uncategorized

Another one of those 2012 Tech Comm Years in Review? But it’s MINE…

MP900309664It’s December 31st, 2012, and the end of another long year has come. This is the time of year when everyone starts to see the year in review posts and articles all over every media source imaginable. I’m no different– I’ve already posted a Top Ten Posts of 2012 for TechCommGeekMom.  But this post is more about my reflection of the year–and what a year it’s been!

This is not to say that everything has been coming up roses for me this year. Upon reflection, there were a lot of good things that happened over the past year that were never expected and were really great. There were also things that were definitely not so great.

The not as great things included problems that my son was having at school that greatly affected his behavior, me getting pneumonia for a month last winter, losing my full-time job, and being laid off my part-time job. Just those things alone could easily make it a bad year, especially if you knew some of the details of the school problems my son was having.

But there were so many things that outweigh those negatives that for once, I can actually say that 2012 was a pretty good year for me. The first big thing was that I graduated from NJIT with my MSPTC. That was the result of two and a half years of blood, sweat and tears–sometimes literally–to get it finished. It was so much a part of what I did for a while that I actually miss it. The fact that I actually graduated, with honors no less, is surreal. I can’t believe that it’s all finished and done, when I feel like I should still be taking a class or doing something more, like writing up another paper.  I was very fortunate to have made several friends in the program, even through this virtual program, and make connections that I think will benefit me for life. The knowledge I gained from the program will also serve me for life as well, I am sure.  I know that NJIT was proud enough of my recent accomplishments enough to feature me as one of its “poster girls” for the Continuing Education program by featuring me in a promotional video for the school. I’m honored and still surprised that they picked me, but appreciate the nod of approval nonetheless.

The other part of what made this year exceptional was this blog. What began as a combination of a class assignment and something to do on a whim has taken on a life of its own. I don’t think anyone, especially me, would have expected anyone to be reading it with the gathering that I’ve collected over the past year. Social media has truly been key to many of the successes I’ve had this year.  I’m glad that I started to become more involved professionally with Twitter and Facebook especially, in order to connect with other technical communicators. Not only did I seek to learn from other technical communicators in the past year, but I used social media as a means of marketing this blog so that my voice could be heard amongst the many great voices out there. The amazing thing to me is that my voice was heard.

Now, I did have some unexpected help along the way. As I’ve explained in the past, it was an early post in which I vented my frustrations about learning tech comm software that someone heard me very loud and clear.  It was someone at Adobe, who not only heard me, but also wanted to help me.  That person was Parth Mukherjee.  It was very early in our contact that he wanted to help, and offered me a webinar. What, me? A webinar for someone just out of grad school? Yes, crazy as it sounded, that what he offered me and I took it. I’m glad I did. Along the way, I got to know Saibal Bhattacharjee, Maxwell Hoffman, Ankur Jain, and Tom Aldous at Adobe as well, and they constantly provided me with more opportunities and support throughout the year–many more than what are listed here. The biggest highlights of this relationship for me were doing the webinar in June that gained me initial greater exposure, and when I was invited to be one of Adobe’s guests at their “Adobe Day” pre-conference event at Lavacon. For a gal who is still new to the field to be invited to “run with the big boys and girls” was a thrill! I learned so much at the Adobe Day conference, and I had a chance to meet and get to know some of the people that I had not only gotten to know through social media, but people I revered and respect in the field.  There have been so many good things that happened to me thanks to Adobe, and I don’t think I can ever thank them enough. As I’ve also said many times before, I was a big fan of Adobe’s before the connection with Adobe’s Tech Comm team, but now they’ve allowed me to become truly loyal to the company with everything they’ve done for me personally that they didn’t have to do. Thank you so much!

I also had an opportunity this year to express my technical communications knowledge in a different way–I was able to teach a virtual class in business and technical writing to Microsoft Korea through the World Learning Company. It was a unique opportunity to present information not only so the students could understand the information, but I truly wanted my students to learn the information so they could use it more often in their everyday business communications. I got great feedback from the end-of-class surveys as well as directly from the students themselves that I made it easier to understand these complicated language nuances, especially since English was a second language for nine of the ten students I had! It was a great opportunity to flex my knowledge muscles to help other people become better writers, and I enjoyed it thoroughly.

A big part of this year was all the people I met who helped me along the way. In addition to those at Adobe and NJIT, I met SO many individuals along the way that helped me through this first year of being an “official” technical communicator. I’m sure I’ll be missing someone from this list of tech comm and e-learning professionals, as there were so many, but off the top of my head, they include RJ Jacquez, Mayra Aixa Villar, Miriam Lottner, Toby Price, Barrie Byron, Jamie Gillenwater, Sharon Burton,  Christie Fidura, Shay Shaked, Marcia Riefer Johnston, Colum McAndrew, Renaldo Lawrence, Joe Ganci, Sarah O’Keefe, Val Swisher, Jackie Gerstein, Anita Horsley, Scott Abel, Chad Udell, Alyssa Fox, and Karen Mahon. Each person here, and many others whom I met through social media or in person, contributed to my knowledge base and growth not only as a technical communicator and e-learning specialist, but also as a person. I thank each and every one of you for your support in taking me under your wing, but also for your friendship.

I also want to thank Gary Woodill, who is one of the m-learning gods in my eyes, for retweeting my tweet promoting my Whitepaper, thus giving it his understated blessing. That was a big deal to me for you to acknowledge it and deem it worthy of retweeting the link.  Also many thanks to TechWhirl, especially Craig Cardimon, for promoting two of my blog posts in recent editions of the “Tech Writer This Week” feature on TechWhirl.com. For me, that was a huge indication that I have “arrived” in tech comm.

So, as you can see, 2012 was actually a very good year for me. Sure, I didn’t have a full-time job, and I had illness and issues that were beyond my control at home, but for me, this has ended up being one of the best years that I’ve had in a long time. My first full year of being a technical communicator hasn’t been without some bumps along the way, but through this blog, my school connections, and all the new social media connections I’ve made in the past year, I wouldn’t change a thing. What a whirlwind for a “newbie”! I can only hope that I will continue to have the support of all these wonderful people, and be able to truly practice what I’ve learned over the past year in my new adventures as a Web Publisher for BASF in 2013.

This was the year of building, and I’ve gained a fantastic foundation. Now is the time to continue to grow and move onwards and upwards! I’m anxious about 2013, but having this strong foundation, I have a feeling that it’s got the potential to be another great year.

What are my resolutions for 2013? Well, I don’t know about resolutions, but I know that some of the things that I hope to achieve, other than a firm establishment in the tech comm field, is to go to the STC Summit in May (I hope), and maybe some other conference as well, if I can afford it. I want to meet so many more people in tech comm, and absorb the  information given by the best and brightest in the field. This year, I was the new kid on the block, and in 2013, I want to be part of the next generation of technical communicators helping to take the field further.

Thank you to everyone reading this, and have an incredibly Happy New Year!

Posted in Uncategorized

What you so afraid of? Part II – The Tech Comm Edition

torchwood_jacktorturedI’ve been reflecting a lot, lately, into what makes me continue to pursue a technical career, especially in technical communications. I’ve been thinking about what I’ve been doing in the last year to stay on top of trends and issues in the technical communications field, because the last thing that a prospective employer needs is someone who is stuck in his or her own ways, never learning and never progressing. Technology is constantly changing, and both technical communications at-large as well as the e-learning world are both in the flux of a “revolution”–a revolution that reflects that these fields are in the process of changing and revitalizing in order to keep up with modern thought and technological advances. One of the reason I try to stay as active as possible in social media is to stay on top of those trends and have an understanding of the current issues and advances in these fields so that I can go into a job understanding what the needs of a company are in order to help that company move forward.

And yet, it seems like there are so many companies, from my own observation, that are terrified of change and progress. Is it too much too soon? Perhaps it is. I’ve talked about this topic before at length specifically in regard to how the m-learning revolution is trying to make headway in the e-learning field in my post, “What Are You So Afraid Of?” back in July 2012. But as my most recent experiences personally have been more tech comm related, I’m starting to think that this fear of progress extends to the tech comm world as well.

I remember a big part of what was mentioned at the Adobe Day panel was the idea that as technical communicators, we understand the value of our work better than the higher-ups in managerial positions, and it’s our duty, in many respects to make sure that these higher-ups understand that value and the ROI (return on investment) that using structured content and other tools at a technical communicator’s disposal will benefit the company in the long run.  When I’ve gone on interviews or worked at various jobs, I talk about the advances that are going on involving mobile technology and how companies need to keep up with this fast-growing technology. While the interviewers or other people I speak with are impressed with my knowledge and agree the changes need to be made, the argument made is that the higher-ups, who don’t understand this value of technical communications as well as we do, insist on sticking with old ways, and slowing down progress for the sake of comfort levels. It’s a “Don’t fix what ain’t broken”-kind of mentality. I know that sometimes budgets can limit how soon progress is made, because ever-changing technological advances can be expensive, especially if one is always trying to keep up with the latest and greatest. But I also know that spending a lot of money on ancient systems that aren’t keeping up with current technology and even supporting such ancient technology and methods that aren’t even supported today is throwing money away too. Would we even have smartphones or cell phones if we settled for landline phones only? Would microprocessing computers have even been invented if we settled for manual typewriters long ago? Settling for the old doesn’t really benefit anyone, especially global companies that want to stay ahead of the competition.

The photo above is a favorite character on one of my favorite TV series, “Torchwood,” named Captain Jack. Captain Jack is generally a fearless guy, especially since he has some sort of capability where he cannot die. In that sense, when up against some sort of danger personally, he’s got nothing to lose at all. But since he’s lived for so long, he also respects the past and understands the full impact of his actions and how they affect others. Despite having nothing to lose by his actions, he’s actually the conservative one when it comes to making decisions, basing his actions on what he knows and what he researches first. He is cautious, but he’s not against trying something new if it makes sense. If you see him with a facial expression like the one he has above, you KNOW that something REALLY bad is going on, and it has greater repercussions beyond himself.

There are times that I have that same feeling, at least in my own mind.  While I respect that certain systems work and work well, and I know I’m not the most experienced technical communicator out there, I’ve done some due diligence, and again, I try to keep up with what’s going on in the world so that I’m ready to keep up with the latest advances and thought in the field. When I hear that companies are hesitant to budge from an old way of thinking, I feel frustrated. How are these companies supposed to keep their standings as world-class, advanced companies when their communications are not cutting edge, or at least up-to-date? Again, I understand that executive managers have to look at the full picture and work within budgets, but with a world that is going mobile faster than anyone can keep up with, why aren’t big companies even attempting to keep up even a little bit? Just as I had mentioned in the last article on this topic relating to m-learning mentioned above, I see it occurring in tech comm itself as well, with companies not keeping up with the latest version of how documentation outputs have to be changed to keep up with mobile technology. There is little risk with proven methods.

As a global economy–not just in the United States–we are trying to emerge from one of the biggest financial crises in economic history. Looking back at history, it’s usually during these times of economic woe that some of the greatest leaps in technology and business have been made, using great intellect and creativity to push things forward when resources were scarce. This is a time of emergence again. There are so many companies that have taken the leap forward to help take us to the next step. Smartphone and tablet manufacturers have brought us the next means of gathering information and providing communication between us. In turn, software manufacturers, like Adobe with TCS 4 and MadCap with Flare, among others, have provided us with tools to help take the content that technical communicators write to a new level of efficiency and flexibility among all the new mobile devices in the world while still keeping up with desktop capabilities.  If any companies embrace any of the changes that are going on in the technical communications field, they can deliver bigger and better communications thus benefitting from the changes, not being hindered by them.

So, what are you so afraid of, corporate world? Help technical communicators help you. Even the smallest step forward will be step towards a better future for your company.

Posted in Uncategorized

Adobe Day at LavaCon 2012 Roundup!

This post is just a quick summary of the Adobe Day at LavaCon 2012 series from this past week. As you see, there was so much information that it took six posts to try to summarize the event!

Being in Portland, Oregon was great. It was my first trip there, and being a native Easterner, my thoughts pushed me to that pioneer spirit of moving westward in this country. Once there, I saw a hip, young, modern city, continuing to look towards the future.  The information I gathered at Adobe Day was general information that was endorsement-free, and practical information that I can use going forward as a technical communicator, and that by sharing it, I hope that others in the field will equally take on that pioneering spirit to advance what technical communications is all about, and bring the field to the next level.

To roundup the series, please go to these posts to get the full story of this great event. I hope to go to more events like this in the future!

As I said, I really enjoyed the event, and learned so much, and enjoyed not only listening to all the speakers, but also enjoyed so many people who are renowned enthusiasts and specialists in the technical communications field and talking “shop”. I rarely get to do that at home (although it does help to have an e-learning developer in the house who understands me), so this was a chance for me to learn from those who have been doing this for a while and not only have seen the changes, but are part of the movement to make changes going forward.

I hope you’ve enjoyed this series of blog posts. I still have many more to come–at least one more that is inspired by my trip out to Portland, and I look forward to bringing more curated content and commentary to you!

The autograph from my copy of
Sarah O’Keefe’s book,
Content Strategy 101.
Awesome!
Posted in Uncategorized

Adobe Day Presentations: Part III – Joe Welinske and Multi-Screen Help Authoring

Joe Welinske
President of Writers UA

Joe Welinske of Writers UA followed Sarah O’Keefe’s presentation on Adobe Day. I was especially interested in hearing what he had to say, because the topic of his presentation was  about “Multi-screen Help Authoring–How to Deal With the Explosion in Device Sizes.” Anyone who’s read this blog before knows that I’m very much into the mobile revolution, and while I’m usually talking about m-learning more specifically, mobile goes beyond learning, and using mobile in technical communications is connected to m-learning in many ways.

Joe explained that the device population keeps growing! Smartphones and desktops are changing; the sizes between smartphone and tablet devices, whether they be iOS, Windows or Android devices truly vary. The same content needs to be displayed on everything from large monitors to laptops to tablets to GPS to small phones–there are dozens of choices! How do you design a UI (user interface) for all these variations?

Joe explained that different devices have different dimensions, different operating systems, different user interfaces elements…lots of variations to contend with when creating content. He suggested that a “graceful, efficient adjustment is needed,” namely matching the amount of content and the type of content with a device without crafting solutions for each.  He contended that responsive design the key as it allowed for adaptive content. Responsive design would allow flexibility for different environments.

Joe mentioned that Scott Abel has touched upon this during his presentation, but Scott later clarified for me on Twitter, by saying, “That’s one way, although I question whether it is the best way…Lesson: Adapt content first, design second. Wrong content, right design = #fail.”

Joe continued by pointing out that one way to accomplish this objective included using HTML5/CSS3, tagging all objects in source code, create device-type style sheets, and including media queries in source. The end result would be a single-source content file that looks and works well on different devices. To prove his point,  Joe demonstrated how same source content looked on different devices, specifically the iPad versus iPhone in this example. Joe also showed an example of how he divides the devices by “buckets” when creating his style sheets into categories such as 10″ tablets, desktops, phones, etc. He recommended using a “parent” style sheet, then fine tuning with a device style sheet for each device type. This would help create a graceful adaptation using HTML/CSS and query to allow your content to flow automatically and intelligently. From that point going forward, a technical communicator can consider making mobile the starting point and expanding from there. Joe’s last point was that a small percentage of people from traditional technical communications are involved in mobile projects but the user experience and design skills are actually similar.

I agree with Joe that designing for mobile really does use many of the same skills as traditional design methods, but it does take a little extra time to lay out the thought process and structure needed to make the content be delivered from a single-source to multiple types of mobile devices. It’s a little tricky, but with some careful thought, it’s not really as complicated as it could be. By using single-sourcing and customizing style sheets, multiple output of content can easily be attained.  I strongly agree as well that this is the mentality that people need to adopt, whether involved in technical communications or e-learning/m-learning now.  I think this opened the eyes of many attendees in the room. Mobile really is an important consideration now in content output!

Next: Adobe Day Presentations – Part IV: Val Swisher asks, “Are You Global Ready?”