Skip to content
Content Pro banner

Skills and Technologies Survey 2014

Posted in Surveys

SkillsTechnologiesPlatformsSurvey Home

To All User Assistance Developers,

There is no question that the software development world offers a lot of excitement and challenging work. In the area of software user assistance we are particularly challenged by having to master a wide range of disciplines. From foundation skills like writing and editing—to the coding of content—to usability testing and user interface design, we find ourselves in a profession that is difficult to define. What is it that we really do?

The objective of this survey is to take a snapshot of our collective professional life in an attempt to identify what we value in our daily work as user assistance professionals:

  • What emphasis do we place on writing and editing—versus coding and design skills?
  • What platforms do we support?
  • Which technologies are most important to our UA systems?

The results of this survey may help us to better manage our career path and to improve the quality of our work.

The 2014 Skills and Technologies Survey was published on the WritersUA web site from September 23, 2013 – January 25, 2014. There were 444 respondents. Anyone could participate in the survey. We did not require respondents to identify themselves. What you have in front of you is a synthesis of the results. We’re presenting our analysis in three different sections: Skills, Technologies, and Platforms.

This study comes with a couple of caveats. First, the majority of respondents are most likely customers of WritersUA. Most of the survey submissions came in response to email broadcasts we made to our mailing list. However, the WritersUA constituency is large and probably is a fair representation of the overall user assistance community. We also announced the survey on related discussion lists. Second, this survey is intended to represent the interests of technical writers involved in software user assistance and may not be representative of the technical communication or the software development communities at large.

To receive news and updates on future WritersUA surveys and events, join our mailing list.

General Comments

We received a number of comments from respondents regarding the survey.

  • Although we don’t write to Simplified English standards, we are applying a form of plain English and global English guidelines to make translations more efficient and effective.
  • Another tool we use: Acrolinx to enforce our style guide and word usage for more consistent translation.
  • Big issues are • migrating to new tools/sw • changing content management philosophy for ease of maintenance as well as ease of reuse.
  • Great survey. You may want to expand it slightly and ask about user interface prototyping or wireframing tools.
  • I am not an information architect nor a UX designer so some questions may be applicable to that department but not for my daily work.
  • I edit technical white papers and best practices papers for an engineering group in a large multi-national company.These are normally made available on one of the company web sites for download. Many of your survey questions didn’t apply to my current situation. In previous years, I did a lot of original help development…that was fun!
  • I think you should include questions about management systems (both CMS and LMS), including Joomla, Drupal, MODx, and other web-based CMS as well as the “traditional” ones that come to seasoned writers’ minds….
  • I working for a start-up, creating their first full product manuals with Word. Everything else will be future considerations.
  • I’d love to know more about teams. Could you do another survey that covers working situations/environments and teams? Are folks embedded on dev teams, independent contractors, part of a UA team?
  • My team does not use XML-based authoring, but we have defined and implemented help content standards that align with DITA’s concept, task, and reference model.
  • Please note that what I find important in my daily work differs from the view of my managers (mostly engineers). For instance, I do not personally see HTML Help as invaluable to my work.
  • Q10 . sadly, none of the above. We are in the Dark Ages…. :/
  • RoboHelp Arbortext
  • Simple and to the point – well designed
  • Some of us use DocBook, not DITA.
  • Sorry wasn’t sure what some of the questions were really asking (so skipped at least one). Good luck (wish I could make the conference this year!)
  • Suggest a section for writing methods / concepts used, such as style guides (Chicago, Microsoft, etc), minimalism. Also, a subsection for those who are currently learning, in the process of migrating and/or interested in updating their tools and skills in mentioned categories, such as DITA. This data may reveal real desires that most likely hampered by stale management thinking, budget limits, etc. – yet separated from “current use” categories.
  • Survey is excellent. I use process mapping and documentation templates for Word and Wikis on ServiceNow (this is an extremely new tool and we are just learning). I would appreciate learning everything I can about documentation in Wikis on ServiceNow. I am concerned about Version Control, the integrity of the content, and the apparent lack of an approval process.
  • Thank you for the opportunity to participate.
  • This was very easy to complete. Well done!
  • Tools – MS Word, MadCap Flare, Adobe Pro, SnagIt
  • Voice and tone becoming very important–customers are less and less tolerant of “tech writer-ese”.
  • We are in the process of selecting a new content authoring platform, so items relating to DITA and XML are anticipated in in the immediate future.
  • We use a third-party CMS for all online documentation.
  • We use the Rational Unified Process (RUP) developmental framework, not included in the list for Question number 10.
  • We use Visual Studio online to manage our agile content development practices
  • What about public style guides used e.g. Microsoft manual of style, chicago, ap, msdn for ui text, etc.
  • Why is it that WritersUA only ever cares about tools? True value-added technical communication is about the effective use of language to support user goals — it’s about effective human communication, not about a flavor-of-the-month tool set! How about promoting some fundamental writing skills for a change?

15 Comments

  1. Russ Friend
    Russ Friend

    “Voice and tone becoming very important–customers are less and less tolerant of “tech writer-ese”.” — A trained tech writer should avoid developer/engineering jargon. Other than the term “tech writer”, we don’t have a jargon. If special terms are required, they need to be defined the first time they appear. Initialisms should be treated the same way. Also, basic tech comm is knowing your audience and writing to them. With global audiences it means digging into cultural differences and writing for translation (as others indicate).

    02/04/2014
  2. 191452 75585Hello, Neat post. There

    06/09/2014
  3. 532897 450072This write-up is really appealing to thinking folks like me. It is not only thought-provoking, it draws you in from the beginning. This really is well-written content material. The views here are also appealing to me. Thank you. 665864

    06/11/2014
  4. 417550 595755I truly enjoy examining on this site , it has excellent content material . 836549

    09/11/2014
  5. 39571 471838Hey! Do you know if they make any plugins to protect against hackers? I

    09/17/2014
  6. 559156 862154Some times its a pain in the ass to read what blog owners wrote but this website is truly user pleasant! . 469044

    09/30/2014
  7. 831961 748183This really is genuinely intriguing, You are a quite skilled blogger. I

    10/23/2014
  8. 542593 633258Paris Hilton: So lovely spending time with Manny and h 367329

    10/30/2014
  9. 627808 607612I added this write-up to my favorites and strategy to return to digest a lot more soon. It is straightforward to read and realize as properly as intelligent. I truly enjoyed my very first read by means of of this write-up. 300941

    11/18/2014
  10. 777537 866384Right after examine a couple of with the weblog posts on your internet web site now, and I actually like your manner of blogging. I bookmarked it to my bookmark site record and will probably be checking back soon. Pls take a appear at my internet page as properly and let me know what you feel. 109352

    11/24/2014
  11. 693941 852635This is a excellent website, might you be interested in doing an interview about how you created it? If so e-mail me! 77433

    01/28/2015

Comments are closed.