DocumentCode :
2677630
Title :
Writing for adaptable documentation
Author :
Berglund, Erik
Author_Institution :
Dept. of Comput. & Inf. Sci., Linkoping Univ., Sweden
fYear :
2000
fDate :
2000
Firstpage :
497
Lastpage :
508
Abstract :
The rapid development of reusable software components results in an information overload problem in the development process. Software developers must read large amounts of documentation. Adaptive documentation is one way to address this problem and support efficient reading. However, in our view, adaptive documentation requires a writing process that delivers the pedagogical strategies for adaptivity. The article takes a stance in a project on adaptive software reference documentation and discusses the requirements on writing. It also discusses writing trends and Web languages in relation to adaptivity. It is concluded that describing change in documentation is not supported on an authoring level but rather on a programming level
Keywords :
adaptive systems; information resources; programming; software quality; system documentation; Web languages; adaptable documentation; adaptive documentation; adaptive software reference documentation; authoring level; development process; information overload problem; pedagogical strategies; programming level; rapid development; reusable software components; software developers; writing process; writing trends; Collaboration; Documentation; Humans; Information science; Java; Programming; Software libraries; Software reusability; Standards development; Writing;
fLanguage :
English
Publisher :
ieee
Conference_Titel :
Professional Communication Conference, 2000. Proceedings of 2000 Joint IEEE International and 18th Annual Conference on Computer Documentation (IPCC/SIGDOC 2000)
Conference_Location :
Cambridge, MA
Print_ISBN :
0-7803-6431-7
Type :
conf
DOI :
10.1109/IPCC.2000.887306
Filename :
887306
Link To Document :
بازگشت