liu.seSearch for publications in DiVA
Endre søk
RefereraExporteraLink to record
Permanent link

Direct link
Referera
Referensformat
  • apa
  • harvard1
  • ieee
  • modern-language-association-8th-edition
  • vancouver
  • oxford
  • Annet format
Fler format
Språk
  • de-DE
  • en-GB
  • en-US
  • fi-FI
  • nn-NO
  • nn-NB
  • sv-SE
  • Annet 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 (engelsk)Inngår i: Proceedings of IPCC/SIGDOC 2000, September 24 – 27, Cambridge, Massachusetts, IEEE , 2000, s. 497-508Konferansepaper, Publicerat paper (Fagfellevurdert)
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

sted, utgiver, år, opplag, sider
IEEE , 2000. s. 497-508
HSV kategori
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
Konferanse
2000 Joint IEEE International and 18th Annual Conference on Computer Documentation (IPCC/SIGDOC 2000) Professional Communication Conference, 24-27 September 2000, Cambridge, MA, UK
Tilgjengelig fra: 2002-10-20 Laget: 2002-10-20 Sist oppdatert: 2015-04-09
Inngår i avhandling
1. Library Communication Among Programmers Worldwide
Åpne denne publikasjonen i ny fane eller vindu >>Library Communication Among Programmers Worldwide
2002 (engelsk)Doktoravhandling, med artikler (Annet vitenskapelig)
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.

sted, utgiver, år, opplag, sider
Linköping: Linköping University Electronic Press, 2002. s. 199
Serie
Linköping Studies in Science and Technology. Dissertations, ISSN 0345-7524 ; 758
Emneord
software development, library-based programming, library communication, hypertext documentation, Open-source, bug handling, object-oriented programming
HSV kategori
Identifikatorer
urn:nbn:se:liu:diva-4982 (URN)91-737-3349-0 (ISBN)
Disputas
2002-09-27, Visionen, Hus B, Campus Valla, Linköpings universitet, Linköping, 13:15 (engelsk)
Veileder
Merknad
On the day of the public defence the title of article I was: Designing Electronic Library Reference Documentation.Tilgjengelig fra: 2002-10-20 Laget: 2002-10-20 Sist oppdatert: 2018-01-13bibliografisk kontrollert

Open Access i DiVA

Fulltekst mangler i DiVA

Andre lenker

Forlagets fulltekstLink to articleLink to Ph.D. Thesis

Personposter BETA

Berglund, Erik

Søk i DiVA

Av forfatter/redaktør
Berglund, Erik
Av organisasjonen

Søk utenfor DiVA

GoogleGoogle Scholar

doi
isbn
urn-nbn

Altmetric

doi
isbn
urn-nbn
Totalt: 143 treff
RefereraExporteraLink to record
Permanent link

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