Beyond Generated Software Documentation – A Web 2.0 Perspective

PDF

Authors
  1. Schugeri, P.
  2. Rilling, J.
  3. Charland, P.
Corporate Authors
Defence R&D Canada - Valcartier, Valcartier QUE (CAN)
Abstract
Over the last decades, software engineering processes have constantly evolved to reflect cultural, social, technological, and organizational changes, which are often a direct result of the Internet. The introduction of the Web 2.0 resulted in further changes, creating an interactive and community driven platform. However, these ongoing changes have yet to be reflected in the way we document software system's. Documentation generators, like Doxygen and its derivatives (Javadoc, Natural Docs, etc.) have become the de facto industry standards for creating external technical software documentation from source code. However, the interwoven representation of source code and documentation within a source code editor limits the ability of these approaches to provide rich media, internationalization, and interactive content. In this paper, we combine the functionality of a web browser with a source code editor to provide source code documentation with rich media content. The paper presents our fully functional implementation of the editor within the Eclipse framework.
Report Number
DRDC-VALCARTIER-SL-2009-237 — Scientific Literature
Date of publication
01 Oct 2009
Number of Pages
4
DSTKIM No
CA033292
CANDIS No
532580
Format(s):
Document Image stored on Optical Disk

Permanent link

Document 1 of 1

Date modified: