liu.seSök publikationer i DiVA
Ändra sökning
RefereraExporteraLänk till posten
Permanent länk

Direktlänk
Referera
Referensformat
  • apa
  • harvard1
  • ieee
  • modern-language-association-8th-edition
  • vancouver
  • oxford
  • Annat format
Fler format
Språk
  • de-DE
  • en-GB
  • en-US
  • fi-FI
  • nn-NO
  • nn-NB
  • sv-SE
  • Annat språk
Fler språk
Utmatningsformat
  • html
  • text
  • asciidoc
  • rtf
Writing for Adaptable Documentation
Linköpings universitet, Institutionen för datavetenskap, MDALAB - Human Computer Interfaces. Linköpings universitet, Tekniska högskolan.
2000 (Engelska)Ingår i: Proceedings of IPCC/SIGDOC 2000, September 24 – 27, Cambridge, Massachusetts, IEEE , 2000, s. 497-508Konferensbidrag, Publicerat paper (Refereegranskat)
Abstract [en]

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

Ort, förlag, år, upplaga, sidor
IEEE , 2000. s. 497-508
Nationell ämneskategori
Teknik och teknologier
Identifikatorer
URN: urn:nbn:se:liu:diva-13493DOI: 10.1109/IPCC.2000.887306ISBN: 0-7803-6431-7 (tryckt)OAI: oai:DiVA.org:liu-13493DiVA, id: diva2:20861
Konferens
2000 Joint IEEE International and 18th Annual Conference on Computer Documentation (IPCC/SIGDOC 2000) Professional Communication Conference, 24-27 September 2000, Cambridge, MA, UK
Tillgänglig från: 2002-10-20 Skapad: 2002-10-20 Senast uppdaterad: 2015-04-09
Ingår i avhandling
1. Library Communication Among Programmers Worldwide
Öppna denna publikation i ny flik eller fönster >>Library Communication Among Programmers Worldwide
2002 (Engelska)Doktorsavhandling, sammanläggning (Övrigt vetenskapligt)
Abstract [en]

Programmers worldwide share components and jointly develop components on a global scale in contemporary software development. An important aspect of such library-based programming is the need for technical communication with regard to libraries – library communication. As part of their work, programmers must discover, study, and learn as well as debate problems and future development. In this sense, the electronic, networked media has fundamentally changed programming by providing new mechanisms for communication and global interaction through global networks such as the Internet. Today, the baseline for library communication is hypertext documentation. Improvements in quality, efficiency, cost and frustration of the programming activity can be expected by further developments in the electronic aspects of library communication.

This thesis addresses the use of the electronic networked medium in the activity of library communication and aims to discover design knowledge for communication tools and processes directed towards this particular area. A model of library communication is provided that describes interaction among programmer as webs of interrelated library communities. A discussion of electronic, networked tools and processes that match such a model is also provided. Furthermore, research results are provided from the design and industrial valuation

of electronic reference documentation for the Java domain. Surprisingly, the evaluation did not support individual adaptation (personalization). Furthermore, global library communication processes have been studied in relation to open-source documentation and user-related bug handling. Open-source documentation projects are still relatively uncommon even in open-source software projects. User-related Open-source does not address the passive behavior users have towards bugs. Finally, the adaptive authoring process in electronic reference documentation is addressed and found to provide limited support for expressing the electronic, networked dimensions of authoring requiring programming skill by technical writers.

Library communication is addressed here by providing engineering knowledge with regards to the construction of practical electronic, networked tools and processes in the area. Much of the work has been performed in relation to Java library communication and therefore the thesis has particular relevancefor the object-oriented programming domain. A practical contribution of the work is the DJavadoc tool that contributes to the development of reference documentation by providing adaptive Java reference documentation.

Ort, förlag, år, upplaga, sidor
Linköping: Linköping University Electronic Press, 2002. s. 199
Serie
Linköping Studies in Science and Technology. Dissertations, ISSN 0345-7524 ; 758
Nyckelord
software development, library-based programming, library communication, hypertext documentation, Open-source, bug handling, object-oriented programming
Nationell ämneskategori
Datavetenskap (datalogi)
Identifikatorer
urn:nbn:se:liu:diva-4982 (URN)91-737-3349-0 (ISBN)
Disputation
2002-09-27, Visionen, Hus B, Campus Valla, Linköpings universitet, Linköping, 13:15 (Engelska)
Handledare
Anmärkning
On the day of the public defence the title of article I was: Designing Electronic Library Reference Documentation.Tillgänglig från: 2002-10-20 Skapad: 2002-10-20 Senast uppdaterad: 2018-01-13Bibliografiskt granskad

Open Access i DiVA

Fulltext saknas i DiVA

Övriga länkar

Förlagets fulltextLink to articleLink to Ph.D. Thesis

Personposter BETA

Berglund, Erik

Sök vidare i DiVA

Av författaren/redaktören
Berglund, Erik
Av organisationen
MDALAB - Human Computer InterfacesTekniska högskolan
Teknik och teknologier

Sök vidare utanför DiVA

GoogleGoogle Scholar

doi
isbn
urn-nbn

Altmetricpoäng

doi
isbn
urn-nbn
Totalt: 139 träffar
RefereraExporteraLänk till posten
Permanent länk

Direktlänk
Referera
Referensformat
  • apa
  • harvard1
  • ieee
  • modern-language-association-8th-edition
  • vancouver
  • oxford
  • Annat format
Fler format
Språk
  • de-DE
  • en-GB
  • en-US
  • fi-FI
  • nn-NO
  • nn-NB
  • sv-SE
  • Annat språk
Fler språk
Utmatningsformat
  • html
  • text
  • asciidoc
  • rtf