Posted in Uncategorized

We can all be trainers–with support. 

 

“Ever hear of Plato, Aristotle, Socrates? MORONS!”

Scott Abel recently wrote an article titled, “Why Thought Leaders Aren’t Usually The Best Trainers,” in which he makes a valid point that not all thought leaders who push out books and PowerPoint slides are trainers or teachers. I get that. He backs up his thesis with some facts to support this. And yes, it wouldn’t hurt for those who are thought leaders who haven’t had to go out in the world to present their expertise to learn some fundamentals of teaching/training.

However, I feel Scott has done a disservice here. Sure, I admit I’ve seen some of the thought leaders he’s described, people who are incredibly brilliant and have a lot of great information to share, droning on with dull PowerPoint slides and who don’t know how to present it in a compelling way to actually feel like you learned something. It sounds like much of my entire higher ed education. I’m willing to bet that many of these thought leaders merely wanted to write a book to share knowledge, and didn’t think that they’d end up training people on their methods or data necessarily.

But with method that Scott used to frame his position, I feel like this article is a big slam against half the thought leaders in our industry, simply because they haven’t had those educational fundamentals instilled in them at times or the presentation skills he seeks. In doing this, his commentary implies, in my opinion, that those with the expertise shouldn’t even bother, because without these skills to be a trainer, you’re not worth the time or effort. “Learn to teach/train, or don’t waste my time.” That’s not quite right.

The thing to keep in mind is that understanding different learning styles, etc. takes TIME, as well as trial and error. It’s not something learned in a day, and most thought leaders aren’t going to go back to school to get an education degree. It’s not rocket science either. Budding educators are even given time–a learning curve of their own–to student teach before being sent out to teach. In the corporate world, there is no learning curve before being sent out in the world. You are thrown to the wolves and told, “Okay, you know this, you are an expert on XYZ. GO TRAIN.” This isn’t to say that there aren’t “train the trainer” programs or other resources out there that we can learn from, but I’m willing to bet that more experts are let loose to learn how to train others by trial and error, rather than be guided themselves. At least they go out there and try, which is more than I can say for others.

To understand my perspective, you have to understand that I am an educator’s daughter. My father did some form of teaching either on the high school or university level for over 40 years, and in his spare time, his idea of “fun” was reading books about learning styles and testing the theories on his kids. (Ask me sometime about family vacations at historic cemeteries instead of the beach. 😕) I also have learning disabilities, which provides a different perspective. I have trained others, including those with learning disabilities as well. There is no right or wrong way to teach if the information is learned. Just as there are different learning styles, there are different ways to teach. As long as comprehension is accomplished, then the task has been completed.

I have been a trainer, and still consider myself a trainer. I don’t know how good a trainer I am, but I know I’ve had my successes and failures in teaching people different concepts. I do know that there are many times I have to re-explain a concept to a learner in a different way so that they understand a concept.

In the end, I’ve realized that as a trainer, the process of learning is a two-way communication. As a trainer/teacher, you can present all the facts you want, but if no conversation ensues as a result, then the lesson has failed. At the end of every presentation, workshop, or one-on-on training I’ve ever done, I’ve always invited the students to not only ask questions, but to share their insights or experiences as well. My goal is that students come away with learning something new as well as validating their own knowledge, since I find that to be the best learning for me. It’s a good deal for me as a trainer because I learn how I can explain concepts better to students, as well as gain some new perspectives.

So rather than be a motivating article to spur thought leaders to improve their skills, I thought it was discouraging towards thought leaders. As a community, tech comm should be more pro-active in lifting those thought leaders who have the great ideas into being BETTER teachers. Writing their books is already an effort on their part to teach us, and many write excellent resources. Summoning up the courage to train people on these concepts can be hard enough. I have no disagreement with encouraging those who are going to share their ideas publicly to get some foundational training in how to train and learn how to assess comprehension. But build those budding trainers up, don’t tear them down. Tell them what they did right, but give them constructive criticism. I’m willing to bet that they will appreciate it, and get better over time.

The expression of “Those who can, do; those who can’t, teach,” ran through my head as I read Scott’s article and while writing this post. I always thought that this expression was rather insulting to the many teachers I know. In so many respects, teachers are more capable than those that “do”. But conversely, there are “do-ers” that can’t teach, just as there are teachers that can’t “do”.  Scott himself is a university instructor and trainer. Does that mean he can’t do what he lectures about? Of course not. He’s an expert in his field, plus he’s evidentially taken the time over years to learn the most effective ways to teach for his audience. Not everyone makes that same effort, or for that matter, is expected to do that. Thought leaders do need to learn some teaching fundamentals, but we shouldn’t diminish their contributions simply because they aren’t the best trainers.

As I said, as a community, let’s work on raising thought leaders to their fullest potential, which includes encouraging that two-way conversation related to learning, which will help them become better teachers and trainers. After all, Socrates, Plato, and Aristotle didn’t have written books or PowerPoint to share their ideas, and they were revered teachers because of discussions. Let’s work on that, instead.

(In the meantime, if you are inspired to improve your training skills, I’m sure there are plenty of resources out there that can help. I think my first stop would be searching through SlideShare to see if there are any pointers out there. I would also watch any video or listen to audio presentations done by those who I think are good trainers, and figure out why I respond to their methods. How was the information presented? What verbal tone did they use? Things like that. Emulate your favorite teachers, because they evidently did something right.)

Posted in Uncategorized

RoboHelp 2015 Release is a big step forward!

Adobe RoboHelp -- 2015 release
Adobe RoboHelp — 2015 release

The last few weeks–in fact, the last couple of months–have been so busy for me that I can’t always finish what I need to get done. One of the things on my long to-do list has been writing up a review of the new RoboHelp 2015 release. I shouldn’t have waited, because let me tell you–there are some great things happening with this updated product! Additionally, Adobe has already released an update, which I will include details from that as well in this review.

Back in May, Adobe held a preview press conference to let us know what’s new in Robohelp (2015 release). It was hosted by Maxwell Hoffmann, one of the Technical Communications Suite  (TCS) product evangelists for Adobe. I know Maxwell fairly well, as I first had a chance to work with him on the webinar I did for Adobe three years ago, and I know he knows and understands the TCS products very well, especially since he worked for some of these products before they were originally acquired by Adobe! He’s also a master storyteller and pays a lot of attention to what technical communicators have to say, so he’s excellent at explaining the benefits of features to users.

The first thing that Maxwell noted was that like the newest release of Framemaker, the naming convention for current and forthcoming releases from now on will be reflected in year instead of  version 12, 13, etc. This allows for some consistency, and it’ll be easier to know if you have the latest version based on the year it was released.

Going forward from that, Maxwell explained that RoboHelp (RH) now offers a new degree of usability to both help authors and their users. There are several new features going on in the 2015 release that I have to tell you, truly impressed me, and I think you will find to be great upgrades as well. The highlights of these new features include:

  • A brand new user interface
  • Best in class multi device publishing capabilities
  • Dynamic Content Filters that enable end users to quickly find relevant content
  • Single-click mobile app creation workflow
  • Miscellaneous productivity enhancements

Let me go into more detail about each of these highlights.

Brand New User Interface

Even though RH was already able to have its configuration customized by the user, many of the icons were rather small and hard to see–the interface had a lot going on in one screen.  Even so, one of the advantages of RH has always been that you didn’t have to work with code in RH.  The new interface, when demonstrated, was significantly cleaner and more concise. Not nearly as busy looking as its predecessor!  The interface has a much simpler look that resembles modern MS Office interfaces with the task ribbon, project manager window/frame, and the main designing frame.  The icons are larger and much clearer to figure out what they are. You also have a choice over the user interface being light or dark, and with or without color. It’s totally customizable to your preferences. Nice! Maxwell noted that it’s also helpful if you have two instances of RH running to keep different projects straight.

The commands are clustered in the tab ribbons.  As the different tab ribbons were demonstrated, I could see this was so much easier to decipher! There is also an icon in the first two tabs called “Pods” which can help you manage the pods you are working on.  The ribbons allow you to  see all the commands readily available to you in a consistent manner. All the tab ribbons seem consistent with MS Office-style ribbons, so new users should be able to adapt easily to these command choices.

The new Output tab ribbon, which contains one of the most frequently used clusters of tools,  replaces the single-source layout pod that was in previous versions of RH.  The Primary Output tool icon within the Output tab is customizable so that you can choose what outputs you want to use if you have a certain set of outputs that you standardly use. You can still do output of individual things as well, and the generation of output is faster now.  There is also a great “Primary Output View” which allow you to prototype and see what your output will look like before you actually publish.

The area circled in red shows the customizable Primary Output tool, which provides a one-touch customizable option to publish to your primary outputs.
The area circled in red shows the customizable Primary Output tool, which provides a one-touch customizable option to publish to your primary outputs.

There are several other interface features that are great enhancements. The Quick Access Toolbar used to display your favorite, most commonly used commands can be easily and quickly customized. The tabs will reformat with window resize, and the ribbon can also autohide.

Within the workspace, table creation is similar to MS Word. Tables can be created in color, and have greater flexibility. When creating a table, just like Word,  RH creates a specific tab for formatting and layout tables when needed. When creating content, commands that don’t make sense will gray out. Keyboard tips and shortcuts can be customized. The opening window is much more graphical and easier interface to use to start projects. When opening up a file, it will remember what documents you had open. Of course, if you are used to the old interface, this is an option as well.

With the update released in late August, the layouts have been optimized

Boy, Adobe has really gone all the way with making RH an easier, more user-friendly tool to use! If nothing else, this was the one improvement that in my eyes that impressed me the most, because I think this new, user-friendly layout is much less intimidating than the old one, which will help those who are new to the product or not as proficient on the product more willing to use it.

Best in Class Multi-Device Capabilities

RH now has new dynamic content filters that empower users by allowing them to find revelvant content faster. Adobe created brand new HTML5 layout enhancements which include:

  • The ability to easily show or hide widgets such as the Table of Contents (TOC), Glossary, Index, or Filter panes
  • Configure media query boundaries for different screens
  • Support native social media widgets
  • Flip to Right-to-Left (RTL) layout by changing language in single-source language
  • Show or hide branding band for mobile output

The HTML5 responsive layout has easy off/on icon control in layout, which is different from previous RH versions due to the clearer icons in the toolbar.  Search enhancements include:

  • The ability to have topic descriptions and control what that text is to make the description more meaningful.
  • Breadcrumbs are now also part of the descriptions.
  • Output search results are available in a collapsible left panel for easier navigation.
  • Native social media widget control allows Facebook and Twitter icons to appear on the output so that you can share the information. This is displayed as an arrow on the side that can pop out the content as needed, so it’s not in the way, yet still available.
  • Flip layout to right to left with language attribute for Arabic and Hebrew. This will also work with linked or imported RTL Framemaker documents.
  • Generate faster, better responsive HTML5 output. Faster loading times reduced by half, smaller sized output–2MB less for every 100 topics, and no flickering screen are the result.
  • You can maintain the Table of Contents state in the left column, and in fact, you can expand more than one section at a time within that section.
  • Cleaner HTML5 coding.

Some other bonuses are that custom fonts can be embedded when generating high fidelity ePub, and more skins have been added for output formatting to provide more flexibility and to accomodate for RTL projects.

Dynamic Filters and Faceted Navigation Improve The End-User Content Consumption Experience

The new HTML5 layout and contextual search results can let your end users quickly navigate to the relevant content through dynamic filters. Based on existing conditional tags/expressions functionality, users can use the tags/expressions OR/AND at the build time and display these tags/expressions for dynamic filtering by the end users.

Tags can be grouped and filters shown in a two-level hierarchy. All the content is dynamically filtered (TOC, Index, Topics, Search Results etc.). You can choose a display name for both tags and expressions, which works for merged projects as well. Tags can be shown in the output for better testing (Maxwell said that Adobe is most likely the only one doing that with its product), which is currently supported ONLY in responsive HTML5 output and mobile apps.

Enhancements include the ability to enable a single selection or multiple selections of the tags in final output, and enhanced CSH support through a dynamic content URL, so the filter choices are actually seen in the URL of the output, which is great. In the demonstration given, Maxwell showed how you can navitgate through filtered content so only certain things show for certain audiences, which I thought was a great use of this feature.

Content Centric Apps (developing mobile apps)

Robohelp can publish content as mobile apps for iOS and Android which can be read remotely or downloaded directly on your device. Adobe has made it super easy to create mobile app for your documentation by using a PhoneGap:Build/CS subscription to generate multiple apps for both Android and iOS.  (PhoneGap is considered an inexpensive subscription.) Mobile apps can easily be downloaded by scanning a generated QR code that can be shared, although a URL that can be shared, too.

Miscellaneous KEY enhancements
There are several extra enhancements that don’t fall under the other main categories, but are still equally important.

  • Users will be able to work more productively with a ribbon UI and enhanced search functionality, including bi-directional and multiline searches. The support for languages like Arabic and Hebrew, which was a major feature upgrade in FM 2015, is also included in this RH release. As of the new update released in late August, Farsi is also supported.
  • The “Find & Replace” functionality and searching abilities are significantly improved. Key enhancements include the ability to find results in Design Mode and open the files directly from search results.
  • Search scope has been extended, so you can also set the search scope to a current project, specific folders, the current window (including TOC/Index, etc. which is new), and all open files (also new), as well as do a multi-line search.
  • The standard keyboard shortcut of “Ctrl-F” now works to help do searches.
  • There are now separate tabs for find and replace. In the demonstration given, we were shown that you can find and replace within design mode instead of the HTML mod. There’s also the ability within the find/replace that if you have a long list of items, and you want to find where a specific item in located within that list, then you can go into the Project tab and click on “locate item”, and it will take you directly to the page in design mode. Really nice!
  • Search direction support–both forward and backwards– is available. You can also search within the source code as well through the line numbers listed in the search lists, which makes this feature very flexible.
  • Conditional text control has been improved with tagged output so that you can see what is conditional or not for QA purposes. Before, RH had slashed color tags that made it difficult to read and not always an exact match to what the conditional tag  was. Now, it has a more intuitive conditional build tag display that is much easier to read text while editing–the overline color exactly matches the tag. The overline is used as a conditional indicator with better readability than cross hatches, the color of the overline is exactly that of the tag, and easy to figure out the tag boundaries.
  • Support is now provided for named expressions.
  • Other enhancements enhancements at the time of the release included miscellaneous search enhancements, better scripting support, remember project state, and “find now” works in project manager frame.

Within the update release in late August, some additional enhancements were made in addition to those already mentioned above. Windows 10 support, online video derived from HTTP URLs can now be embedded in RH output, playback settings for multimedia are available, and more than a dozen bugs have been fixed. They’ve evidently been working hard at Adobe to add such features in a short time since the May release!

Pricing

Pricing & Availability on June 2 (in USD and AUS):

Product Full Price Upgrade from last release Upgrade from 2 releases Subscription Price Languages Supported
RoboHelp 2015 $999 RH 11: $399 RH 10: $599 $29.99/mo English, French, German, Japanese
Technical Communications Suite 2015 $1699 TCS5: $699 TCS 4, 3, 2 or 1: $1199 $49.99/mo English, French, German, Japanese

TCS 2015 Release includes RoboHelp, FrameMaker, Captivate, Acrobat, and Presenter–all at a price that is 57% less expensive that buying all products individually. It’s something to consider!

I think the thing that impresses me the most out of all the great new features truly is the new interface. Having a simpler, more user-friendly interface is going to bring more users–especially new users–towards this already powerful product. The continuing development on content design flexibility and inclusion of mobile output helps Adobe keep this product as one that will assist technical writers with creating more user-friendly help guides for customers.

Posted in Uncategorized

Three ways to look at the future: perspectives from a writer, reader, and marketer of content

My friend, Parth Mukherjee of Jifflenow, created an excellent SlideShare presentation that he shared at the STC India conference while still at Adobe, but shared recently on LinkedIn. While I didn’t attend the conference, he created a great conversation about the role of content in marketing that still applies now, and is highly relatable for technical communicators and digital marketers alike.

Take a look:

Posted in Uncategorized

Congratulations to the winner of the Information Development World All-Access Pass!

"May the odds be ever in your favor!" It looks like they were for Ed Marsh!
“May the odds be ever in your favor!”
It looks like they were for Ed Marsh!

Remember the little contest I ran recently to win a chance at a free All-Access Pass to Information Development World 2015? I didn’t forget! A random drawing (not by me, to make it fair) was done of the tweets submitted for the free all-access pass to Information Development World 2015 in San Jose, California.

Our winner is…Ed Marsh of ContentContent!

Ed was notified last week about winning the pass and the opportunity to attend.  When informed of his win, he had this to say about it:

Ed Marsh of Content Content Photo by Arclight Images Corporate Executive Portraits Commercial Photography NYC NJ New Jersey's premier Executive Portraits and Corporate Photography Studio serving Bergen, Passaic, and Morris counties in NJ and Rockland, Bronx & Orange counties NY.
Ed Marsh of ContentContent
Photo by Arclight Images

“All I had to do to win a free conference admission was send a tweet? I do that for free! I didn’t realize until recently how important conferences are to my career, so I’m excited to see different perspectives on content at Information Development World.

After narrowing down to three great choices, I finally decided to go with Lisa Welchman’s ‘Understanding digital governance’ [for my workshop day], because it’s probably the biggest issue we’re dealing with now.

I’m most looking forward to meeting new people, for sure. And I have to say that I plan to attend a variety of topics, not just one particular track, to get the most from my experience.

Having been on Ed’s ContentContent podcast, I know him well enough to know that even as an attendee, he will contribute a lot to conversations at the event.  I know he’s excited about going, and he’s going to have a blast.

If you are going, make sure to say hi to him and congratulations at the event! Congrats, again, Ed, for the win! The odds were ever in your favor, evidently!

There is still time to register to attend this great event–sign up now!

Posted in Uncategorized

Oh, the Academian and the Practitioner should be friends…Engaging TechComm Professionals

The farmer and the cowman--I mean, the academian and the practitioner should be friends...
The farmer and the cowman–I mean, the academian and the practitioner should be friends…

I attended the IEEE ProComm at the University of Limerick, in Limerick, Ireland last week. I was absolutely gobsmacked months ago when a presentation proposal I sent in for this conference was actually accepted. I figured, why not? I’m always looking to expand my tech comm circle, so I had hoped that this would help in this endeavour. I made some great new connections, and I was glad for that, and I certainly enjoyed the sessions I attended.

One thing that was very different about this conference, unlike the other tech comm conferences I’ve attended thusfar, was that this particular conference focused more on the academic side of tech comm. I found out, through inquiry, that while all were invited to this conference, there was definitely a very strong bent toward academia. There is nothing wrong with that, but the depth of this academic frame of mind is not something I’ve dealt with since I graduated from NJIT three years ago.  I understand that academia has its own rules and ways of doing things, but it was definitely…different. Not in a bad way, but different.

Up until this point, I had attended what I’ll call “practitioner” conferences. I’ve chose the word “practitioner” rather than “professional” because in the end, we’re all professionals at what we do in the technical communications, whether we teach and do research, or are out in the corporate world making things happen. Thus those out there in the corporate world I’m choosing to call practitioners. Some practitioners do teach, and some academians do corporate work, but they don’t always overlap. I wanted to clarify this before I move on with my narrative here…

Anyway, as I started to say, up until this point, I had attended conferences that had a stronger practitioner’s bent to them. Most speakers would be people who had been out there battling it out in the corporate masses, and sharing their experiences and knowledge attained from those experiences with others. I often attribute the fact that I got my last job with BASF because of information that learned through one of these practitioner events, because it was something that the company could use beyond analytical theories. Speakers at these practitioner conferences are those who are in the trenches every day, putting to practice all those theories about content strategy, revising them, applying them to businesses globally.

So, attending a mostly academic conference like the IEEE ProComm was a bit eye-opening. Many of the talks were summaries of research that had been done on a variety of topics, and peer reviewed, which was all well and good. I found that the sessions that I could connect best to were the ones that were given by practitioners, practitioners who were also academians, or academians who had a foothold as consultants outside of the academy. There were plenty of sessions whose topics were relevant to the corporate world, but they failed to deliver completely on something new or to provide any revelations to me. There were also summary sessions that provided research conclusions which were incorrect or inaccurate from practitioner perspectives, or elicited the feeling of “…and why are you researching this topic again, and what is its relevency?”

I spent a good part of my time networking with people who happened to be practitioners studying for advanced degrees or had an advanced degree. I particularly connected with one woman who happened to come out of the same NJIT program that I did. (We weren’t classmates, as she started the semester after I graduated, but we knew or had many of the same professors.) She’s been a practitioner much longer than I have, and as she had recently graduated from the NJIT program. NJIT people rarely attend these conferences, so if we do find each other, we tend to flock together a bit. She and I spent a lot of time comparing notes from our experiences and concerns that we had not only about our own program, but other programs as well.

The main gist of our conclusions was that this disparity between the academy and those in practice was discouraging. We both felt that while there were several technical communications programs that did help with job placement and practical experience while still in the studying process, not enough were. Additionally, some of the information that was being given to students about the realities of working in tech comm weren’t accurate or up to date. This is a disservice to both those who do research and especially to students who have to go out in the “real world”.  In order to not make it sound like I’m placing any blame on academia alone, practitioners also have a responsibility to be active in helping to groom future technical communicators as well. My NJIT colleague and I talked about we might be the first two members of an alumni advisory committee that we’d like to start (of course, NJIT doesn’t know this yet), because we felt that we could bring back our experiences either as instructors or merely as advisors to help professors and students keep up to speed with what’s happening outside the virtual or literal campus walls.

Now, in saying all this, I don’t mean to step on ANYONE’s toes in this discourse. Far from it! While I’m sure you can tell that I lean on the side of being a practitioner, this doesn’t mean that I don’t understand the academic side at all. I’ve been there. I’ve taught, too. However, there were just too many conversations in which I wanted to say to a few professors that only teach and do research, “REALLY?? Are you serious?”, knowing well that they were serious. I understand that many universities also have a hard rule about the need to do publish and research to keep one’s professorial job, so that can’t be easy to balance all of it.

Aunt Eller meant business when she had to "encourage" everyone to get along.
Aunt Eller meant business when she had to “encourage” everyone to get along.

When I first started meeting people at the ProComm conference, they assured me, as a first-time attendee, that this was a friendly group and it was easy to get to know others. This proved to be true. Just like the STC Summit and other conferences I have attended, the people were friendly, helpful, intelligent, and eager to “talk shop” with each other. I welcolmed that, and have found that these sentiments seem to be universal with all technical communicators. However, as time went by, that difference and angst between the academians and practitioners, while mild, was still palpable. The entire conference, I had a song running through my head from the American musical, “Oklahoma” called, “The Farmer and The Cowman (Territory Folk)”. (If you haven’t seen the musical before, you can watch the YouTube video of the song.) Essentially, the message of the song is that the two groups really had the same interests at hand in the end, and they needed to learn to cooperate more to make the goal of being the new state of Oklahoma work. I’m hoping that my role in this, on some level by opening up this conversation, is that I play the role of Aunt Eller from the same musical. She gives the advice at the end of this song by singing,

I’d teach you all a little sayin’
and learn the words by heart the way you should,
I don’t say that I’m no better than anybody else,
but I’ll be danged if I ain’t just as good!

😉

The Living Bridge at the University of Limerick.  Looks like a good place to start to "bridge" the gap.
The Living Bridge at the University of Limerick.
Looks like a good place to start.

While I don’t think our difference as as strong as the farmers or the cowmen of Oklahoma, I’d like to think that we can come together much more easily and bridge that chasm more quickly and completely. We all have the same goal, after all–to continue to make technical communications a top notch field and create superior technical communicators. How can we go wrong with a goal like that?

My own view is that more needs to be done to connect academia with practitioners. I know that the STC-PMC, for example, has been very active in the past year working with technical writing students at Drexel University in Philadelphia. They are always looking for more local schools to connect with. I’m sure there are other outreach programs out there, but how many exactly, whether it’s through STC or IEEE or any other professional group out there? I know that I’m going to try to reach out to my own program at NJIT in the next week and see if I can offer any help. What can you do?

What do you think? I know a lot of my readers fall on both sides of this issue, and several straddle both. I’d love to hear what you think, and let’s get the conversation started on this!