{"title":"DITA案例研究:服务学习、软件文档和重新设计","authors":"D. A. Edgell","doi":"10.1109/IPCC.2008.4610201","DOIUrl":null,"url":null,"abstract":"As a service-learning project in a graduate level technical communication class on technical manuals, Dr. Brian Still found an open-source software developer in Germany who needed documentation for his application. The class looked at various approaches to fulfilling the developerpsilas needs including wikis, Darwin Information Typing Architecture (DITA), XML, usability testing, and software mapping. This paper touches on the successes and challenges of the project and examines the potential for using DITA as a solution for reconstructing existing documentation.","PeriodicalId":131068,"journal":{"name":"2008 IEEE International Professional Communication Conference","volume":"27 1","pages":"0"},"PeriodicalIF":0.0000,"publicationDate":"2008-07-13","publicationTypes":"Journal Article","fieldsOfStudy":null,"isOpenAccess":false,"openAccessPdf":"","citationCount":"3","resultStr":"{\"title\":\"A DITA case study: Service learning, software documentation, and redesign\",\"authors\":\"D. A. Edgell\",\"doi\":\"10.1109/IPCC.2008.4610201\",\"DOIUrl\":null,\"url\":null,\"abstract\":\"As a service-learning project in a graduate level technical communication class on technical manuals, Dr. Brian Still found an open-source software developer in Germany who needed documentation for his application. The class looked at various approaches to fulfilling the developerpsilas needs including wikis, Darwin Information Typing Architecture (DITA), XML, usability testing, and software mapping. This paper touches on the successes and challenges of the project and examines the potential for using DITA as a solution for reconstructing existing documentation.\",\"PeriodicalId\":131068,\"journal\":{\"name\":\"2008 IEEE International Professional Communication Conference\",\"volume\":\"27 1\",\"pages\":\"0\"},\"PeriodicalIF\":0.0000,\"publicationDate\":\"2008-07-13\",\"publicationTypes\":\"Journal Article\",\"fieldsOfStudy\":null,\"isOpenAccess\":false,\"openAccessPdf\":\"\",\"citationCount\":\"3\",\"resultStr\":null,\"platform\":\"Semanticscholar\",\"paperid\":null,\"PeriodicalName\":\"2008 IEEE International Professional Communication Conference\",\"FirstCategoryId\":\"1085\",\"ListUrlMain\":\"https://doi.org/10.1109/IPCC.2008.4610201\",\"RegionNum\":0,\"RegionCategory\":null,\"ArticlePicture\":[],\"TitleCN\":null,\"AbstractTextCN\":null,\"PMCID\":null,\"EPubDate\":\"\",\"PubModel\":\"\",\"JCR\":\"\",\"JCRName\":\"\",\"Score\":null,\"Total\":0}","platform":"Semanticscholar","paperid":null,"PeriodicalName":"2008 IEEE International Professional Communication Conference","FirstCategoryId":"1085","ListUrlMain":"https://doi.org/10.1109/IPCC.2008.4610201","RegionNum":0,"RegionCategory":null,"ArticlePicture":[],"TitleCN":null,"AbstractTextCN":null,"PMCID":null,"EPubDate":"","PubModel":"","JCR":"","JCRName":"","Score":null,"Total":0}
引用次数: 3
摘要
作为研究生水平的技术交流课程中的一个服务学习项目,Brian Still博士在德国找到了一位开源软件开发人员,他需要为他的应用程序提供文档。本课程探讨了满足开发人员需求的各种方法,包括wiki、Darwin Information Typing Architecture (DITA)、XML、可用性测试和软件映射。本文讨论了该项目的成功和挑战,并探讨了使用DITA作为重建现有文档的解决方案的可能性。
A DITA case study: Service learning, software documentation, and redesign
As a service-learning project in a graduate level technical communication class on technical manuals, Dr. Brian Still found an open-source software developer in Germany who needed documentation for his application. The class looked at various approaches to fulfilling the developerpsilas needs including wikis, Darwin Information Typing Architecture (DITA), XML, usability testing, and software mapping. This paper touches on the successes and challenges of the project and examines the potential for using DITA as a solution for reconstructing existing documentation.