Documentation: Competitive Edge or Necessary Evil?

Given the number of Norwegian software and other high-tech companies, there should be quite a few technical writers in Norway. Why don't they cooperate and join a (professional) community?

Wigestrand, Henrik. TC-FORUM (1999). Articles>TC>Regional>Scandinavia

Educating and Training Technical Communicators for the Challenges to Come?

When I started as a technical writer more than ten years ago, I wrote my first drafts with a pencil. Soon after, desktop publishing became part of my work, as did writing story boards for computer based training and managing online information projects. For several reasons the work of a technical communicator will change at an even higher rate in the future.

Schilliger, Reto. TC-FORUM (1999). Articles>Education>TC

Education for Technical Communicators in Germany

When tekom was established in 1978, education for technical communicators did not exist in Germany. Therefore one of tekom´s main objectives since its foundation was to set up and promote education in the field of technical communication. After all, the improvement of product quality depends largely on the quality of the education of those responsible for the products. By now, a number of universities offer programs in these fields.

Beuttenmüller, Brigitte. TC-FORUM (1998). Articles>Education>Regional>Germany

European Association for Terminology

The European Association for Terminology (EAFT) was formed in 1996 and the first few years of its existence were largely taken up with organisational issues. Recently, however, the EAFT has become more active setting up a European Terminology Information Server (ETIS) and co-organising conferences. The EAFT has also established a number of special interest groups, including SIGs in terminology training and in minority languages.

Lervad, Susanne. TC-FORUM (2000). Articles>Language>Glossary

The European Language Resources Association: Promoting Language Resources in Europe

The European Language Resources Association (ELRA) was founded in February 1995 as a membership association, by a number of leading academic and private-sector bodies in co-operation with the European Commission. As a non-profit making organisation, ELRA aims to serve as a focal point for the collection, marketing, distribution and licensing of language resources, as well as being a provider of general information in the field of language engineering. Day-to-day operations are run by the European Language Distribution Agency (ELDA), while the strategies and plans of ELRA are set by the member-elected board.

TC-FORUM (1998). Articles>Language>Regional>Europe

An Exchange of Views

A discussion about INTECOM's project for researching and establishing English-language documentation guidelines.

Fuchs, Amo and Ronald S. Blicq. TC-FORUM (2000). Articles>Documentation>Style Guides

Facilitate Reading

Despite the fantastic development of computers and software, the paperless society seems to be far from implementation. On the contrary, the consumption of paper for documents has increased over the recent years.

Rullgård, Åke. TC-FORUM (2000). Articles>Documentation>Usability

Fast Online (Machine) Translation - But...?

Even if the attainable quality of automatic translation systems is insufficient under certain conditions, and despite careful preparation of the original text, nevertheless the translation provides a useful basis for a technical translator. The automatic translation greatly simplifies the production of a foreign language text and leads, all in all, to an efficient translation process. For example, the translation of a customer Website with the help of an automatic translation system (i.e. post-edited machine translation) cost us only a third of the time, which we had previously calculated as pure 'manual work'.

Thiele, Ulrich. TC-FORUM (1999). Articles>Language>Localization>Machine Translation

Formalism and its Impact on Technical Writing

Discusses briefly the work market for technical communicators and their careers.

Baumert, Andreas. TC-FORUM (2000). Careers>TC>Multimedia>Technical Writing

From Technical Writing to Technical Communication: Looking to the Future

This paper focuses on the technical communicator’s role as it relates to computer technology.

Fisher, Julie L. TC-FORUM (2000). Articles>TC>Technology>History

Functionalism in TC Training

Analyses of users, functions, situations, risks and cost/benefit, together with functional testing which guarantees that needs are met, provide the basis for the real-life projects which the students of technical communication perform at Karlstad University in Sweden. Tutor support throughout is vital. This article gives examples of such projects from the latest academic year. They show that the students can often demonstrate that technical information is highly worthwhile, as is the value of having a holistic approach to the tasks.

Andersson, Ulf-L. TC-FORUM (2001). Articles>Education

The Future of Technical Documentation 2000-2010

The need for TCs with traditional writing skills will remain fairly stable, but the need for TCs in total will grow. The new technical communicators will come from the world of game design, where they know all about 3D-vector animation, and they will come from the world of TV and video production.

TC-FORUM (2000). Careers>TC>Documentation>Video

Fuzzy + Expensive = Useful?

Executives as well as customers demand quality from technical communicators. However, the requirements of both groups seem hard to combine: Executives want quality to be achieved inside the company by applying quality standards without causing any delay or additional costs. Establishing customer-based quality, on the other hand, usually demands extra money and extra time. Nevertheless both demands can and should be utilized for developing a user-oriented quality system.

Bock, Gabriele. TC-FORUM (1998). Articles>Usability>Quality

Give Them Printed Documentation, Too!!!

The current trend among technical communicators is a twisted form of minimalism that says the documentation should contain procedural documentation but little or no reference documentation. I believe that this trend is a disservice to our customers and tends to increase technical support costs because customers subjected to this form of documentation have little or no access to the information they need. If it’s not there, they can't find it.

Starr, Mike. TC-FORUM (2002). Articles>Documentation>User Centered Design

The High Cost of Quality

Quality Systems (QS) have become essential for (inter-)national competition. Companies spend large amounts of money for 'measuring' quality defined by national and international standards. Quality, however, is a value, and like creeds and ideologies values cannot be measured with scientific exactness and are difficult to control. Total Quality Management (TQM) and other standardized concepts take that idealistic dimension into account. Certification according to ISO 9000, for instance, covers only about 50% of a TQM implementation.

Bock, Gabriele. TC-FORUM (1998). Articles>Project Management>Quality>Standards

High-Tech Communication from Finland

Technical communication is still quite a young field in Finland, and only a few people have been in the field for more than a decade. The average age of a Finnish technical communicator is probably around 30, and most of us have four or five years’ experience and an academic background in languages. Estimates of how many technical communicators there are in Finland are hard to come by, but our guesstimate would be anything from 500 to 1000 (and growing). Even though most of us speak Finnish as our native language, English is the main language of technical communication, since most of the products are exported. Localizability is one of the key elements in Finnish technical communication.

Lahti, Maria. TC-FORUM (2000). Articles>TC>Regional>Scandinavia

How Do You Believe You Add Value to the Development of an Information System?

In recent months, as part of my doctoral research, I have been interviewing technical communicators, users and developers of information systems to try and find out if in fact the work of a technical communicator is of value to those developing and using information systems. The interviews demonstrated clearly that technical communicators do add value. This was further confirmed in Paris where I discussed my work with technical communicators at the Comtec '97 conference. The following discussion encapsulates some of the comments from participants at Comtec '97 and the interviews I conducted.

Fisher, Julie L. TC-FORUM (2003). Articles>Collaboration>TC

How We Educate Technical Communicators in the United States

Schools sending a representative to the annual CPTSC meeting have increased over the years from 9 in 1974 to 39 in 1993. Approximately 10 to 12% of the Society for Technical Communication membership identifies itself as being associated with academic programs-- although not all these programs offer certificates or degrees in technical communication.

Warren, Thomas L. TC-FORUM (1998). Articles>Education>TC

I Know What You Need to Know: Is that User Centered Documentation?

Quality management is forcing technical communicators to meet the challenge of writing user-centered documentation. Adequate preparatory work would be to categorize potential users according to experience, knowledge, tasks to be performed, and other use-relevant features. Users' requirements and requests should then be incorporated into the document's design.

Bock, Gabriele. TC-FORUM (1999). Articles>Documentation>User Centered Design

Ideas on Cooperation Between Suppliers and Users Regarding Documentation

Documentation, operators’ manuals, maintenance instructions, etc, can never be perfect and satisfy all users. The organization of the documentation, particularly for large systems, will never suit all users and there will always be some errors present. This means the supplier and the user need to cooperate in various ways to avoid the fatal consequences of errors and misinterpretations, and for the improvement of documentation over time.

Rullgård, Åke. TC-FORUM (2001). Articles>Documentation>User Centered Design

Impressions from German/American Projects

Differences in culture add problems, as we learned during several months of work with four mixed German/American project teams.

Thiele, Ulrich. TC-FORUM (2000). Articles>Collaboration>International

Independent Consulting in Technical Communication

The number of technical communicators working as independent consultants has increased remarkably over the past decade - may you call this a trend?

TC-FORUM (1998). Careers>Consulting>TC

Indexing Problems? Let's Discuss Them!

The basic principle of indexing is still valid: key words in an index must point end users to pertinent information concepts. This is even more important with on-line documents.

Dunning, Marilyn A. TC-FORUM (1997). Articles>Indexing

INTECOM Code of Good Practice

Assuming that not everybody knows the INTECOM Code of Good Practice, we use this opportunity to publish it in this and following issues of TC-FORUM.

TC-FORUM (2000). Resources>TC>Professionalism