User manuals as project management tools. II. Practical applications

Abstract

In a companion paper (1994) I argued that the mismatch of a delivered Information System (IS) to the users' expectations of it is a frequent cause of project failure. These expectations are held in a conceptual structure, referred to by some authors as a mental model. Helping users develop appropriate mental models of the new IS in an early project phase is an important element in managing expectations, but the documents traditionally used to express and check users' requirements often fail in this regard. Over the last two decades a few authors have found that user manuals written early in the project can be very effective as a means of communication between developers and users. This paper reviews the literature and describes the different roles that user manuals can play throughout a project. It provides practical advice for professional communicators, project managers, and other project personnel.< <ETX xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:xlink="http://www.w3.org/1999/xlink">></ETX>

Journal
IEEE Transactions on Professional Communication
Published
1994-01-01
DOI
10.1109/47.317478
CompPile
Open Access
Closed
Export

Citation Context

Cited by in this index (3)

  1. IEEE Transactions on Professional Communication
  2. IEEE Transactions on Professional Communication
  3. IEEE Transactions on Professional Communication

References (75) · 3 in this index

  1. Saving IT's soul: Human-centred information management
    Harvard Bus Rev
  2. The Politics of Projects
  3. Information Politics
    Sloan Manag Rev
  4. 10.1016/0378-7206(93)90018-O
  5. 10.1145/67933.67934
Show all 75 →
  1. 10.1109/52.207230
  2. Learning Issues for Intelligent Tutoring Systems
  3. 10.1145/163430.164050
  4. 10.1007/978-3-642-48354-7_9
  5. Structured Systems Analysis and Design Methodology Version 4 Reference Manual
  6. Decline and Fall of the American Programmer
  7. Impacts of life cycle models on software configuration management
    Communic of ACM  
  8. 10.1145/130226.148055
  9. SADT Structured Analysis and Design Technique
  10. Structured Design Fundamentals of a Discipline of Computer Program and System Design
  11. A Sociology of Monsters Essays on Power Technology and Domination
  12. 10.1016/0268-4012(89)90021-2
  13. 10.1287/mnsc.30.5.586
  14. 10.1109/ICSE.1993.346046
  15. Managing the development of large software systems: Concepts and techniques
    Wescon Technical Papers
  16. How to make reengineering really work
    Harvard Bus Rev
  17. IEEE standard for developing software life cycle processes IEEE Std 1074-1991
  18. Software Quality Engineering
  19. Software Product Evaluation?Quality Characteristics and Guidelines for Their Use
  20. Prototyping as a tool in the specification of user requirements
    Proc 5th Int Conf on Software Eng
  21. Defining and specifying the quality attributes of software products
    Australian Comp J
  22. Instant screen design
    J Syst Manag
  23. Effective user documentation: Focusing on tasks instead of systems
    J Syst Manage
  24. Mental Models
  25. IEEE Transactions on Professional Communication
  26. Technical writers as technical resources
    Proc 29th Int Tech Commun Conf
  27. Journal of Technical Writing and Communication
  28. Including writers on the software development team
    Proc 33rd Int Tech Commun Conf
  29. How to write your user manual before the programmers write the software?and why you should
    Proc 37th Int Tech Commun Conf
  30. A document-first strategy may cure specification indigestion
    ComputerWorld
  31. The next step: An integrated approach to computer documentation
    Tech Communic
  32. The need for technical communicators on the software development team
    Tech Commun
  33. User's nightmare, lawyer's dream
    Manag Accounting (UK journal)
  34. 10.2307/249435
  35. 10.1145/170846.170860
  36. 10.1145/50087.50089
  37. Programming as if People Mattered Friendly Programs Software Engineering and Other Noble Delusions
  38. 10.1145/42404.42408
  39. Runaway computer systems
    Best's Review (Life/Health Insurance Edition)
  40. The real crisis of documentation: Managerial monkey wrenches
    Proc 36th Int Tech Commun Conf
  41. 10.1109/52.62929
  42. Software Inspection Process
  43. Software Engineering Economics
  44. 10.1109/2.59
  45. 10.1145/1005937.1005943
  46. 10.1109/32.29489
  47. 10.1109/52.62930
  48. 10.2307/249271
  49. 10.1016/0378-7206(85)90019-9
  50. 10.1016/0378-7206(87)90062-0
  51. 10.1016/0378-7206(93)90063-Y
  52. Participatory Design Principles and Practices
  53. Journal of Technical Writing and Communication
  54. 10.1016/0378-7206(88)90066-3
  55. 10.1111/j.1365-2575.1993.tb00128.x
  56. Project Planning and Control
    Datamation
  57. 10.1145/128894.128897
  58. IEEE Tutorial on Software Engineering Project Management
  59. A management information system designed by managers
    Datamation
  60. Contracting for Computers
  61. System and Software Requirements Engineering
  62. Contr Comput
  63. 10.1145/129630.129632
  64. Computer contracts: Recent developments in the legal liability of vendors
    Software Law Journal
  65. Computer Law-Acquiring and Protecting Computer Technology
  66. Mental Models in Human&#x2010 Computer Interaction
  67. 10.1109/2.76263
  68. Software Management
  69. The User's Mental Model of an Information Retrieval System Effects on Performance