The authors assess the impact that sophisticated software and hardware tools have on the work of technical writers, and they explore the need for tools that fully utilize the functionality that advanced technology systems can provide. Three development trends in advanced technology environments are discussed: formal software engineering methods, complex applications, and new products. Finally, the need for standardization is addressed.<>
{"title":"Toward a documentor's environment: tools for advanced technology systems","authors":"A. McGonigle, M. W. Solomon","doi":"10.1109/IPCC.1988.24030","DOIUrl":"https://doi.org/10.1109/IPCC.1988.24030","url":null,"abstract":"The authors assess the impact that sophisticated software and hardware tools have on the work of technical writers, and they explore the need for tools that fully utilize the functionality that advanced technology systems can provide. Three development trends in advanced technology environments are discussed: formal software engineering methods, complex applications, and new products. Finally, the need for standardization is addressed.<<ETX>>","PeriodicalId":374472,"journal":{"name":"IPCC '88 Conference Record 'On the Edge: A Pacific Rim Conference on Professional Technical Communication'.","volume":"12 1","pages":"0"},"PeriodicalIF":0.0,"publicationDate":"1988-10-05","publicationTypes":"Journal Article","fieldsOfStudy":null,"isOpenAccess":false,"openAccessPdf":"","citationCount":null,"resultStr":null,"platform":"Semanticscholar","paperid":"121917197","PeriodicalName":null,"FirstCategoryId":null,"ListUrlMain":null,"RegionNum":0,"RegionCategory":"","ArticlePicture":[],"TitleCN":null,"AbstractTextCN":null,"PMCID":"","EPubDate":null,"PubModel":null,"JCR":null,"JCRName":null,"Score":null,"Total":0}
The notion of document accuracy and its relationship to usability are reconsidered. Attention is given to accuracy and the review process and to the problems with expert reviews. Ways to ensure that a document is accurate and complete are discussed, with emphasis on the need to rethink the concepts of both accuracy and usability testing.<>
{"title":"When is a document accurate and complete?","authors":"K. L. Dye","doi":"10.1109/IPCC.1988.24048","DOIUrl":"https://doi.org/10.1109/IPCC.1988.24048","url":null,"abstract":"The notion of document accuracy and its relationship to usability are reconsidered. Attention is given to accuracy and the review process and to the problems with expert reviews. Ways to ensure that a document is accurate and complete are discussed, with emphasis on the need to rethink the concepts of both accuracy and usability testing.<<ETX>>","PeriodicalId":374472,"journal":{"name":"IPCC '88 Conference Record 'On the Edge: A Pacific Rim Conference on Professional Technical Communication'.","volume":"137 1","pages":"0"},"PeriodicalIF":0.0,"publicationDate":"1988-10-05","publicationTypes":"Journal Article","fieldsOfStudy":null,"isOpenAccess":false,"openAccessPdf":"","citationCount":null,"resultStr":null,"platform":"Semanticscholar","paperid":"114654197","PeriodicalName":null,"FirstCategoryId":null,"ListUrlMain":null,"RegionNum":0,"RegionCategory":"","ArticlePicture":[],"TitleCN":null,"AbstractTextCN":null,"PMCID":"","EPubDate":null,"PubModel":null,"JCR":null,"JCRName":null,"Score":null,"Total":0}
The author analyzes the nature of social support systems, the effects of social support systems in reducing burnout, and methods of facilitating a burnout's interactions with his/her social support systems. It is concluded that it may be difficult to form an effective social support system. Lack of trust and interpersonal and intergroup conflicts may inhibit open and constructive communication. Furthermore, inappropriate social interaction can be harmful. However, the overall conclusion is that the support group can be a powerful method for alleviating burnout.<>
{"title":"The nature and development of social support systems for combatting job burnout","authors":"M. Cronin","doi":"10.1109/IPCC.1988.24063","DOIUrl":"https://doi.org/10.1109/IPCC.1988.24063","url":null,"abstract":"The author analyzes the nature of social support systems, the effects of social support systems in reducing burnout, and methods of facilitating a burnout's interactions with his/her social support systems. It is concluded that it may be difficult to form an effective social support system. Lack of trust and interpersonal and intergroup conflicts may inhibit open and constructive communication. Furthermore, inappropriate social interaction can be harmful. However, the overall conclusion is that the support group can be a powerful method for alleviating burnout.<<ETX>>","PeriodicalId":374472,"journal":{"name":"IPCC '88 Conference Record 'On the Edge: A Pacific Rim Conference on Professional Technical Communication'.","volume":"9 1","pages":"0"},"PeriodicalIF":0.0,"publicationDate":"1988-10-05","publicationTypes":"Journal Article","fieldsOfStudy":null,"isOpenAccess":false,"openAccessPdf":"","citationCount":null,"resultStr":null,"platform":"Semanticscholar","paperid":"131120988","PeriodicalName":null,"FirstCategoryId":null,"ListUrlMain":null,"RegionNum":0,"RegionCategory":"","ArticlePicture":[],"TitleCN":null,"AbstractTextCN":null,"PMCID":"","EPubDate":null,"PubModel":null,"JCR":null,"JCRName":null,"Score":null,"Total":0}
A progress report on a study of what makes a person an effective communicator in the technical and scientific fields is presented. The study is based on responses to a questionnaire and many in-depth interviews. It deals with individuals who have to deliver complex technical information to nontechnical audiences or to other disciplines within an organization. The author gives a sampling of replies to a question about the ideal image of a communicator in the technical/scientific fields and describes four distinguishing behavioral traits.<>
{"title":"Presentation skills for the technical professional","authors":"J. D'Arcy","doi":"10.1109/IPCC.1988.24035","DOIUrl":"https://doi.org/10.1109/IPCC.1988.24035","url":null,"abstract":"A progress report on a study of what makes a person an effective communicator in the technical and scientific fields is presented. The study is based on responses to a questionnaire and many in-depth interviews. It deals with individuals who have to deliver complex technical information to nontechnical audiences or to other disciplines within an organization. The author gives a sampling of replies to a question about the ideal image of a communicator in the technical/scientific fields and describes four distinguishing behavioral traits.<<ETX>>","PeriodicalId":374472,"journal":{"name":"IPCC '88 Conference Record 'On the Edge: A Pacific Rim Conference on Professional Technical Communication'.","volume":"30 1","pages":"0"},"PeriodicalIF":0.0,"publicationDate":"1988-10-05","publicationTypes":"Journal Article","fieldsOfStudy":null,"isOpenAccess":false,"openAccessPdf":"","citationCount":null,"resultStr":null,"platform":"Semanticscholar","paperid":"124485781","PeriodicalName":null,"FirstCategoryId":null,"ListUrlMain":null,"RegionNum":0,"RegionCategory":"","ArticlePicture":[],"TitleCN":null,"AbstractTextCN":null,"PMCID":"","EPubDate":null,"PubModel":null,"JCR":null,"JCRName":null,"Score":null,"Total":0}
At Fisher Controls International a detailed model of the technical documentation process was initially developed as an aid in preparation of a request for corporate capital funds to purchase equipment, software, and training for a higher level of documentation automation. A corporate accounting specialist then assisted in preparation of the specific internal paperwork used to justify capital expenditures. The process model has since been used to show the actual impact of the implemented improvements. The current model is now being used as part of a research project to identify the next incremental step in an ongoing automation process. It is concluded that developing a detailed model of the technical documentation process is an important first step in justifying the cost of increasing electronic automation of the process.<>
{"title":"Developing a process model for cost justification","authors":"R. Miller","doi":"10.1109/IPCC.1988.24059","DOIUrl":"https://doi.org/10.1109/IPCC.1988.24059","url":null,"abstract":"At Fisher Controls International a detailed model of the technical documentation process was initially developed as an aid in preparation of a request for corporate capital funds to purchase equipment, software, and training for a higher level of documentation automation. A corporate accounting specialist then assisted in preparation of the specific internal paperwork used to justify capital expenditures. The process model has since been used to show the actual impact of the implemented improvements. The current model is now being used as part of a research project to identify the next incremental step in an ongoing automation process. It is concluded that developing a detailed model of the technical documentation process is an important first step in justifying the cost of increasing electronic automation of the process.<<ETX>>","PeriodicalId":374472,"journal":{"name":"IPCC '88 Conference Record 'On the Edge: A Pacific Rim Conference on Professional Technical Communication'.","volume":"1 1","pages":"0"},"PeriodicalIF":0.0,"publicationDate":"1988-10-05","publicationTypes":"Journal Article","fieldsOfStudy":null,"isOpenAccess":false,"openAccessPdf":"","citationCount":null,"resultStr":null,"platform":"Semanticscholar","paperid":"130598809","PeriodicalName":null,"FirstCategoryId":null,"ListUrlMain":null,"RegionNum":0,"RegionCategory":"","ArticlePicture":[],"TitleCN":null,"AbstractTextCN":null,"PMCID":"","EPubDate":null,"PubModel":null,"JCR":null,"JCRName":null,"Score":null,"Total":0}
The authors describe the effort of Kingston Information Development to gather customers' requirements to improve the conversion information provided for moving from previous versions of IBM's VM operating system to a new version. The VM/XA SP Conversion Notebook was created to minimize the effect of this conversion, and the customers were questioned directly to understand what type of information was needed. Descriptions are given of the philosophy and approach, the requirements gathering sessions, draft evaluation, and follow-on activities.<>
作者描述了Kingston Information Development收集客户需求以改进从以前版本的IBM VM操作系统迁移到新版本所提供的转换信息的工作。创建了VM/XA SP转换笔记本，以尽量减少这种转换的影响，并直接询问客户，以了解需要哪种类型的信息。描述了哲学和方法、需求收集会议、草案评估和后续活动。
{"title":"Gathering advance customer information: enhancing customers' partnerships","authors":"D. L. Dintruff, E. Lueke, K. R. Milhaven, B. Neff","doi":"10.1109/IPCC.1988.24041","DOIUrl":"https://doi.org/10.1109/IPCC.1988.24041","url":null,"abstract":"The authors describe the effort of Kingston Information Development to gather customers' requirements to improve the conversion information provided for moving from previous versions of IBM's VM operating system to a new version. The VM/XA SP Conversion Notebook was created to minimize the effect of this conversion, and the customers were questioned directly to understand what type of information was needed. Descriptions are given of the philosophy and approach, the requirements gathering sessions, draft evaluation, and follow-on activities.<<ETX>>","PeriodicalId":374472,"journal":{"name":"IPCC '88 Conference Record 'On the Edge: A Pacific Rim Conference on Professional Technical Communication'.","volume":"2 1","pages":"0"},"PeriodicalIF":0.0,"publicationDate":"1988-10-05","publicationTypes":"Journal Article","fieldsOfStudy":null,"isOpenAccess":false,"openAccessPdf":"","citationCount":null,"resultStr":null,"platform":"Semanticscholar","paperid":"131244323","PeriodicalName":null,"FirstCategoryId":null,"ListUrlMain":null,"RegionNum":0,"RegionCategory":"","ArticlePicture":[],"TitleCN":null,"AbstractTextCN":null,"PMCID":"","EPubDate":null,"PubModel":null,"JCR":null,"JCRName":null,"Score":null,"Total":0}
The author identifies and describes five approaches that in-house writers need to take to develop organizationally effective manuals; (1) conducting contextual audience analyses; (2) establishing two support teams (documentation development and implementation); (3) assuming liaison roles; (4) defining privileged and shared knowledge; and (5) testing the actual use of the manual.<>
{"title":"Defining the role of in-house documentation","authors":"B. Mirel","doi":"10.1109/IPCC.1988.24023","DOIUrl":"https://doi.org/10.1109/IPCC.1988.24023","url":null,"abstract":"The author identifies and describes five approaches that in-house writers need to take to develop organizationally effective manuals; (1) conducting contextual audience analyses; (2) establishing two support teams (documentation development and implementation); (3) assuming liaison roles; (4) defining privileged and shared knowledge; and (5) testing the actual use of the manual.<<ETX>>","PeriodicalId":374472,"journal":{"name":"IPCC '88 Conference Record 'On the Edge: A Pacific Rim Conference on Professional Technical Communication'.","volume":"17 1","pages":"0"},"PeriodicalIF":0.0,"publicationDate":"1988-10-05","publicationTypes":"Journal Article","fieldsOfStudy":null,"isOpenAccess":false,"openAccessPdf":"","citationCount":null,"resultStr":null,"platform":"Semanticscholar","paperid":"115567554","PeriodicalName":null,"FirstCategoryId":null,"ListUrlMain":null,"RegionNum":0,"RegionCategory":"","ArticlePicture":[],"TitleCN":null,"AbstractTextCN":null,"PMCID":"","EPubDate":null,"PubModel":null,"JCR":null,"JCRName":null,"Score":null,"Total":0}
A more complete involvement of the technical editor in the development process for a computer product is proposed in connection with the concept of layers of editing, i.e. literary, semantic, perennial, and integrated. It is noted that a technical editor whose skills include the integrated layer can review the entire information interface-the key tops, the panels, the manuals, and the marketing materials. In addition it is noted that integrating the editor into the entire development process requires coordination. The editor should coordinate review activities with other groups in order to promote efficiency and to ensure usability beyond the scope of editorial review.<>
{"title":"The integrated editor: involvement of an editor in the entire information development process","authors":"A. Edmands","doi":"10.1109/IPCC.1988.24014","DOIUrl":"https://doi.org/10.1109/IPCC.1988.24014","url":null,"abstract":"A more complete involvement of the technical editor in the development process for a computer product is proposed in connection with the concept of layers of editing, i.e. literary, semantic, perennial, and integrated. It is noted that a technical editor whose skills include the integrated layer can review the entire information interface-the key tops, the panels, the manuals, and the marketing materials. In addition it is noted that integrating the editor into the entire development process requires coordination. The editor should coordinate review activities with other groups in order to promote efficiency and to ensure usability beyond the scope of editorial review.<<ETX>>","PeriodicalId":374472,"journal":{"name":"IPCC '88 Conference Record 'On the Edge: A Pacific Rim Conference on Professional Technical Communication'.","volume":"4 1","pages":"0"},"PeriodicalIF":0.0,"publicationDate":"1988-10-05","publicationTypes":"Journal Article","fieldsOfStudy":null,"isOpenAccess":false,"openAccessPdf":"","citationCount":null,"resultStr":null,"platform":"Semanticscholar","paperid":"114641614","PeriodicalName":null,"FirstCategoryId":null,"ListUrlMain":null,"RegionNum":0,"RegionCategory":"","ArticlePicture":[],"TitleCN":null,"AbstractTextCN":null,"PMCID":"","EPubDate":null,"PubModel":null,"JCR":null,"JCRName":null,"Score":null,"Total":0}
Information processing theory is applied to documents to analyze the visual processing of the page. Research on readers' perceptions of graphic characteristics and spatial organization is examined. A method is presented that increases the efficiency of developing and using a document by applying information processing principles and research on perception. It is concluded that, by applying principles of information theory, the semiology of graphic characteristics, and reader's spatial perception of the page, the desktop publisher can develop visually efficient documents, improving not only the reader's comprehension of the document but also the document development process.<>
{"title":"The visual development of documents","authors":"M. Martin","doi":"10.1109/IPCC.1988.23985","DOIUrl":"https://doi.org/10.1109/IPCC.1988.23985","url":null,"abstract":"Information processing theory is applied to documents to analyze the visual processing of the page. Research on readers' perceptions of graphic characteristics and spatial organization is examined. A method is presented that increases the efficiency of developing and using a document by applying information processing principles and research on perception. It is concluded that, by applying principles of information theory, the semiology of graphic characteristics, and reader's spatial perception of the page, the desktop publisher can develop visually efficient documents, improving not only the reader's comprehension of the document but also the document development process.<<ETX>>","PeriodicalId":374472,"journal":{"name":"IPCC '88 Conference Record 'On the Edge: A Pacific Rim Conference on Professional Technical Communication'.","volume":"34 1","pages":"0"},"PeriodicalIF":0.0,"publicationDate":"1988-10-05","publicationTypes":"Journal Article","fieldsOfStudy":null,"isOpenAccess":false,"openAccessPdf":"","citationCount":null,"resultStr":null,"platform":"Semanticscholar","paperid":"131025704","PeriodicalName":null,"FirstCategoryId":null,"ListUrlMain":null,"RegionNum":0,"RegionCategory":"","ArticlePicture":[],"TitleCN":null,"AbstractTextCN":null,"PMCID":"","EPubDate":null,"PubModel":null,"JCR":null,"JCRName":null,"Score":null,"Total":0}
The author discusses how a pragmatic approach for analyzing legal and quasi-legal documents can help one understand the purpose of such documents and why they are so difficult to write. She explores the purpose of legal language in consumer contracts using a pragmatic approach exemplified by J.L. Austin's (1962) theory of performative statements. It is concluded that the difficulties are compounded when the documents are aimed at audiences who lack legal training. Analyzing documents in a pragmatic fashion can help a writer to discern the difference between language that informs and language that creates. This understanding can in turn help one determine the possible tradeoffs involved when one tries to write documents that contain legal language.<>
{"title":"Understanding legal language: a pragmatic approach","authors":"S. Rhodes","doi":"10.1109/IPCC.1988.24058","DOIUrl":"https://doi.org/10.1109/IPCC.1988.24058","url":null,"abstract":"The author discusses how a pragmatic approach for analyzing legal and quasi-legal documents can help one understand the purpose of such documents and why they are so difficult to write. She explores the purpose of legal language in consumer contracts using a pragmatic approach exemplified by J.L. Austin's (1962) theory of performative statements. It is concluded that the difficulties are compounded when the documents are aimed at audiences who lack legal training. Analyzing documents in a pragmatic fashion can help a writer to discern the difference between language that informs and language that creates. This understanding can in turn help one determine the possible tradeoffs involved when one tries to write documents that contain legal language.<<ETX>>","PeriodicalId":374472,"journal":{"name":"IPCC '88 Conference Record 'On the Edge: A Pacific Rim Conference on Professional Technical Communication'.","volume":"17 1","pages":"0"},"PeriodicalIF":0.0,"publicationDate":"1988-10-05","publicationTypes":"Journal Article","fieldsOfStudy":null,"isOpenAccess":false,"openAccessPdf":"","citationCount":null,"resultStr":null,"platform":"Semanticscholar","paperid":"123158041","PeriodicalName":null,"FirstCategoryId":null,"ListUrlMain":null,"RegionNum":0,"RegionCategory":"","ArticlePicture":[],"TitleCN":null,"AbstractTextCN":null,"PMCID":"","EPubDate":null,"PubModel":null,"JCR":null,"JCRName":null,"Score":null,"Total":0}
京公网安备 11010802042870号
京ICP备2023020795号-1
扫码关注我们
求助内容：
应助结果提醒方式：