Victoria Genin, MarcAlexandre Jacques, Tiphaine Monange
Paris Diderot University, July 1st 2016
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.
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.
In technical documentation, content must be clear and consistent and visual layout as a whole must be uniform. Ensuring these principles makes it easier for the user to understand documentation and reinforces branding. This seems simple however achieving consistency requires a great deal of organization and effort from technical writers. The aim of this article is to present and defend various solutions for achieving consistency and improving user experience, through observations made in three different professional contexts: two computer software companies and one software and hardware company. In the first part, we will define some of the key elements that impact consistency: grammar rules, methods to address users and acute text architecture and present concrete tools and methods to improve consistency and their constraints. In the second part, we will present the most important aspect to take into account in order to find the best balance across methodologies to achieve consistency in technical documentation.
Fanny Bellaïche, Juliette Massardier and Marielle Morizot
Traditionally, technical communication leverages both technical writing and translation expertise. As both professions share some common skills and objectives, the activities of technical writers and translators are sometimes mixed up. However, they remain two clearly separated occupations and thus complement each other. Based on our working and academic experience as technical writers and translators, we are particularly aware of the importance of a balanced collaboration to align the documentation process with the requirements of today’s industry practice. Current research on the relationship between technical writers and translators mainly focuses on the study of their competences . This paper intends to go beyond the mere analysis of competences and to explore some best practices in order to bridge the gap between both professions: more specifically, to which extent can we consider the translator as a useful resource to improve the writing process? Firstly, we examine why technical writers and translators often collaborate to deliver efficient documentation in their respective fields of expertise. Secondly, we try to understand how technical writers and translators develop shared tools, such as style guides, in order to take advantage of each other’s work. Finally, we show that enhancing this relationship is not the only way to deliver professional documentation.
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.