NDLI: Designing computer documentation that will be used: Understanding computer user attitudes

Please wait, while we are loading the content...

Separating content from form: A language for formatting on-line documentation and dialog

Computer user manuals in print: Do they have a future?

ADL—A documentation language

Software maintenance documentation

Documentation generation from a PSA database

Evolution of program documentation through a long-term project

BASIC and DOS jobstreams in IBM PC software documentation

Designing computer documentation that will be used: Understanding computer user attitudes

Better quality through better indexing

Documentation's recognition problem: What can we do about it?

If writers can't program and programmers can't write, who's writing user documentation?

An informal overview of CUINFO (Cornell's computer-based bulletin board)

Help texts vs. help mechanisms: A new mandate for documentation writers

Improving systems documentation using an online copy editor

New metaphors for understanding the new machines

A paperless environment for group effort in documentation development

Creating a campus on-line news system

Factors affecting readability

Documentation: Effective AND literate

The Flesch index: An easily programmable readability analysis algorithm

Multilingual programming: Coordinating programs, user interfaces, on-line help and documentation

The impact of technology on publishing through the ages to you

Merging text and graphics

Dynamic screens and static paper

A case history of a computer media event—introducing a supercomputer center

From pencils and paste-ups to VDTs and the integrated page: Some thoughts on the state-of-the-art

Designing computer documentation that will be used: Understanding computer user attitudes

Content Provider	ACM Digital Library
Author	Solem, Ann
Abstract	At the Los Alamos National Laboratory we have over 15 years of experience in designing computer documentation for computer users of the Los Alamos Integrated Computing Network (ICN), which includes five major operating systems. Currently there are over 6,000 users of the ICN: programmers, scientists, technicians, managers, technical editors, and secretaries. They can choose from more than 1,000 printed documents and a variety of online information sources.Because of this plethora of information, many users do not know where to find the information they need. And, after finding the right document, they may be dissatisfied by the way the information is presented.Over the last few years we studied our computer users and their needs for information. Our objective was to develop a model that could be used to organize the mountain of computer documentation that is needed for complex computer networks.In this paper we present the results of this study.We find that user attitudes toward information acquisition fall into three categories: (1) no time to learn, (2) want to learn, and (3) know what I want.No-time-to-learn users generally are using the computer as a tool and are trying to accomplish something in their own discipline. They need Quick Steps documentation that shows them what to do without explanation.Want-to-learn users have the time and inclination to learn a computing topic in a methodical way. They need Learning documentation that teaches the use of computers by developing an understanding of computing concepts and providing a foundation for generalization.Know-what-I-want users generally are knowledgeable in a specific computing area and simply want to look up particular information. They need Reference documentation.We find that these user attitudes significantly determine documentation needs, even more so than do experience or background. We reject the significance of alternative factors, including casual vs. expert; programmer vs. nonprogrammer; scientist vs. manager vs. secretary; and inexperienced vs. experienced. These factors tend to pigeonhole people and fail to recognize that a user can have different documentation needs at different times of each day.The types of documentation resulting from this understanding of our computer users are (1) Catalog, (2) Quick Steps, (3) Learning, and (4) Reference.Catalog documentation helps all users select the systems and documentation they need. It compares system capabilities in tabular and textual forms. It may describe computing concepts that users must understand in order to make their selections.Quick Steps documentation shows no-time-to-learn users what to do without explaining it. There is little reading and there are lots of examples. Development of Quick Steps documentation is appropriate for systems that are used by many people.Learning documentation teaches the use of computers by developing an understanding of computing concepts and providing a foundation for generalization. There is lots to read and try. Learning information can be provided in a variety of forms, including tutorial manuals, computer-assisted instruction, and live or videotaped courses. It is useful for want-to-learn users who have the time and inclination to learn a computing topic in a methodical way. Development of Learning documentation is appropriate for systems that are frequently used and where in-depth understanding by many people would be useful.Reference documentation can be provided in a variety of forms, including comprehensive reference manuals, quick-reference cards, online help, and glossaries. It is useful for know-what-I-want users who generally are knowledgeable in a specific computing area and simply want to look up particular information. All computing topics require Reference documentation.Additional documentation, such as news about changed computing capabilities and public information for laymen, is also required.We believe that it is necessary to consider computer user attitudes in order to design documentation that will be used.
Starting Page	55
Ending Page	56
Page Count	2
File Format	PDF
ISBN	0897911865
DOI	10.1145/10563.10571
Language	English
Publisher	Association for Computing Machinery (ACM)
Publisher Date	1986-02-01
Publisher Place	New York
Access Restriction	Subscribed
Content Type	Text
Resource Type	Article

Central Library (ISO-9001:2015 Certified)
Indian Institute of Technology Kharagpur
Kharagpur, West Bengal, India | PIN - 721302

See location in the Map
03222 282435
Mail: support@ndl.gov.in

Sl.	Authority	Responsibilities	Communication Details
1	Ministry of Education (GoI), Department of Higher Education	Sanctioning Authority	https://www.education.gov.in/ict-initiatives
2	Indian Institute of Technology Kharagpur	Host Institute of the Project: The host institute of the project is responsible for providing infrastructure support and hosting the project	https://www.iitkgp.ac.in
3	National Digital Library of India Office, Indian Institute of Technology Kharagpur	The administrative and infrastructural headquarters of the project	Dr. B. Sutradhar bsutra@ndl.gov.in
4	Project PI / Joint PI	Principal Investigator and Joint Principal Investigators of the project	Dr. B. Sutradhar bsutra@ndl.gov.in Prof. Saswat Chakrabarti will be added soon
5	Website/Portal (Helpdesk)	Queries regarding NDLI and its services	support@ndl.gov.in
6	Contents and Copyright Issues	Queries related to content curation and copyright issues	content@ndl.gov.in
7	National Digital Library of India Club (NDLI Club)	Queries related to NDLI Club formation, support, user awareness program, seminar/symposium, collaboration, social media, promotion, and outreach	clubsupport@ndl.gov.in
8	Digital Preservation Centre (DPC)	Assistance with digitizing and archiving copyright-free printed books	dpc@ndl.gov.in
9	IDR Setup or Support	Queries related to establishment and support of Institutional Digital Repository (IDR) and IDR workshops	idr@ndl.gov.in