• 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