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