How many words make a technical writer?

Alice BRODBECK – Boris DURUPT – Marie PINQUIER

M2 CDMM 2017/2018 – Université Paris 7 Paris Diderot

Abstract

Technical writing has undergone drastic changes from its early beginnings to the advent of the Internet, adapting to all the technological innovations that punctuated the century since its conception. One of the most important changes being that technical writers do not spend as much time writing as was formerly expected of their profession. Instead, companies ask them to broaden their working scope from writing to taking care of whole documentation systems. Technical writers have gradually become technical communicators, mastering various skills – including but not limited
to writing.
However, the job title has not evolved as quickly as the profession: there seems to be a discrepancy between label and reality, which could be the explanation to a lack of recognition for technical communicators in Europe.
In light of this observation, we conducted a survey on 40 French technical communication experts and analyzed the existing literature on the topic. Our objective: find out why “technical writer” has become a catch-all term of technical communication.
Our journey starts at the origins of technical writing, continues with an overview of the profession’s representation in Europe and provides an analysis of the gaps between technical writers and technical communicators.

Read the full article (PDF):

Raising awareness of the value of technical communication: Different contexts, but a common challenge

Lisa LOPES and Loïc GODEFROY
Paris Diderot University, July 2017

Abstract

In spite of many attempts to enhance the value of technical communication, it remains hidden in the background. There is a wide gap between how people perceive technical communication and what it is exactly. Which tools or methods could be used to raise technical communication awareness, when technical communicators work in various professional contexts? We investigated how technical communication is perceived within a company. Then we set up a strategy to define tools that could be relevant to our work context, some of them being metrics or internal communication, for example. In the
end, these tools proved to be efficient but may not give the same results in other contexts.
If any case, the best lesson we take from this research is use what we know best: to
communicate. Just like cobblers do not make good shoes for themselves, technical communicators have a great skill they often misuse. In order to change the way we are perceived and break silos in whatever company we may be working for, it is up to us to reach out to others, using our experience. This paves the way for an emerging type of communication: Information 4.0.

Read the full article (PDF): Raising awareness of the value of technical communication

Technical communication: a two-sided coin?

Koussai HOUSSINE, Laetitia NALY, Axel PETIT
Paris Diderot University, July 2017

Abstract

Technical communicators like to perceive themselves as go-betweens who use language to bring tech objects closer to the general public. Still, is technical communication (abbr. TC throughout the article) really a two-sided coin that bridges the gap between the humanities and science, the “two cultures” in Charles Percy Snow’s terms?
The aim of this paper is twofold: testing the assumption that makes technical communicators middlemen between the two cultures, and to do so, defining the features of the language of TC by general linguistic standards. A sharp analysis of the language of technical communication provides many interesting clues to define its identity.
First, a short history of technical communication since World War II helps us understand how the language of technical communication changed with economic, social and political contexts. Second, we sketch a definition of human language in order to set an accurate theoretical frame and to define the features of the language of technical communication. Third, the discussion of a series of tests completes the qualitative analyses of the first two parts. It provides evidence to support the conclusion of this paper.

Read the full article: Technical communication: a two-sided coin?

Should companies combine marketing and technical content to adapt to the shift in UX expectations?

Saran Kante, Clémence Bolinga, Dina Radaoarisoa
July 2017

Abstract

Companies put customers’ needs at the center of their strategy to build a relation of trust and increase customer’s loyalty to their products. In their effort, companies become more and more prone to offer customers a linear experience from the moment they are attracted by the perspective of buying a product or service (marketing) up to after their buying act when they start using the product or service (technical communication). The quality of both marketing and technical content is crucial.
We wanted to have an insight of what experts of technical communication and marketing think of a possibility for these two services to collaborate. In order to get this information
we interviewed professionals from these two fields, we attended conferences and seminars on the subject of combining technical content with marketing content to unify customer experience.
Companies undertaking such a change should thoroughly study the transition process, the product and the profit.
One of the challenges a company would face is how to make two services that are used to working separately pool their skills to achieve a common goal which is to provide their users a high quality service. The credibility customers grant to a company depends on it.
Because the two services use their own terminology to achieve their respective goals, they would need to reach an agreement on the terms they are both going to use to produce their content.

Read the full article (PDF): Should companies combine marketing and technical content to adapt to the shift in UX expectations?

Technical innovation: what impact on quality in technical writing?

Deepa HANS, Cécile LEANG, Anne RIVIÈRE
Paris Diderot University, July 2017

Abstract

Nowadays, innovation is considered as a race for companies. Companies need to win this race in order to stay ahead of the game. In this frantic pursuit of innovation, it is important to keep in mind that innovation for innovation’s sake is pointless. To bring value to companies, innovation must lead to quality improvement and cost reduction. Like any other profession, technical writers are compelled to innovate in order to stay relevant. The most obvious expression of innovation lies in the introduction of new tools in the documentation process.
This article explores the impact of technical innovation on the documentation process and product. To be valuable, technical innovation needs to enhance the quality of the process or the product. This article aims at answering the following question: to what extent does technical innovation impact the quality of the documentation process and product? To a lesser extent, we also analyze the role of innovation-driven companies in fostering innovation for technical writers.
In addition to reading articles on innovation, quality and the relationship between the two, we also carried out a survey aimed at technical writers. From the results, we found out that while technical innovation improves both the documentation process and product, the most significant impact may actually come from rethinking information flows and team organization.

Read the full article (PDF): Technical innovation: what impact on quality in technical writing?

CDMM Research: A seminar with Ray Gallon and Andy McDonald

Ray Gallon and Andy McDonald are leading professors and experts, with multiple-decade experience in the fields of technical communication and information. In 2016, they joined forces to create a consortium, aiming to promote “information 4.0”, a reading grid to the accelerating evolution of information.

Students of CDMM Master 2 have been familiarized with Ray and Andy’s presentations at Paris’ 2017 Documation Data Intelligence Forum, and they met again on May 31st, to discuss information 4.0 and elaborate around it, in the context of their technical communication, information architecture and content management program.

CDMM: What is information 4.0?

Ray Gallon and Andy McDonald: Our research revolves around the general theoretical question of the role of information in the context of technological progress.

On a practical level, information 4.0 aims at ensuring we take this evolution into account.

In other words, it provides help to anticipate the evolution of the technical communication industry, and it outlines reasons why this industry needs to evolve.

For example, software developers think around functions or groups of functions, while users are concerned only with the tasks they have to carry out. The role of technical communicators can therefore be broadly described as translating an approach by function into a logic of tasks: it is obviously much wider than designing user manuals.

Information 4.0 also takes into account and capitalizes on the rapid growth of chatbots, augmented reality (AR) devices and applications, the Internet of things (IoT) and artificial intelligence (AI).

Is AI truly intelligent?

As of today, even the most powerful AI, such as the ones that beat chess or go masters, only simulate intelligence: they do not begin to approach consciousness, which is a prerequisite to “human-style” intelligence.

Current AI can accumulate data and use it in the most relevant way, in relation to a particular task or series of tasks, however complex, but they cannot learn: they are not able to perform a task they have not been designed to perform, nor to take initiative outside of their functional envelopes.

However, AI is already very useful, notably to carry out repetitive actions, better than humans – for a cost that is quickly soaring.

What are the risks of AI?

The main risk of AI is for humans to give up control over tedious and recurring tasks, without a possibility to go back – just because we might soon forget how to perform them. In general terms, AI obviously raises numerous governance, interoperability, and ethical issues. To maintain control over AI, its very concept and the questions it poses must be well understood, and the aim of each AI solution has to be precisely defined. For example, don’t pretend you are trying to build an intelligent city if what you are actually working on is a bandwidth wide enough to accommodate three interoperating networks…

How do you see technical writing evolving?

It is evolving quickly and deeply, around the issues we have already been talking about, which will become ever more present.

The emergence of the agile method of code maintenance is a good example of ongoing changes: pseudo-real time adaptation is an actual goal for many companies. Information is becoming obsolete much faster already, which emphasizes the need for contextualization and interactivity, notably with regards to the development of IoT and machine-to-machine communication.

In the span of five to ten years, from writing instructions, procedures or manuals, the role of the technical writer will continue to evolve towards information retrieval, sorting, filtering and distribution, in relevance to the needs of the target audience. As very important vectors of information, you need to embrace this evolution to prepare for it.

You have been stressing the need for information contextualization. Can you elaborate on this?

Context is key, indeed. Information is only valid in a certain context, and contexts change in an increasingly fast manner. Hence, in some companies, personas are designed, only to be used for a single hour. Other contexts are already tracked and even materialized by RFID beacons, which directly link information to its potential user; the aim is to offer information, rather than deliver it.

Imagine you are in Cairo. Your need for information will change considerably, depending on the fact you are a tourist, a local, or an Egyptologist. Ideally, offered contextualized information addresses your specific needs – which raise the issue of context granularity, a whole other challenge in itself.

In that respect, adopting the molecular information approach we are advocating with our information 4.0 logic can be helpful.

What is molecular information?

We believe breaking down information into molecules facilitates information reuse.

Molecules of information are autonomous, self-sufficient, fundamental blocks of content. In that logic, the sense and nature of a document depends on the way its information molecules are assembled.

However, just like in the field of chemistry, in that of information, mixing molecules can carry surprising outcomes. It can even be dangerous. That is why information molecules need to be precisely organized, defined, and tagged to ensure their sensible use and to avoid meaningless or erroneous documentation.

Bearing this paramount rule in mind, information molecules can prove a powerful tool in tackling the issues of contextualization and context granularity. Molecules can indeed be used in a great variety of contexts, providing they are governed by a clear and precise editorial policy.

As a summary, what is your vision of the current work of a corporate information specialist?

In a context where, as we saw, the value of information becomes increasingly doubtful, an information specialist’s main task is definitely to maintain and increase the value of the company’s information base.

Information is, indeed, one of the most precious intangible assets of any company. It needs to be retrievable, organized and up to date.

Information specialists therefore have to force their way into scrum and marketing meetings, for example: wherever they are located in the organization chart, they literally stand at the center of any firm that values its history, its products and services, and its customers.

Finally, information specialists need to adapt to the idea of a world where, in the foreseeable future, software will be able to read users’ facial expressions, and to respond to them.

CDMM research: 6 questions to Noz Urbina

In April, CDMM students had the pleasure to interview Noz Urbina for their research projects. Noz Urbina  (Urbina Consulting) is a globally recognized leader in content strategy, customer journey mapping, and adaptive content modelling. He is co-author of the book “Content Strategy: Connecting the dots between business, brand, and benefits” and lecturer at the University of Applied Sciences, Graz, Masters Programme in content strategy.

This year, several of CDMM students’ research projects focus on enjoyable customer experience and the relationships between marketing and technical communication. The students tapped into Noz’s expertise in that field to move their projects forward.

1- How can we make technical communication more enjoyable to users?

Make it invisible! Those who are old enough to remember Microsoft Clippy know that if you make technical help too pro-active, it can become really annoying. Today, however, we have smarter  devices that can better detect context to deliver information – but this information needs to be relevant: Don’t shove an encyclopedia under people’s noses, even if it has a search box! People want answers they can action – not better tech docs. Be open to any medium, paradigm or method that can better convey those answers into people’s minds.

Make sure you distinguish doing time from learning time. For doing-time content, you can use 3D diagrams and explodes to make your content more engaging, but don’t pull users away into a game. For learning-time content, where there are things to memorize, you can use gamification, narratives and visual metaphors. If you can engage pleasure or pain, then people will memorize better. For that reason, games are a good, enjoyable choice to support learning. There’s more to docs than just looking up quick facts or tasks. Technical communication should help users self-educate when appropriate.

In both cases, consider tone and voice: while tone may vary depending on context, the voice you use for the brand should be consistent across the experience.

2- How can we make technical communication more enjoyable to us as professionals?

Technical communicators generally don’t enjoy putting specs into words, and sadly that’s often what they’re doing. Technical communication is a multidisciplinary activity that requires communicators to get into the mindset of users. Creating technical content becomes more enjoyable when you know that you are solving real people’s real problems. Customer journey mapping is a way to make the experience more enjoyable for users and technical communicators alike. Ideally, bring together support, sales, marketing and other people outside your silo around a customer journey map to review how customers accomplish their objectives out in the field. Identify emotional hot spots and ask “is it content or is it bad design?” to identify where content can help in the journey. When content is not the problem, capture that feedback and give it back to the people who can make a difference. A customer journey map enables you to go have more useful conversations about content because you’re talking about the customer view, not your own. Take the opportunity to get into the users’ shoes for a while.

3- Can semantic structure make technical content more enjoyable?

Semantic structure makes content easier to personalize. Semantics is the study of meaning. When we use semantic metadata, that makes content more flexible and adaptive, so that it can be handled by a computer. Personalisation makes content more enjoyable because it focuses the delivery on what’s most relevant. Semantic metadata can also help more relevant content get found by search engines, which helps it solve more people’s problems. This makes the whole endeavor more satisfying.

4- What advice could we give a technical communication department to be more efficient?

You could tell that technical communication department to focus their efforts on 3 points:

  • Customer journey mapping lets you plan what you want to kill, that is, stop making stuff just because you’ve always done it. Maintaining unnecessary or bloated content wastes time and makes consumption faster and easier.
  • Semantic analysis, that is, information typing and content analysis, helps you do better reuse. For example, you can decide to split up a piece of information that is trying to do too much and reuse a part of it. You don’t have to be stick to DITA types for information typing: for example, having a type of information for narrative enables reuse of content that creates a human connection, while keeping consistency in voice. This is often helpful for training or other cross-silo reuse scenarios. Check out Rob Hanna from Precision Content’s work for more details about information typing.
  • Metadata alignment. For example, you can use tools like PoolParty (an ontology management system) to align metadata inside and outside of the technical communication department and drive personalisation or contextual-content.

5- What is the most important thing technical communicators can learn from marketers?

Technical communicators can learn several things from marketers:

  • Relationship building – as opposed to focusing only on speed in delivery and cost efficiency
  • Web design – as opposed to document design
  • Search engine optimization (SEO) – as opposed to focusing only on navigation optimization
  • Analytics and measurement – check the ROI, use, and engagement that your content is achieving

6- What do marketing and technical communication have in common?

Marketing and Tech Pubs are the two parts of the organization that understand words, and that manage customer-facing communication.

They have similar requirements:

  • Call centers rely on technical communication a lot. Marketing are starting to look into call centers because it’s one of the only places when the brand gets to actually speak to users post-sale.
  • Field services and support read the documentation, but they don’t talk. Marketing and Tech Pubs both need them to be carriers of messages to market, and also channels of valuable incoming feedback.

Marketing and Tech Pubs need to align their terminology and context to define who delivers which message, to whom, when and how. Marketing will need to industrialize their content management and scale their processes for the unknown, using skills that tech pubs developed years ago out of their famous necessity for reuse and efficiency. Digital transformation, communication and content are the fastest development areas in the world right now. This is the type of alchemy that happens at the Intelligent Content Conference. People like Jeff Eaton, Rachel Lovinger, Joe Pairman, Ann Rockley, Andrea Ames, or Cruce Saunders are good resources to explore the common points between marketing and technical communication.
Thank you Noz for taking the time to answer our questions and moving our research projects forward!

5th International Conference on Technical Communication – Beyond Silos (2017)

Patricia Minacori, Marie Girard
Research Laboratory Clillac- Arp, EILA Department, at Paris Diderot University
Technical Writers Without Borders

5th International Conference on Technical Communication

Beyond Silos

Friday 3 February 2017, 10.00-17.00
Paris Diderot University Lecture Theater Buffon
15 rue Hélène Brion, 75013 Paris, FRANCE.

This year’s theme was about collaboration between technical documentation teams and their partners in engineering, training, support, user experience, marketing, translation, change management, and so on. Collaboration beyond silos implies tools and methodologies that support new ways of working, innovation, as well as changes in the role of technical communicators.

10h00-10h10 Opening

Patricia Minacori, Marie Girard

10h10-10h30  M2 CDMM research projects [PDF]

Marie Girard and M2 CDMM students

10h30-10h50 Connecting silos through design thinking: radical collaboration in the Wearables Research Collaboratory [PDF]

Ann Hill Duin et al, University of Minnesota, Minneapolis, MN, USA

10h50-11h10 Increasing student access to client information in the service learning technical communication classroom: results of three client contract strategies [PDF]

Sarah Gunning, Towson University, Baltimore, MD, USA

11h10-11h30 Creating collaborations: an interdisciplinary pedagogy for professional and technical writing students [PDF]

Rhonda Stanton and Leslie Seawright, Missouri State University, Springfield, MO, USA

11h30-12h15 Discussions
12h15-14h00 Lunch break
14h00-14h20 Intersection of technical communication and marketing genres: spanning silos through product documentation [Recording]

Scott A. Mogull, Texas State University, San Marcos, TX, USA

14h20-14h40 Breaking silos by building highly coupled cross-functional teams [PDF]

Fanny Bischoff, IBM  

14h40-15h00 Content for Industry 4.0 : content is software is content [PDF]

Ray Gallon, Transformation Society

15h00-15h20 Break
15h20-15h40 Intra-organizational communication without barriers: a case study of a technical communications team within a large organization [PDF]

Fabrizia Poli, Docunet

15h40-16h00 Les bienfaits d’une collaboration réussie  entre communicateurs techniques et traducteurs [PDF]

Vincent Bidaux

16h00-17h00 Discussion

 

Brainstorming the future of technical communication

M2 CDMM students have been busy this semester, identifying ideas for their research projects. They had a very creative 3-12-3 brainstorm on the future of technical communication, and the result is amazing!

This mind map (PDF) gathers all the ideas that were raised in the session (in French).

We’re now looking forward to hearing them present their research projects at Paris Diderot’s 5th conference on technical communication on Feb 3rd, 2017. Check out the conference program.

What is the role of technical writers in fostering accessibility?

Victoria Genin, MarcAlexandre Jacques, Tiphaine Monange

Paris Diderot University, July 1st 2016

Abstract

With the creation of international standards and the rise of public awareness, web and software accessibility have become a topical issue. Yet, it seems like accessibility is still rarely taken into account by technical companies who prefer to focus on innovation.

Part of the usability and accessibility of a software is based on its documentation. As technical writers, we wondered which role technical writers have to play in fostering accessibility.

The information used in this article was drawn from three main sources. In addition to reading articles written by accessibility researchers, we carried out two surveys to study the scope of accessibility in the creation and navigation of user interfaces: the first one was sent to disabled users and the second one to professionals. We also interviewed a highly experienced technical writer trained in accessibility. The results led us to conclude that technical writers definitely have a key role to play in fostering accessibility standards – either by increasing their cooperation with developers or by implementing accessibility solutions themselves.

Read the full article (PDF): What is the role of technical writers in fostering accessibility?

The impact of the digital enterprise on technical communication

Sarah Consentino, Paul Desreux, Alexandre Dias Da Silva, Vincent Perrot

Paris Diderot University, July 2016

Abstract

The digital revolution has changed consumer behavior in the software industry, and digital organizations must keep up with all those changes to stay competitive. As a result, understanding customers’ needs has become part of technical communication. By compiling recent data and studies, this article aims at answering the following question: to what extent have technologies impacted the way that technical communicators assist users to offer them the best experience possible? We first analyzed how companies are starting to place more emphasis on customer experience through digital channels, and to what extent those changes have impacted the way technical communicators present the information and talk to customers. Then, we investigated and found out why technical communication is now perceived as a measurable added business value for companies.

Read the full article (PDF): The impact of the digital enterprise on technical communication

Documentation for the Y Generation

Ghislaine Borenstein, Danielle Purpura, Vanessa Voisin

July 2014

Abstract

This article demonstrates how technical writing will need to evolve to better suit the Y Generation (the “Millennials”). A brief definition of the millennial generation will be outlined, followed by a comparison of past, present, and future means of sharing information. The ultimate goal of the article is twofold. First, to present the emergence of new communication tools and digital media such as QR codes or e-learning publications, and how using the Internet is an effective means of enabling and developing collaborative communication. Second, to demonstrate how this media could be used to improve technical documentations’ user accessibility, mobility and interactivity. To conclude, we will highlight the pros and cons of these new media resources.

Read the full article (PDF): Documentation for the Y Generation

The stakes of collaborative writing

Simon Saint-Georges, Chloé Jaouen

July 2013

Abstract

The arrival of Web 2.0 has changed the ways of working, especially for writers. A wide range of tools now exists, enabling different people to participate in the writing of one single document and introducing new methods of work within teams. These new work methods rely on tools that are constantly evolving. While some companies remain skeptical, others are already embracing these new practices.
Either way, our position of apprentice makes us ideal observers concerning the choices made by our companies and the difficulties that the adoption of these new work methods raises. Such a change can be a real challenge, and selecting the right options to fit one particular situation can be a difficult task.
We will first present the results of our research on the current state of the art in collaborative writing and how and why companies tend to use more and more collaborative writing methods.
We will then explain the situation in the two companies that we work for, Atlas Copco (industrial tooling and equipment) and CNES (Centre National d’Etudes Spatiales, the French space agency), two companies which are heading in opposite directions in terms of collaborative writing. We will observe the practices, tools, processes and work dynamics involved in writing for both companies.
Finally, based on what we found and observed in the first two parts, we will compare theory and reality concerning collaborative writing in companies.

Read the full article (PDF): The stakes of collaborative writing

How User Experience helps reshape technical documentation

Célia Goiset, Océane Franc

July 2013

Abstract

This article explains how the User eXperience (UX) reshapes technical documentation. The fundamental purpose of this research is to show how users’ expectations have an impact on technical documentation. Indeed, technical writing is not only the presentation of information but also how it is designed to meet users’ needs. The goal of the technical writer is to communicate the information in a clear and effective way so that the documentation audience understands it well and quickly. In this article, we will first explain the importance of user experience practices in the technical writing field to then analyze the methods used to satisfy users’ needs in our companies while highlighting the UX impact on the effectiveness and efficiency of the documentation. Finally, we will identify some of the UX best practices and tools to create better documentation and ensure the product and company sustainability.

Read the full article (PDF): How User Experience helps reshape technical documentation