Posted in Uncategorized

Good writing always gets you ahead.

Captain Picard has a lot of editing to do with ipads around him everywhere.
Even Picard knows that if you don’t have good writing and editing, things fall behind when you have a lot of editing to do.

I’ve been job searching again, as my last contract ended about a month ago. I’ve had some ups and downs in the last month, to say the least, but finding the next gig is always a priority (even though I said I was going to take the summer off). I’m still doing a few hours here and there of freelancing, but it’s not paying the bills, so the search goes on.

But as I’m working on coming up with a curriculum for the technical editing course I’m slated to teach at NJIT this fall, and following a phone interview with a recruiter for another job, it occurs to me that good writing and editing has always been a mainstay in my career, even before I got involved in technical communications.

The first job I had that involved writing was as a consumer affairs representative for the company that makes Arm & Hammer products. Part of the job was not only taking notes about the consumer calls, but also answering written inquiries. Now remember, this is in the days before the web, so phone calls and letters were all we had, but they kept us busy! My department had several form letters that we could use for the most common correspondence we’d get, but now and then, we’d have to customize one of those form letters, or write a totally new letter. I was often told, as a kid fresh out of college, that I was a good writer, and my letters usually didn’t need as many tweaks as the others in my group.

Fast forward to the job that launched me into looking at technical communications. I was working as an application specialist at a huge philanthropy/non-profit. My department used instructional design techniques and technical editing to review grant application processes, and help those writing the grant applications and review processes to turn those paper processes into digital processes. I’d have to check for grammar, sentence structure, make sure that instructions were clear to elicit the responses that were expected from those using the content management system. I didn’t know the terms “instructional design” or “technical editing” or “content management” at the time, but figured them out later when I got laid off from that position, and decided to go back to school to do…something. I was often praised by my manager that I understood grammar and knew how to make the correct edits better than my predecessor, and we bonded over Oxford commas.

And to think, I wasn’t even an English major! But I always liked learning languages and I always did well with grammar lessons, so it seemed natural to me.

Fast forward again to now. Many of the jobs that I’ve applied to in the past few years or so have involved my ability to write and edit. Some of those jobs were earned, and I had to show that I could write and edit, and I did successfully. I had done very well in graduate school in my technical editing class, and now I’m working on revamping the curriculum for the same class which I’m about to teach this fall.

These days, it seems like good writing and editing is going by the wayside. Digital writers depend too much on spell checker and grammar checker to be caught by their word processing or editing software, when that’s only a tool to help catch the obvious mistakes. I don’t know how many times I’ve checked and double-checked a document and found mistakes that spell checker did not find. Those tools on common software can’t find sentence structure phrases that would be unfamiliar to a machine doing translation to find turns of phrase that aren’t found in other languages.

As I continue my search for the next big thing I’ll be doing, I’m realizing that my attention to grammar and language has been a boon for my career, and if I didn’t have that, I wouldn’t be where I am today. It’s something that’s so simple and starts at a very young age while still in elementary school. For those who make arguments about evolving language and grammar, and advocate that emoji are part of written language, I disagree. Straightforward language, but written and spoken, has always helped me in my career, and I suspect that it will continue to help me going forward. Technical writing and technical communication beseeches that we use a solid foundation of good language skills, as it is a requirement for those in the field to do our job properly.

If you usually don’t do much authoring or editing, it would be worth taking a refresher course. I think the STC sometimes provides great ones online. In these days of digital writing when no one is properly checking content, it’s worth the time and effort to make sure that you have the skills to do what software or a machine sometimes can’t do.

What do you think? Include your comments below.

Posted in Uncategorized

9 Recommended Tech Tools for a Conference Attendee

tech organizer for accessoriesI don’t attend as many conferences as some people, for sure. There are those I know who whisk off to different parts of the world to attend such conferences–I’m not quite one of those.  I’m usually going to at least 1-2 local conferences, and 1-2 not local conferences a year on average.  This year, at this writing, I’m only planning on one big conference, and namely that’s the STC Summit in a couple of days.

While I’m on these trips, I usually try to put some careful consideration into what I’m bringing with me. This year, I have my car (an SUV, no less) with me, so I can load up the car as much as I want.  But in other years, like many, I usually have to get on a plane to get to the conference destination, so taking as few things–and lighter items–is necessary.

Liz Fraley wrote an excellent article about a year ago about her Presenter’s Tech Travel Kit, and it’s pretty comprehensive.  I have most of the same items as she does. Some I don’t travel with, and some are items I still desire to add to my travel tech.

But that was written from the perspective of a frequent presenter. What about some recommendations for those who aren’t presenters, but still want to bring some basic tech with them?

I’m looking at this perspective myself, as I’m not a presenter this year. I usually have one big suitcase for clothes, shoes, things I picked up at the conference, but I also need to bring tech, since I am either taking notes, or sharing my experiences on social media during a conference. I’m still developing what works for me best, but there are a few things that I usually bring with me no matter where I go, whether I’m a presenter or attendee. There are also a few (hopefully) clever solutions to help lighten my load, but maintain some good tech.

  1. My iPad/tablet
    My iPad comes with me everywhere. I have a large, 17 inch laptop, and while it’s one of the “lighter” ones, it’s still rather heavy, and it’s a pain (literally and figuratively) to carry places.  In most instances, I don’t need to bring a full laptop computer with me, as I’m only accessing  my word processing programs (Notes or Word) for note taking, I have full access to social media apps, I can still get my email, I still have Skype–I have most of what I need to record what I need and still communicate with the outside world in my iPad.  My iPad is thin, and it’s lightweight. It’s as good as having a paper notebook in size and weight, but better.

    Someday, I hope to be able to afford one of those super sleek, thin, streamlined ultrabooks that I can bring anywhere, but in the meantime, this will do nicely. If you don’t have an iPad, an Android or Fire or other equivalent will probably do just as nicely.

  2. My Wireless Keyboard
    This is an optional one, only because I don’t have an iPad cover that is also a Bluetooth keyboard. But having my wireless Apple keyboard–or for that matter, any Bluetooth keyboard–is great because then you feel like you do have a very compact laptop with you. I keep it in a special case (similar to this one–same manufacturer, older model) that has some extra storage. (Waterfield has some nice travel bags as well.)

    But what if you have to access a “power” program due to a workshop, and there isn’t an app for that? Well, I’ve figured that out too, but it’s on a case-by-case basis (meaning there are some exceptions when I, unfortunately, do have to lug my laptop with me). I hate bringing my laptop just for one workshop or one session, when I know I’m not going to use it for the rest of the conference.  I have a solution that might work for you, and it’s worked for me.

  3. Remote Machine apps
    Yes, if you pick the right one and play with it a little bit first, there are some decent remote machine apps that will connect your tablet (in my case, my iPad) to your laptop at home. You just have to install the app on your iPad, make sure the app is installed on your laptop at home, and remember to leave your laptop on at home before you leave! I’ve played with a few.

    TeamViewer is a popular one. My husband likes that one. It’s free for individual use. There’s also Splashtop. That one, if you are travelling, is about $3/month, but it provides a good connection. I used that last year, and it’s another popular one.

    This year, I’ve switched over to a free one that’s available, and I like this one the best. It’s called VNC Viewer. There’s an app for it on iTunes, and it’ll give you directions on how to make your laptop the “VNC Server”. The beauty of this one is that it’s mostly maintained on the cloud! And it’s free for individuals! I also liked the screen resolution on this one, because it showed what’s on my laptop screen better than the others, and I could get the tapping tasks down easier than the others.  I could access those “power” apps (like various XML editors) from my home laptop from my iPad, and still do the same actions as if I were using my laptop. There might be a few tricks to use it on an iPad, but the work itself is being done on my home laptop. Cool!

  4. Skyroam Personal Hotspot device
    This is a new item that I’ve added to my collection. It’s a personal hotspot that doesn’t work off your phone, and it works internationally in most major countries.  You buy unlimited connectivity passes which last the full 24 hours.  If you buy your passes in bulk, they come out to be about $8 per day, and you can connect up to 5 devices at a time. The device is usually around $100, and comes with 3 free day passes to start. You can also rent them at airports and–I think–through the website at skyroam.com.

    Why would I need that? I bought it for a few reasons. First, during my last international trip, I found I was using the data that I had bought through my phone contract wasn’t enough for when I was out and about. It was a lot of data just trying to pull up a map and figure out where I was going! And wifi wasn’t always perfect trying to glean it off of stores or other public places. This way, in the future, I’d have this small device with me, and not have that problem anymore. Second, when we travel, my son is ALWAYS using up a lot of data so he can play games on his phone. This, again, eliminates the huge cost. The last reason I got it was that even though certain conferences offer wifi services, sometimes, well, they just aren’t great wifi connections.

    Since I do a lot of Twitter feeds and such during conferences, it’s important that I have a solid wi-fi connection. This solves this problem. I used my Skyroam at the CONDUIT conference last month, and it works GREAT.

  5. My Smart Travel Router and International Power Converters
    This one is especially helpful if you are travelling internationally, but I still bring them with me on domestic trips as well.  They not only provide international outlet adapters for other countries, but they usually have 2 USB outlets on them to charge my devices. I use these heavily– I have 3 of these, so I can charge up to 6 devices at a time if needed! One of these three is my smart travel router. The one I own is a Satechi Smart Travel Router, which you can find on various websites to order. If you have access to a network cable, this little device is marvelous. It’s not only a outlet adapter that has USB outlets on it, but it also acts as a mini wifi router when connected to a wired network.

    I’ll give you an example when it came in handy. When I went to IEEE ProComm, I stayed at one of the dorms at the University of Limerick. They had no wifi available in the rooms. HOWEVER, they did have network outlets. All I did was connect my networking cable to that outlet, plugged the other side into this Smart Router, and VOILA! I was the only one who had wifi! I was able to talk to my family on Skype at night and check on other things that required internet connectivity.

  6. Battery packs/Power banks

    Portable batteries/power banks come in all sizes. I actually bring three– two small ones and a big one. Why? I don’t want to be lugging a charging cord and power adapter for my iPad or my phone and trying to be near the nearest outlet.  These batteries can easily charge overnight, so I will charge the big one (which has two outlets for two devices) one night while I use the smaller two, and then switch off the next day.You can find smaller ones under US$10, and some of the larger, more powerful ones can get to cost as much as $70. Pick what’s whatever in your budget, and you’ll find it’s handy to have just in case. My two little ones were gifts, whereas my bigger one is one I bought for about US$25-30.  You can get fairly powerful ones these days, and find them almost anywhere that they sell phone and tablet accessories.
  7. Cables/Power Cords
    This is an obvious one. You can’t charge any of these devices up with a plug, battery, car power adapter, or wall power adapter unless you have all the right cables and cords! I always ensure that I have one for each device (for me, that’d be 2 Apple lightning cords), and at least 1-2 USB-C cords that will charge the battery packs. Sometimes you can get a power cord that powers multiple devices–a multi-port cord. I have one of those that one of the vendors gave out at a past conference that works beautifully, even with my fickle i-Devices. I keep them all together in a Skooba Design cable wrap case so I can find them easily, and it’s compact. (Skooba Design also has some nice travel bags as well.)
  8. Earphones of some sort
    I tend to bring a few things redundantly, so I do bring my regular Apple earphones with me, but I also bring my fancy Bose Noise Cancelling Headphones with me as well. The second ones are for the noise cancelling feature. Sometimes I just need to tune out, you know? (Introverts, take note!)
  9. Extra batteries
    If my Apple keyboard or the noise cancelling feature of my Bose headphones die, then I have at least one set of backup batteries (2-AAs, 1-AAA) with me. I keep them in the small case I keep my keyboard in.

That seems to cover the basics of what I find I need as a conference attendee. I don’t run out of power. I have something to take notes electronically or connect to the outside world. I have devices to help me connect to the Internet. I’m pretty much set, and it can all easily fit in my messenger bag or backpack, and still have room in my bag to collect some goodies from the Exhibition Hall.

As a presenter, I think the only other things I would bring would be some sort of an A/V adapter (see Liz’s article for suggestions–I just hook up my iPad with my adapter, and I’m good), or as is often suggested, I bring a thumb/flash drive with my presentation on it–just in case.

Between my list and Liz’s list, can you think of other devices, tools, or other tech accessories that you find that you absolutely need to bring with you to a conference? Include your comments below.

Posted in Uncategorized

Adobe Tech Comm Suite 2017 is better than ever!

technical_communication_suite_2017Recently, Adobe held a virtual press conference for the 2017 Release of the Adobe Technical Communications Suite, which launched on 31 January 2017. While the Suite continues to include the latest versions of Captivate, Acrobat, and Presenter, it’s RoboHelp (RH), the XML documentation add-on for Adobe Experience Manager (AEM), and its flagship product in the suite, FrameMaker (FM) and its related FrameMaker Server that have all received updates with this newest release.

FrameMaker itself has been around for thirty years now, but it’s been especially in the last few years that significant changes has been made to accommodate DITA support,  multi-channel and mobile publishing, and support from right-to-left (RTL) languages.

With the 2017 Release, Adobe’s main objective was to provide new features while simplifying current features that would help with productivity and keep the end users in mind.

I found that now that I have a better understanding of the structured authoring views from my recent DITA course, I could see these products with a fresher perspective while I attended this virtual press conference, and better appreciate the upgrades.

The main attraction for the virtual press conference was FrameMaker, as the product has had some major overhauls, including new features centered around the authoring experience.  I won’t go into all of the features, as there’s too much to review, but several of them made a big impression on me. FM has been a complicated tool to use for many years, but it seems to me that with each new release, the tool becomes more user-friendly for those who aren’t as deeply entrenched with all the bells and whistles. The new interface is more modern and usable, and there’s easier access to recent items through the Browse Computer or repository feature.  This gives you access to all resources like tutorials, guides, and online help. It also allows you to access structured and unstructured items in one page. Even within the Search function, there is better auto-complete functionality which shows predictive results based on user typing through responsive HTML5 output.

An important upgrade in this 2017 release is that menus have been optimized and reorganized, with more commands to improve discover-ability.  My favorite new feature within these new menu changes is that the “Special” menu is gone, and the much more logical “Insert” menu has been added. This is something that has sorely been needed for a long time to be more user-friendly interface! Why, just today I was in a different Adobe tool, and I looked to insert an image, and that particular app (a Creative Cloud app) didn’t have an “Insert” menu at all! Insert menus are commonly used in apps almost universally now, that this was a long time coming. It makes inserting objects more intuitive for an app that’s not always that intuitive. It’s one of those “DUH!” things that I’m glad Adobe has fixed for FrameMaker. The Insert menu provides one stop for inserting images, files, variables, elements, equations…you name it! For example, all that needs to be done to insert an image into a document is to go to Insert-> Image and it’s done! You don’t need DPI settings change, as the DPI settings are retained, but they can be changed. You can also do a “drag and drop” of an image into a document easily. All you do is add to your project, then drag the image into the page, and it adapts to the page. You can still adjust the size in object properties if needed. The object properties dialog is improved, as there is an option to maintain aspect ration, DPI can be set inline, and apply a check inline. The “Element” menu is also enhanced. New options have been added to insert, wrap, and change. The Insert drop down is great! It has everything you need, and will likely be heavily used.

Shortcuts for productivity got a boost, as there is a new Command Search feature that is accessed through the <F7> button and very easy to use. All shortcuts are also now listed next to menu commands so that power users can learn them more easily. <CTRL-1> provides a list of where you are within the structure of your structured authoring, which is rather convenient.  Commands that are applicable globally,  such as borders, text symbols, rulers, grid lines, and hotspot indicators that impact all open docs both structured and unstructured are viewable now, although there are some limitations with structured views.

PODS have also has some upgrades as well. A new paragraph designer table allows you to create new styles easily in the pod. Styling icons in table and paragraph designers have been replaced with labeled buttons, configurable options have been reorganized and relabeled, and redundant command operations have been removed. Additionally, adding or editing a conditional tag now happens thru a dialog. The former “Select” drop down list has been replaced by Filter icon. Color and background columns have been removed. Conditional takes are listed with their close to final formatting, with tooltips displayed for conditional tags listed in the pod.  Several catalog PODS are also redesigned, with old buttons replaced with icons. Deletion has been made intuitive by removing extra options.

These changes have allowed the project management of a given project much easier, as now it’s easier to organize content such as a DITA map, book, topic, image, TOC, or index files related to a project in a single place whereby you can drag and drop files from Windows Explorer.

Structured Authoring gets some boosts as well. The Status bar now provides information about the exact path of the current element in your structured document. You can show or hide content from the structure view for a cleaner view as you work. Some of the new Insert menu options have been added for structured authoring, such as the Insert>Cross-Reference function, which should be very handy. There is also an improved DITA Keyspace Manager, whereby  if any DITA map is opened,  it gets populated automatically in drop down. The ability to search for a keyspace by entering the 1st few characters.

To keep up with the rapid changes in technology, high resolutions displays are supported now! Support for 4K resolution is now available, and allows the application to scale automatically. No separate setting is required to adjust resolution, so icons are now more sharp and size will scale automatically with the screen resolution.

Publishing features have not been forgotten, as they include brand new responsive HTML5 layouts that are modern, frameless layouts with a redefined browsing experience, are fully customizable, and can easily match the look and feel of your corporate website template. The navigation is search driven, and you also have the ability to add favorites while still being fully accessible (508 compliant).

New publishing features include the introduction of basic HTML5 formatting without any JavaScript or layout, with the look and feel controlled by CSS. This makes publishing lightweight and easy to share.  Text searches within searchable vector graphics (SVG) can now be done, and supported in HTML5, as the information in the SVG files can be read and displayed as part of search results. Multimedia files are managed in assets folder in published output. Inline styles have been cleaned up, including the introduction of a setting for Excel inline styles from published output. You can publish topics to a single folder–an important organization feature. Content personalization has been improved with DITA attribute support in dynamic content filters in the indexes, and a new dialog has been introduced to select conditional attributes.

Wow, that’s a lot right there!

All these changes are great for the FrameMaker app, but what about the FrameMaker Publishing Server? No worries! The 2017 release of the FrameMaker manage remote publishing, and can publish bi-directional content across formats and devices, so it can integrate with any CMS.

RoboHelp has brand-new, responsive HTML5 layouts as well, also incorporating modern, frame-less layouts with a redefined browsing experience that’s fully customizable. The Search autocomplete is also functional here in RoboHelp as well, allowing for search in responsive HTML5 output that shows predictive results based on user typing by segment first–which is a unique feature, gives contextual results, can indicate the number of occurrences of an entered word or phrase which helps in narrowing down the matching results, and can even correct spelling mistakes as you type in the search. The new authoring features include thumbnail support for images, folder imports for baggage files, and variable view toggling.

The Adobe Technical Communications Suite 2017 Release (TCS 2017) includes these latest versions of FrameMaker and RoboHelp, as well as the latest versions of Acrobat Pro, Captivate, and Presenter, which went bought together in the Suite, provide a 58% savings over buying the tools separately.

While not formally part of the Technical Communications Suite, it’s also important to mention that the Adobe Experience Manager (AEM) XML Documentation Add-On 2.0 version has been released.  If you are using AEM as your CMS or CCMS, you can host your tech and marketing content that’s written up in FrameMaker more easily through the integration of this add-on.  This add-on allows for content sharing and reuse which lends itself to consistent user experience and reduced total cost of ownership. Higher content velocity helps to drive enterprise publishing features, such as batch publishing, baseline publishing, and post-publishing workflows. Enhanced review and collaboration capabilities include web-based inline review, web editor enhancements that help with content management capabilities and document life-cycle management.

If you want more information about TCS 2017, you can click on the Adobe advertisement in the right column, or email the Adobe TCS team directly at techcomm@adobe.com.

Additionally, there is a 2017 Release Launch Webinar on 15 February 2017. It’s free! Learn more and register for the event on the Adobe Event website.

 

Posted in Uncategorized

Confessions of a Failed Technical Communicator

homer_confession
Really, Father, my only sins are beer, donuts, beer, donuts, not knowing DITA, beer, donuts…

“Bless me, Father, for I have sinned! I am a failure in technical communications.”

OK, perhaps in many eyes, I haven’t been a failure in technical communications. It will be five years this spring since I graduated with my Masters degree in Professional and Technical Communication from NJIT. In many ways, that feels like it was just yesterday, and I’m still a “new graduate”. But with the change this year in my STC Membership that’s moved from “Student” to “New Professional” to “Classic”, I supposed I’m not anymore.

While graduate school gave me a good foundation to move forward, I learned very quickly that I needed to continue to educate myself. As I attended conferences and presentations, and paid attention to discussions in social media, I found out that graduate school lessons barely cut the surface. I’ve tried my best to continue my studies by attending as many webinars, conferences, and presentations that I can. I even took another university graduate certificate course on digital marketing, hoping to get some insight that might help me going forward.

However, in the end, I failed to do one thing that might actually boost what I’m doing as a fledgling content strategist, and thus, my confession: I needed to learn DITA.

For those of you who don’t know what DITA is, it’s the acronym for Darwin Information Typing Architecture, and it’s a commonly used method for creating structured authoring using XML coding. The idea is that documentation done using DITA methods will allow for single-sourcing for content elements, and equally make it easier to integrate that content into print or digital outputs in a super-organized, modular way. It’s a standard that helps because it’s generic to almost any system out there. Any system that can read XML can read a DITA document, for the most part. When moving from one system to another, the content can stay intact if done using DITA/XML methods.

I don’t remember learning much about DITA in grad school, other than understanding what it was in general as I explained it above. I never learned the details. In my work life so far, I haven’t needed it.  It’s always been unstructured authoring. I try to take some small steps to create some single-sourcing content when possible in content management systems, but that was hard to do sometimes. One of my recent jobs made me realize that we needed some sort of structured authoring done, but I didn’t know how to go about it. We created our own coding tags to describe things going on in copy decks. It wasn’t the best, but it was better than nothing.

In the past year, I’ve tried to figure out ways to continue to improve my skills, and make myself more marketable as a content strategist/content manager. I talked to the leading experts in the field. (It’s one of the benefits of getting involved with the STC and attending STC events–you get to know these people personally.) And the one thing that seemed to come back to me again and again was that I had a good resume, and I have some great skills under my belt, and they knew that I was a good writer from this blog. The biggest sore spot in my skill set was that I lacked an important skill–knowing DITA and using it.  And while I looked for jobs in my area that included DITA practices (I think I’ve only seen one listing in three years), I’ve been assured that if I could learn DITA, the remote/telecommuting possibilities could be much better for me. And since remote opportunities are my best bet right now, I have to do what I need to do to make that happen.

So, as the saying goes, I bit the bullet. Fortunately, the STC was promoting a course about DITA Essentials taught by Bernard Aschwanden, the Immediate Past-President of the STC, and the proprietor of Publishing Smarter. Bernard’s a great instructor, and he’s taking it nice and slow. One of the best parts of the course is hands-on experience, even if it’s in the simplest ways. That’s the way I tend to learn best–learn the logistics of how something is done, then I need to learn to do the work through trial and error.  Last week’s assignment was particularly challenging for me. While I understood what I had to do conceptually, since I was also trying to familiarize myself with a few XML editors at the same time while applying what I wanted to do with my assignment, I got very frustrated. I sent in my assignment, along with notes about where I was getting frustrated and needing some guidance. Bernard assured me that all would be well, and asked me if he could use what I had turned in for my assignment for the most recent class. He also warned me to have a glass of wine ready while taking class, because I’d be needing it. Yikes!

I was told to prepare for the onslaught of big corrections to my DITA homework with a glass of wine. I took the suggestion seriously, thankfully.
I was told to prepare for the onslaught of big corrections to my DITA homework with a glass of wine. I took the suggestion seriously, thankfully.

The glass of wine was done by the end of the class, and yes, he ripped my assignment apart, but it was okay in the end. I knew there were problems with it, and he showed me where my original thought process was correct, but I didn’t know how to execute it properly. One of the mistakes I was making was my use of XML tags, particularly using the correct ones. While the XML editing apps all have guidance features to help you with using correct tags in certain situations, I still wasn’t using the best choices. Most of that was because I’m not familiar with what these XML tags mean, so I was using them at face value. For example, I was using a step example tag in part of my content, and Bernard understood why I used it, but felt that the way I used it was incorrect, and didn’t allow for cleaner coding. Okay, I can deal with that, especially when he demonstrated the correction.

So, as much as I’m struggling with DITA, I do understand the essential concepts behind it now. My biggest problem is learning how to use it beyond the most elementary tasks. I haven’t had any “real world” scenarios to date when I could implement and learn how to use the XML editors and use DITA practices in writing or rewriting content.  I need to figure out how to find content and start having a way to truly play with something so that I can get the full experience of that trial and error to master DITA.

After the STC course that Bernard is teaching, I plan to follow-up with Scriptorium’s DITA tutorials as well, and see if I can learn some more about XML coding. I have a lot to do to figure this out, but I know that in the end, this will be a big skill that will make a lot of difference in how I approach content. The content strategist skills I already have acquired have helped me frame DITA much more easily than if I learned this with no prior knowledge. But, I can tell that I still have a long way to go before I feel that I’ve mastered this.

So, this ends my confession. I have needed to learn DITA.  If it’s not taught in university classes in technical writing, it should be. I think it would have saved me a lot of frustration, and provided more opportunities for me sooner. If I can get a better handle on this, I’m hoping that I can start exploring how XML Editors can integrate with CMSs, like Adobe CQ. I’m not an Adobe AEM developer (I’m not a developer at all!), but I know how to create websites and pages with AEM, and hopefully I can start figuring out how to integrate those skills with DITA skills. I was told by one mentor, that would make me a very desirable job candidate, and I think she’s onto something. Of course, I need to brush up on my AEM skills, since it’s been a couple of years since I’ve used them regularly, but with all things, once you master them, it’s like riding a bicycle. You might be a little unstable at first, but you never quite forget how to do it once you get started back into it again.

Here’s hoping that in 2017, DITA will become a “bicycle” skill for me. I’ll go say a few rounds of the Rosary in the meantime for my penance.

(What do you think? How important is DITA in technical writing? I’ve heard some say it’s a passing trend, and others say that its usage continues to grow. Include your comments below.)

Posted in Uncategorized

How Statistics Solved a 175 Year Old Mystery About Alexander Hamilton

What do Alexander Hamilton, Harry Potter, and Bayesian Statistics Have in Common?

Source: How Statistics Solved a 175 Year Old Mystery About Alexander Hamilton

Oh, when I read this, I knew this would appeal to the history geek in me, while also satisfying the tech comm geek in me as well.  When the click bait of this article says, “What do Alexander Hamilton, Harry Potter, and Bayesian Statistics Have in Common?”, you know I went for the bait. And knowing that Alexander Hamilton’s reputation is becoming more relevant thanks to the Broadway musical, “Hamilton”, I thought this would be relevant to share.

hamiltonNot only did I come away with a cool story about The Federalist Papers and statistics, but the thing that kept coming back to me was how tech comm has become advanced enough that we use many of the same techniques in content strategy now.  To be more specific, Mark Lewis and his talks and book about XML metrics instantly popped into my head, and how we use similar statistics to figure out how to economize our content, and provide the best ROI for the content that is created.

Read this article, then go back and read my articles about Mark’s talks about XML Metrics here and here. You’ll see where I was making a connection.

What do you think about this? Do you think that The Federalist Papers project laid the groundwork for XML metrics and other metrics we use today in tech comm? Why or why not? Include your comments below.