Title :
A DITA case study: Service learning, software documentation, and redesign
Author :
Edgell, David A.
Author_Institution :
Texas Tech Univ., TX
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.
Keywords :
XML; computer science education; educational courses; public domain software; system documentation; user manuals; DITA case study; Darwin Information Typing Architecture; XML; application documentation; graduate level technical communication class; open-source software development; service learning project; software documentation; software mapping; technical manual; usability testing; wikis;
Conference_Titel :
Professional Communication Conference, 2008. IPCC 2008. IEEE International
Conference_Location :
Montreal, QC
Print_ISBN :
978-1-4244-2085-8
DOI :
10.1109/IPCC.2008.4610201