Technical communication – Page 39

A New Year–A New Adobe Technical Communication Suite – PREVIEW

Posted on January 14, 2014January 14, 2014 by TechCommGeekMom

TCS5-Ball-Drop — The Times Square New Year’s ball drop has landed…it’s a new Adobe Technical Communication Suite!

As of TODAY, Adobe is releasing five new tools for technical communication professionals everywhere! Technical Communication Suite 5.0 (TCS5), FrameMaker 12 (FM12), FrameMaker XML Author 12 (FMXA 12) and RoboHelp 11 (RH11), and FrameMaker Publishing Server 12 (FMPS12) are now available. It’s been about eighteen months or so since the last big Adobe tech comm release, so you can imagine there are some new and enhanced features included.

I was privileged to be among a group of tech comm professionals who were invited to get a preview of the products before their release, and I have to say, there were so many new and improved features that it was difficult to squeeze all the information into one press conference! But I’m going to give you the highlights, and I’m sure you’re going to find that there’s something new for you.

In the last release of TCS, namely TCS4, there were several big overhauls of the product, namely that the Technical Communications Suite concentrated on providing tools that supported structured authoring, integrated interactive content, and could support the creation of content for mobile devices while providing searchable, personalized, socially enabled content in a way that would yield bigger results with less resources. It was a major step to enhance these tools, especially in regards to adding mobile and interactive abilities to content. Adobe has continued to build on those major changes with the new features in version 5.0.

The foundation of the Tech Comm Suite has always been FrameMaker and RoboHelp. With the release of TCS5, FrameMaker 12 and RoboHelp 11 have been released with big enhancements that appear to concentrate on making these tools more user-friendly and efficient for the technical writers using them.

FM12_boxshot_2014 — Image courtesy of Adobe.

For FM12, the first obvious enhancement is the interface. Adobe has improved the user interface to include colored icons and larger icons that look cleaner and sharper in HD. If you like things “old school” in the original smaller, monochromatic colors, that choice is still available as well. There is also more flexibility in customizing your interface. A new “pod” allows the user to access all the currently opened files in one place, from which you can save and close multiple files at one time, while still viewing the unsaved files. There are also enhanced abilities to drag-and-drop to empty areas of the interface, close pods or panels more easily, double-click on empty areas to minimize or expand pods, and searching capabilities have been expanded. These seem like minor details, but when using a product as often as many technical writers use FrameMaker, these finer details can make a big difference! FM12 includes three samples of unstructured content and one DITA-based content sample with the product.

FM12 is not all about a new façade. Adobe has enriched the authoring process with new capabilities. The first thing that caught my attention is that FM12 can generate QR codes now! They can be created for URLs, SMS texts, emails, or to initiate phone calls. QR codes are taking over these days, so it’s great that these can be both created and integrated into FM documentation. Background color enhancements allow uniform height background color and options to specify paragraph boxes. The addition of a new customer-requested feature is the support regular expression coding.

Single-sourcing has been a hot topic in the last few years, and this has been addressed with new enhancements. FM12 gives users a new way to work with conditional text, by using a new conditional tag pod which provides check-box mechanisms with multiple conditions to allow the user to do more complex filtering with conditional text enhancements. It truly simplifies the entire process, that even a newbie should be able to figure it out easily.

Productivity enhancements have also been included in FM12. A searchable smart catalog function allows the user to filter choices based on the valid choices available and phrase typed by the user, while the user can continue to use the keyboard shortcuts as before. There is also a new capability to open all files from the user’s last session in one click, including the last documents and pages in focus, workspaces such as pods, panels and palettes, among others.

Adobe has also taken care to add great collaboration enhancements in FrameMaker. Native connections to any webdev content management system (CMS), such as Documentum, SharePoint, and Adobe CQ are available. Users can now view entire CMS tree layouts, and can access several key CMS functions, such as checking out documents, editing documents, and searching within document, all from FM12. PDF review commenting has been made more flexible. The most proactive steps towards subject matter expert (SME) reviews is that reviews can be done on PDF reader apps on mobile devices, and can also be used on those same devices using cloud technology such as Dropbox for both internal and external reviewers. As mobile devices become more commonplace replacing desktops and laptops, this is a great step forward!

Publishing abilities have gotten a boost on FrameMaker as well. It used to be that if you wanted to create certain types of digital output, such a ePUBs, for FrameMaker content, you would have to export it to RoboHelp, and have RoboHelp publish the document. Now, that step is no longer needed for PDFs, Webhelp, ePUBs, Kindle docs, Microsoft HTML Help, responsive HTML5, or Web help! That’s a big deal, as it allows FM12 to be more efficient by skipping that step of exporting and publishing in RoboHelp. Publishing can also be done through the Web now, too, for multiple users using a FrameMaker server, allowing multiple users to publish simultaneously and automatically to multiple channels and devices. That’s a practical efficiency improvement right there!

FMXA12_boxshot_2014 — Image courtesy of Adobe

With this release, Adobe is introducing a new FrameMaker product for those who don’t need the full version of FM12, but are mostly concerned in having a tool to do structured XML authoring. FrameMaker XML Author is a tool that has been created especially for the structured XML market. Those wanting to use unstructured content will still need to use the full FM12 version. The XML Author is fully standards-compliant for content creation, and supports the most popular XML technology for single-sourcing. It is not FM12 “lite”, but it is a streamlined, easy-to-use version that supports structured authoring without the bulk of the FM12 features that aren’t needed for structured content, yet still integrate-able with the full version of FM12 and available at a lower price. I’m sure that having this tool will be highly beneficial to many companies who are looking for a way to cut costs (it is priced at 40% the price of FM12 “full”) while still reaping the benefits of having a powerful XML authoring tool.

Another customer request that has been granted by Adobe is the integration of MathML, to allow MathML equations to be imported, created, edited, and published with FrameMaker. Adobe is even including 30-day trials of MathFlow (MathML editor from Design Science) with the shipment of FM12 for those who are interested in trying it out. There are several other features that are also included, along with 55 bug fixes, improved performance and launch time for FrameMaker, but I’d end up writing a book at this point!

Of course, with all these big changes to FrameMaker, we can’t forget RoboHelp 11, which also has had a big overhaul.

RH11, like FM12, has a new UI look as well. Based on customer feedback, RH11 has a new color scheme and a more modern interface that looks more pleasing to the eye. It’s a step in the right direction. Adobe has said that further UI improvements are in the works, but this current new UI is the first step in a long overdue makeover for the interface.

The more important feature enhancements with this new release of RoboHelp include advances with HTML5 publishing, printed document enhancements, and collaboration and single-sourcing enhancements.

The HTML5 publishing enhancements are from the perspective that mobile publishing is central, so new single responsive layouts for all devices are available “right out of the box” when downloading RH11. This new single layout feature will work seamlessly across all devices, can be easily customized, will allow for real-time previewing based on the browser size, and can be published with one click. There is a new wizard-based layout editor available to help with this process that shows the added responsive HTML5 output options. You can also preview layouts, and the customization is great because no coding in CSS needs to be done, as you can use the editor instead. To me, this is true single-sourcing creation at its best while simplifying the process! This is a big deal!

Printed documents have not been ignored. Users can now customize headers and footers of printed documents by defining them in the master pages. Headers and footers can also be imported from Word. There is also the ability to specify different headers and footers for the cover, and even and odd pages for different sections of a document. This is great for consistency within branded documentation.

In terms of collaboration and single-source improvements, cloud integration and topic sharing for SMEs has now been included. RH11 now includes a Resource Manager tool that synchronizes folders using Dropbox, Google Drive, or Microsoft SkyDrive as shared locations, and includes filtering for specific folders. This allows the user to manage linked resources within files used in real time across projects and geography.

The Technical Communication Suite 5.0 includes FrameMaker 12 and RoboHelp 11, but it also includes the updated products of Acrobat Pro XI, Captivate 7, and Presenter 9 to complete the Suite. You will notice that Illustrator, which was included in the TCS4 version, is not included. This was a step, Adobe said, to help lower the price. Additionally, from the way I see it, it makes sense, because both Illustrator and Photoshop–another product that used to be included in prior TCS versions–are now affordably available as part of the Adobe Creative Cloud subscription. I know that I personally have a CC subscription, and I’m guessing that many active technical communicators do too, so this saves us from spending twice for the same product, which makes a lot of sense. TCS5, FM12, RH11, FM XML Author, and the FMPS12 will also be available both as a subscription and through perpetual license as well. There is separate pricing for the FM XML Author and FM Publishing Server software.

The updates made to FrameMaker and RoboHelp are extensive, as there are many more features, but I think you get the idea. Adobe is taking steps to try to stay on top of technological changes that have taken root in the past couple of years, such as mobile and cloud technology, and is working to continue to make a more robust and user-friendly products for technical communicators.

My recommendation is that if you are looking to try TCS5 or any of the TC products out, or are interested in upgrading your current TCS package or individual products, click on the Adobe advertisement in the upper right corner of this page, or visit Adobe’s TCS product page for more information.

I hope you find this helpful!

Uncategorized

TechCommGeekMom’s TechComm Predictions for 2014

Posted on January 2, 2014 by TechCommGeekMom

sarahjane-crystalball — Sarah Jane Smith of Doctor Who is gazing into her crystal ball, trying to figure out why the 3rd Doctor and the Master aren’t going at it with more mobile tech.

Happy New Year! Welcome to 2014!

I had set several goals for 2013, and for the most part, I achieved many of them. Due to finally having a job this past year, I was able to pay for my new kitchen outright (okay, we saved on labor costs because my multi-talented husband installed everything–and I mean everything–except the Silestone countertops), so I have a new kitchen that I love. I definitely travelled more, as I visited Atlanta for the first time in 21 years due to the STC Summit, and I got to visit Portland, Oregon again for Lavacon. I didn’t get to go to the UK, however. And I still don’t look like a supermodel yet.

My 2014 goals are still fairly ambitious, I think. I would like to build upon my web publishing experiences at work, and figure out how to become a content engineer, rather than merely a content manager. I’m hoping that attending the Intelligent Content Conference in San Jose, CA this February and attending this year’s STC Summit in Phoenix, AZ will with help with that. I’m not sure if I’ll be able to make it to Lavacon again until later in the year. I still want to go to the UK, but I think I may have to wait a little longer for that. If there’s a way to combine a vacation and a conference there at the same time, perhaps I can pull it off later in the year instead of going to Lavacon (just to vary things up a bit). I had hoped to become a certified Muse expert last year, and that didn’t happen. Perhaps I can try this year. I also got the “WordPress for Dummies” book this year, which has inspired me to become more expert at using WordPress. I currently use the version hosted by WordPress itself, but I think it might be helpful to understand how the independently managed version works, too. If I can achieve some weight loss in the process during all of this, I will consider 2014 a success. 😉

As for predictions for 2014 in tech comm, I decided that I would be a little more analytical about it. Two years ago, it seemed that the push in tech comm was that we needed to think more carefully about content management reuse of content, and think in terms of mobile content. This past year, that was extended to translation and localization of content, taking it a step further. So with those concepts in mind, what’s the next step? In my mind, it’s implementation of all of these with more vigor. Some companies are on top of this, but it wouldn’t be surprising to me if many companies–even large, global companies–are not on top of any of this yet, or on top of it in an effective way. I think about companies that I’ve worked for in the past, and how, despite their size and availability of resources, these companies wouldn’t be cutting edge in distributing content for desktops or mobile, and regional sites were not as localized nor standardized as they should be. So, in my mind, this is the year of implementation.

Another thing to consider is technology changes. Over the past few years, we’ve been adapting not only to desktop or laptop interfaces, but we’ve also been adapting to more mobile devices like smartphones and tablets. Marta Rauch, a technical communicator friend of mine who is part of the Google Glass beta testing, pointed

out that 2014 is due to be a year in which even more portable, wearable mobile devices will become relevent. These devices would include something like Google Glass or similar products, but it also would include devices like Samsung’s wristband device or devices that are synchronized with car components. She’s got a point. Components are getting smaller, and technological portability is becoming more and more mainstream all the time. How do we decide what content is most user-friendly, reuseable, streamlined, and pertinent for these kinds of mobile devices? It’s something we need to start thinking about now.

riker-commbadge — “Riker to the Tech Comm community–are you there?”

So there you have it. At least in my mind, if we aren’t all wearing Comm Badges like in Star Trek by the end of the year, I don’t know what this world is coming to. 😉 But it’s hard for someone like me to figure out where the future is going. I’m grateful there are those who are on the cutting edge that can help me figure that sort of thing out, and can educate me on the latest and greatest so that I can bring it to my own workplace, as well as talk about it here on TechCommGeekMom.

I’m sure that there will be plenty of surprises coming up in 2014. As I said, I have three conferences that I’ll be attending in the first half of the year, and I know with the continuation of this great work contract I have, I will probably be learning a lot of new things through that opportunity, too. My philosophy is to never stop learning, and I plan to continue to learn a lot more going forward in the coming year.

What are you predictions for the coming year? Am I on target, or off-base? What did I forget to mention? Let me know in the comments.

Uncategorized

2013 in review, Part 2

Posted on December 31, 2013 by TechCommGeekMom

The WordPress.com stats helper monkeys prepared a 2013 annual report for this blog.

Here’s an excerpt:

The concert hall at the Sydney Opera House holds 2,700 people. This blog was viewed about 9,600 times in 2013. If it were a concert at Sydney Opera House, it would take about 4 sold-out performances for that many people to see it.

Click here to see the complete report.

Uncategorized

TechCommGeekMom’s 2013 Year in Review

Posted on December 29, 2013 by TechCommGeekMom

TechCommGeekMom visits Multnomah Falls during her Lavacon/Adobe Day 2013 visit to the Portland, OR area.

Okay, I’ll admit this is going to be a slightly self-indulgent (and slightly long) blog post. I read something recently that said that there shouldn’t be so much “self-promotion” in promoting your blog. This has always been a blog that not only encourages community, but it also tracks my own journey through technical communications, for better or worse. Taking the time to do the year-end review of what’s gone on in the past year is a good exercise for anyone.

At first, I thought my year wasn’t all that great, meaning that it wasn’t exciting. I hadn’t achieved some things that I wanted to do; I did not fulfill all my tech comm resolutions for the year. But as I looked through photos of the past year on my mobile devices to come up with something to put in this blog post, I realized that a LOT of good things still happened this year.

The year started off with a bang, as I was finally working full-time after a year of unemployment. The new job ended up being a good opportunity. I get to work from home, I’m being paid well (a lot better than I ever had before), and it’s doing something that comes naturally to me–content management. I have had the chance to use my UX and web design abilities during this position, too. Things have gone well enough that my contract has been extended for another year. I know that there’s a good chance that later in 2014, the company I’m contracted to will be switching CMS software, so it’ll be an opportunity to learn a new system and flex those content management muscles. I’m looking forward to it! It’s been a long time since I had a job that I truly enjoyed and feel appreciated for what I do. In past positions, I would offer my suggestions and advice based on what I had learned from my social media connections, graduate school courses, conferences, and personal experience, and I’d be ignored. I don’t mind if someone doesn’t take my suggestion if there’s something valid that will discount it, but using the excuse of “that’s the way we’ve always done it” or “that’s what the end user is used to, so why change it?” doesn’t cut it for me. There’s always a better way. This was the first position that actually gave me a chance to use my voice and makes some executive decisions that would benefit the end user. My manager supports my decisions 99% of the time, so that’s been a huge load off my shoulders. Stress has not been a major issue with this job, and I know I’m fortunate to have made this employment connection.

Having a job, and a good job at that, would make for a good year. But there’s been more.

2013 was the year that I started to go out on the public speaking circuit. It started with my first conference presentation at the STC-PMC Conference in March, followed by two webinars this past fall. Three presentations might not sound like a lot, but considering that I have only presented to my tech comm peers twice beforehand (my capstone presentation at grad school and an Adobe Webinar that Maxwell Hoffmann helped me with immensely in 2012), and all these presentations were STC-related, I figure that’s a pretty good feather to add to my cap. I’ve been told that the presentations were well-received, and I have gotten some good feedback, so I consider that a big success.

I also added an additional writing credential to my repetoire. I started writing a by-line for the STC Notebook blog that started out as a column as a newcomer for the 2013 STC Summit. That column has now turned into a regular monthly column for the STC Notebook called Villegas Views. Again, I feel like I’ve received some good feedback on my writing there, so that’s another success.

I attended three conferences this year, namely the STC-PMC Mid-Atlantic Technical Conference, the STC Summit, and Lavacon (although I was only at Lavacon for a day–hey, I still need to write about that! I’ll try to get to that soon!). The biggest one, of course, was the Summit, which was mindblowing for me. I loved being able to travel, considering I work from home day in and day out. (I’m not complaining, but it was a welcome change of scenery.) Actually, all the conferences were wonderful and overwhelming at the same time, and that sense of feeling somewhere that I belonged was never more evident than when I attended these events. I’m SO glad I did, and that leads me to the last thing that I found to be the greatest part of this year.

While I had started to develop some professional connections in 2012 through social media and through my first visit to Adobe Day at Lavacon in 2012, both social media and these conferences enabled me to expand my professional connections exponentially. However, it became more than just professional connections. I’ve ended up making some fantastic friends along the way. I know most people don’t think of me as being shy or introverted, but I actually am. I’m horribly awkward socially , and I know it. Social media helped with the introductions, for sure. A few in-person introductions have helped as well. I’ve said this before, and I’m sure I’ll say it many times again, but I have found that technical communicators to be one of the most friendly and inviting groups of people I’ve ever met. I have appreciated every person who introduced himself or herself to me in person when knowing me from my blog or a social media connection. I’ve appreciated the friendships that have developed over time from these connections. I’ve loved having some of these friendships with those who are industry leaders develop into mentorships as well. When one of those supportive mentors encourage me or tell me how proud they are of my accomplishments, I want to cry tears of joy. (Heck, I’m crying tears of joy just writing this!) For so long, I’ve felt like an outsider, so to have my professional peers look to me as an equal and show me constant support and encouragment is a huge boost that I’ve needed for years.

This blog has grown, too. The numbers aren’t done for the year yet as I write this, but I’ve added a lot more readers and had more response to TechCommGeekMom in 2013 than in 2012. I’m sure I’ll be doing more celebrating when the blog hits its second “birthday” in March, but for the calendar year, it’s been great. I know I haven’t always been able to keep up with this blog as much as I liked during this year, but I feel like the efforts that were made to grow and expand have been supported by the tech comm community.

So, thanks to all of you for reading my posts either here, on the STC Notebook, or in social media. Thank you for taking the time to talk to me and share ideas with me. Thanks for continually teaching me more about technical communication, and helping me to expand my mind and my understanding of this profession, and teaching me how I can continue to grow in this profession.

2014 is already shaping up to be an exciting year as well. I will be attending three conferences before the year is halfway done, of which I’ll be presenting at two of them, I believe. I know, for sure, that one of the conferences I’ll be presenting at is the STC Summit 2014! That’s a big deal to me. I mean, think about it–only out of grad school two years, and already presenting at the annual Summit? Not too shabby, I would think. I’ll be continuing to write here at TechCommGeekMom, and I’ll still be writing my by-line for STC Notebook, and I’m hoping that there will be some more opportunities to do presentations either in-person or in webinars.

2013 has been quite the year for me…time will tell how 2014 will be!

Uncategorized

Book Review: 8 Steps to Amazing Webinars by Sharon Burton

Posted on December 5, 2013 by TechCommGeekMom

In less than a week from this writing, I will be doing a new webinar that I was asked to do by one of the STC Special Interest Groups (SIGs). I was really honored to have been asked, and it’s about a topic that I think I know a little something about–blogging. After all, this little webspot has been going strong for about 21 months now.

But in putting this latest webinar together, I realized that while I felt that I could whip something decent together, it’s been a while since I had to craft a webinar presentation. This, in turn, reminded me that I had a promise to fulfull, as I sought out a reference in my personal library written by one of my tech comm knitting buddies. Pulling this reference out reminded me that I’ve been meaning to write this review since last spring, but had been side-tracked several times until now–when I really needed it most.

Sharon Burton’s book, 8 Steps to Amazing Webinars, is a slim volume of only 81 pages (and that’s the end of Appendix B), but it’s loaded with very concise information. 81 pages is all you need! Considering that this is a short and concise how-to book, it shouldn’t have taken me this long to write this! I truly try to read any books that I’m asked to review cover to cover, and this was a quick but highly informative read!

There are several things I like about Sharon’s book. It’s short and to the point, as already mentioned. For busy presenters who have many things to do other than solely doing webinars, this is great resource because she gets straight to the heart of what needs to be done. Additionally, one of the things that I’ve found that Sharon and I have in common with our tech comm perspective is that our views are highly customer service-oriented. Before my life in an IT/tech comm world, I came from a customer service/client services background, so much of her advice on the how and why webinars can be great marketing tools geared towards customers made a lot of sense to me.

Sharon’s eight steps take the reader from the point of understanding what a webinar is, through every step of the process of creating and following-up with the webinar, including choosing presenters, topics, technology needed, advertisting the webinar, and all the other preparation steps to creating the webinar. She even includes pointers on how to set up the presentation slides that are most likely going to be used in the presentation.

As I read the book, I was quickly reminded of the first webinar that I did back in 2012 for Adobe’s Technical Communications group (you can find the link on the right-hand column of this blog). I remember not knowing the first thing about how to put together a webinar. At the time, Maxwell Hoffman, who is one of the evangelists for Adobe TCS, guided and coached me through the process, and it ended up being a great success. Looking back, I would not be surprised if Maxwell was already well-versed in the steps that Sharon outlines in her book, because I’m fairly sure that we followed every single step. When I also look back to the first in-person presentation I did, which lead to a recent webinar on the same topic, I realized that I had followed much of the same steps again, and got a great response as a result. These steps are practically foolproof, so I can assure you that if you follow Sharon’s advice in the book–and much of it is really common sense, you should have success in presenting a webinar.

Sharon’s viewpoint in this book is from a marketing perspective, in that webinars are used to drive people to a brand, increase leads, and provide resources to your customers. And for 99.9% of time, this is a main focus for most people who would read this book. But even for people who are academics, for example, who are not necessarily trying to create a brand, but rather disseminate valuable information, this book is still helpful because it put the reader in the right mind-set to create a virtual presentation that is meaningful for his or her audience. For example, while I am promoting my “brand” of TechCommGeekMom, I’m not really selling a product or service the same way that a software company or communications service consultancy would be. (At least I’m not at that stage yet!) Even so, I know that when I present the webinars that I’ve done, there is some sort of value based on the type of information that I’m providing. By referring back to 8 Steps to Amazing Webinars as I prepared for this upcoming webinar, I knew that I was on the right track to maximize the information that I will be delivering. It also made me reflect, based on these steps, what made for a bad webinar, and I’m sad to say that I’ve attended a few of those in my time. I think I even remember one that Sharon and I attended at the same time, and I remember us talking about how disappointed we were with that one webinar, and we had the same sticking points about it.

I highly endorse this book for its strong content and its easy-to-read, straightforward language. Anyone who is doing a webinar–or even an in-person presentation–can gain some great pointers and advice following Sharon’s advice. Hey, it’s such good advice that the book is endorsed by the STC itself, and I know that many of their best webinars follow Sharon’s methods. So that says something right there!

You can find the book on Amazon.com, Barnes & Noble, and XML Press websites. And be sure to follow Sharon on Twitter too– she’s @sharonburton, or on her blog found at sharonburton.com. She always has good information to pass along that goes beyond just how to do webinars!