Posted in Uncategorized

Adobe Day@STC Summit 2014 – We Went Back to The Future

We definitely didn't hear this panel say to any of us, "I'm afraid you're just too darn loud!"
We definitely didn’t hear this panel say to any of us, “I’m afraid you’re just too darn loud!”

I apologize for my blog coverage of the 2014 STC Summit edition of Adobe Day being delayed–it’s been a busy month! But hopefully, you’ll feel it’s been worth the wait, and you had a chance to see my live Twitter feed as it happened.

The STC’14 Adobe Day felt a little bit different this year. One of the things I noticed was that as much as Adobe says that these Adobe Day events are Adobe-product free, lately, they haven’t been. HOWEVER, they are still not one big, in-person infomercial either. Adobe products are not brought up much, but if they are, it’s to show that they can be tools to use to create solutions to common tech comm issues. So, it might be an inadvertant infomercial in that respect, but it’s not done in a blatant way that screams, “YOU NEED TO BUY ME!!!!!! PLEASE BUY OUR PRODUCTS!!!” Adobe continues to do a good job in showing what tech comm issues are out there, and as leaders in the software field, they are tuned into these issues and are creating products that benefit the technical communicator. I think that’s fair enough. The talks, overall, were broader topics that in some instances used Adobe Tech Comm Suite tools to provide solutions. And you have to remember, while these talks are aimed to be product-free for the most part, it’d probably look pretty bad if you had someone declaring all the glories of a competitive product when Adobe is hosting the event. Y’know?

With that out of the way, I observed some other things that made this a little bit different. First, there were fewer speakers this year. I felt that was a good thing, because in the past with more speakers, each speaker would be racing to get his/her presentation completed in a very short amount of time, and there would be little time for questions or discussion. Since there were fewer speakers this year, each one could elaborate more on their topic, which allowed for more time for questions and discussion. More networking time during the breaks was also a benefit from having less speakers.

The other difference I saw dealt with the speakers themselves. While they were all familiar, established voices in the tech comm world, it wasn’t the same crowd that one usually sees at Adobe Day events. All of them have participated in Adobe events or other tech comm events before, but in the past, it usually is most of the same speakers up on the podium. While I like all the “usual suspects” very much, and consider them my mentors and have become friends with several of them, seeing these new “players” was actually refreshing to me. I hope that Adobe continues to change up the speaker lineups with future Adobe Days, as all the speakers I’ve heard have a clear voice that’s worth listening to, and hearing as many of those voices as possible provides both variety and fresh perspectives going forward. As I go through each presentation in forthcoming blog posts, hopefully you’ll see what I mean.

But as tradition in this blog dictates, I always start with the panel that capped off the Adobe Day event. I find that these panel talks bring an umbrella perspective to where we are as a profession through several points of view, and seeing where there are agreements and disagreements in the issues at hand.

This year, the panel was moderated by Matt Sullivan, who has been an Adobe Day speaker in the past. He did a great job, as this was the first time I’d seen him as the moderator of an Adobe Day panel. The panel consisted of Adobe Day speakers Marcia Riefer Johnston, Bernard Aschwanden, Kevin Siegel, and past Adobe Day speaker, Joe Welinske. The theme for the panel was looking ahead to the future of where tech comm seems to be going.

The Adobe Day Panel L to R: Matt Sullivan, Bernard Aschwanden, Joe Welinske, Marcia Riefer Johnston, and Kevin Siegel
The Adobe Day Panel
L to R: Matt Sullivan, Bernard Aschwanden, Joe Welinske, Marcia Riefer Johnston, and Kevin Siegel

Matt started with the point that tech comm is more than tech writing now, so what do we need to improve short-term and long-term? Kevin responded first, saying that we need to do more with less on smaller displays and adapting the content appropriately for mobile. Marcia added to that, saying that using less can mean writing tighter as well. (She has a technique she taught during the STC Summit, in fact!) Joe agreed with Marcia, adding that technical communicators need to put in the time to make concise content meaningful, and to look at simplified English as part of that objective. Bernard felt that attending workshops and demonstrations were important, because technical communicators need to continually learn and adapt in this industry! He added that SMEs (Subject Matter Experts) should contribute to content, but technical communicators should control it. Kevin also agreed with Bernard, saying that SMEs are writing content more often now, so teaching them to write tighter will help. Marcia chimed in that many people are now being required to write, but don’t have the skills. We need to help with that.

Moving onto topics about how technology affects technical communication, Kevin said that new technology, like Google Glass and other wearables, is emerging, and we need to understand how these work. Joe pointed out that the Pebble watch now is starting to have user docs now, and more will be emerging. Bernard added that gesture based technology similar to the Xbox Kinect will need documentation.

Matt then asked, “What should we look forward to in the next five years?” Bernard felt that less specialization will be needed so that the right people write the right content, such as an engineer who can write. Specialized writing will be very important. Joe added that we need to agree on taxonomy and terminology, and use style sheets more often for consistency. Marcia believed that topic-based writing will be emerging more as a growth area. Kevin explained that in e-learning, there is a need to develop learning for new devices that responds to user displays, thus accomodating multiple screens.

The next question asked about how to help educate and help with adapting certain generations adjust between print and digital writing/designing. The consenus was that we just need to adapt. The panel encouraged the audience to get to know your UX/UI people, as they will help you learn to adapt, especially if you aren’t as tech-adaptive.

The last question centered on customers customizing their content–is this a trend? Bernard leapt into a response with, “GOOD! DO IT!” He encouraged us to help customers to start doing personalized help, or personalizing any information, for that matter! Moderator Matt closed by saying that rich media that engages users is going to be about content strategy, but it will also be about content marketing. The group agreed that personalized, concise information going forward will be best!

"I guess you guys aren't ready for that yet--but your kids are going to love it!"
“I guess you guys aren’t ready for that yet–but your kids are going to love it!”

And that was it! The session went by quickly, but as you can see, there was a lot of great information that many technical communicators can take and use going forward in their own work.  While it might take some time to adapt, sure enough, it will bring the field forward as technology and the way we access it moves ahead.

Coming soon: The individual presentations at Adobe Day #STC14 Edition!

Posted in Uncategorized

Get your motor runnin’…Head out on the [mobile] highway…

Peter-Fonda-and-Dennis-Hopper-in-Easy-RiderWhen I first read the title of John Daigle’s Adobe Day presentation, “Enjoying a Smooth Ride on the Mobile Documentation Highway,” guitar riffs by Steppenwolf echoed in my mind thinking of the song, “Born to Be Wild” and scenes of Peter Fonda and Dennis Hopper riding down the information highway. OK, maybe not the information highway, but with mobile, it’s an open road right now that is waiting to be explored.

While I hadn’t heard John speak before, I was familiar with his “rock star” status due to social media–mostly through Twitter (you can find him as @hypertexas)–in my e-learning and m-learning forums.  It turns out that John is a big RoboHelp and Captivate expert, so being tied into the mobile highway scene makes sense!

JohnDaigle
John Daigle

The premise of John’s talk was that there are shifts and trends in mobile, and we need to look at organizations as early adopters, figure out the mobile landscape, and look at how user assistance is used on mobile as compared to how reference documentation is used generally. He pointed out that writing and designing for a mobile audience is very different from traditional methods (I agree!), and that he would be offering some hints on how to approach technical communications for mobile.

John pointed out that fellow speaker, panelist Joe Welinske, created the “bible” for Windows Help,  and now has created the “bible” for mobile apps, referring to Joe’s book, Developing User Assistance for Mobile Apps, which talks about the “screen wars” between the smartphones and tablets of various size. These various sizes produce a challenge for technical communicators. John went on to point out that e-readers, such as Kindle and Nook, are still alive and well and doing well as compared to other tablets such as iPads and Samsung Galaxy Tabs.  The initial conversion of print text to Kindle ePubs was a big change in electronic documentation. He also stated that at this stage of the game, Windows Surface and Windows Phone are a little late in the game, but they are catching up rapidly.

Following some of the comments of keynote speaker, Charles Corfield (the post on that talk is forthcoming!), John explained that other products including voice-activated devices, such as those found in some cars these days, are becoming more prolific. Google Glass, which is getting a lot of press right now, is a new game changer in mobile devices, and time will tell what kind of impact it will have.

John told us that as of February 2013, there were one billion smartphones and 150 million tablets worldwide–proof that mobile is becoming more widespread! Corporations are even getting more involved in mobile by buying mobile devices for employees, but many companies are also allowing BYOD (Bring Your Own Device). Companies are starting to embrace the idea of BYOD a little more lately.

Finance and healthcare industries are quickly adopting mobile delivery of information because of the portability of the devices. Mobile devices are being used more in industry and shop floors because they allow users access anytime, anywhere. John informed us that many of the same technical communications skills and experiences needed to write standard information apply to mobile. QR codes are gaining popularity as a  part of the movement of accessing documentation through mobile. John quoted Jakob Nielsen saying, “Killing time is the killer app of mobile.” With that in mind, John advised that technical communicators should learn to use more economic words for mobile, such as  “extra” instead of “additional.”

John also quoted John Caroll, who said, “Minimize the extent to which the systems and the information get in the way of what the user’s really interested in.” Progressive disclosure is key in writing for mobile. It allows one to gain information by revealing what’s needed when it’s needed. Ways to show this in mobile interfaces could be drop-down navigation or overlays. This allows a user to not leave the page, but he or she can still get to information quickly. In this sense, mobile can go right to the source or the heart of information needed.

So the question is, are huge documents (such as what’s in those big company binders) going mobile too? The answer is that technical writers can’t just dump desktop layouts and information onto mobile. This is where technical communicators need to work with developers to do what they do best–help “champion the end users.”

Going mobile is about flattening navigation–but not going button crazy, and getting back to context sensitive help. Technical communicators need to tap into social media to keep content current and accurate, thus becoming curators of user generated content.

It helps to prototype mobile layouts with rapid wire-framing tools, like Balsamic Mock-ups as a popular example. There are many specific tools on the market that are available to assist the developer in facilitate context-sensitive help.

However, there are several design controversies involving the need to upgrade browsers, progressive enhancement, adaptive design and responsive design. Some argue that responsive design is not the best because it makes a device’s CPU works harder, thus it becomes a virtual memory hog when resizing images as needed. Yet, responsive web design can adapt layouts to the appropriate viewing environment with fluid, proportion-based grids.

John suggested using the site, http://HTML5test.com , to help test how compatible your site is with mobile interfaces. He also pointed out that help-authoring tools can do much of the work with single source layout concepts, as different settings in authoring tools can help determine how to make user outputs work properly. Another such tool he recommended was Adobe Edge, as it helps writers to preview and inspect web designs on mobile devices directly ON the devices. For additional tools and information, John pointed us to his website, http://www.showmethedemo.com .

I particularly enjoyed John’s talk, as I’ve been following many of his posts on Twitter for more than a year now. He’s very good at explaining the power of mobile in technical communication, and I think John put this perspective well into view for the Adobe Day attendees.  As many know, I’m a big believer in the power of mobile, and the mind-set for writing for mobile isn’t that difficult if you understand the basics. So, it’s good that Adobe continues to include information about technical communications in the mobile world, as that’s where a lot of change is coming in the future. Adobe made a good choice when asking John Daigle to present information about mobile documentation.

John, if you are reading this, please feel free to add any comments or corrections in the comments! 🙂

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

Check out the affordable Tech Comm conference, ConveyUX !

WritersUAbanner_mainOne of the things that I hope I can do more often in 2013 is attend more tech comm conferences. There are always really good speakers, and I find that I truly learn so much from them.

So, when Joe Welinske of WritersUA emailed me and let me know about this conference, I had to share. Joe, you may remember, did a really great presentation at Adobe Day at Lavacon back in October.

Joe asked me to pass along the following information:

I’m writing this note to let you know that registration is open for the WritersUA conference….We will be in Seattle, March 7-8. This will directly follow the ConveyUX conference that I am managing for Blink Interactive.

You can find all the details here: http://writersua.com/conference.
Early registration discounts end on Saturday. I’m use a different format for the WritersUA event that offers a more affordable price and a reduced time commitment….Also, I’m hosting a number of free webinars for community groups. If you belong to a group that might be interested, let me know.

Thank you,
Joe

I looked at the website, and it IS one of the more affordable conferences, and I know several of the speakers presenting during the event, and they are all top notch! So, if you fancy a trip to Seattle in March for some great tech comm info, check it out!