Interactive documentation

Brown, Peter J.

doi:10.1002/spe.4380160309

Cited by 28 publications

(6 citation statements)

References 5 publications

Supporting

Mentioning

Contrasting

Order By: Relevance

“…Most hypermedia systems, however, provide point-to-node links. For example, Guide (Brown 1986) provides links from any piece of text. It is also possible for some systems to provide point-to-point links.…”

Section: Link Typesmentioning

confidence: 99%

Multimedia information retrieval

2010

Choice Reviews Online

View full text Add to dashboard Cite

show abstract

Section: Link Typesmentioning

confidence: 99%

Multimedia information retrieval

2010

Choice Reviews Online

View full text Add to dashboard Cite

show abstract

“…sity of Durham, research is in progress on how to redocumen; software systems within the GUIDE [2] hypertext documentation tool running on a Sun Workstation. The investigation is being performed by redocumenting a C cross-referencing program developed at the British Telecom Research Laboratories as part of the DOCMAN [6] suite of cross-referencing tools.…”

Section: Research Direct Ionsmentioning

confidence: 99%

Redocumenting software systems using hypertext technology

Fletton

Munro²

1988

Proceedings. Conference on Software Maintenance, 1988.

View full text Add to dashboard Cite

Software maintenance is a perennial problem that will be with us for many years. This view is confirmed by the number, of existing Software systems that require maintaining and thdr predicted lifespan. The majority of software maintenance activity is performed on systems that are poorly documented and were built without the benefit of modern design practices. When working on such systems it is often useful to record knowledge gained about the system from examination of the source code. This knowledge can then be used by other, perhaps less experienced programmers, working in the same area or by the original programmer when working in the same area at a later date. This paper discusses the importance of documentation in the maintenance phase and proposes a tool based on hypertext technology that can meet a number of the documentation needs of the maintenance programmer. The Software Maintenance ProblemThe phrase 'software maintenance' has been defined in varying ways by many people. Any disagreement usually occurs on the number of activities that the term encompasses. I shall use a broad definition given by Foster [5].Software maintenance is the set of activities associated with keeping operational software in tune with the requirements of its users and operators, and of all other people and systems with which the operational system interacts.Within the software industry an awareness of the significance of software maintenance as an activity that deserves specific attention is growing. This awareness can be attributed to a small group of academic and industrial guru's who over the %ponsored by British Telecom Research Laboratories for a one year Research MSc in Software Redocumentation at the University of Durham.

show abstract

“…An important issue is whether this type of index is suftlcient to make the Hypertext system easier and more efficient to use. "If the computer systems simply initiates paper, readers will, if they have the choice, always prefer paper" [18]. Previous~search has indicated that, in technical documentation, readers rely most heavily on the index to help them fmd information [5], [19].…”

Section: Indexmentioning

confidence: 99%