The Computer Journal
The Nurnberg funnel: designing minimalist instruction for practical computer skill
The Nurnberg funnel: designing minimalist instruction for practical computer skill
A hypertext system for literate C++ programming
Journal of Object-Oriented Programming
Making use: a design representation
Communications of the ACM
Lightweight lexical source model extraction
ACM Transactions on Software Engineering and Methodology (TOSEM)
Referential integrity of links in open hypermedia systems
Proceedings of the ninth ACM conference on Hypertext and hypermedia : links, objects, time and space---structure in hypermedia systems: links, objects, time and space---structure in hypermedia systems
JavaML: a markup language for Java source code
Proceedings of the 9th international World Wide Web conference on Computer networks : the international journal of computer and telecommunications netowrking
Elucidative programming in Java
IPCC/SIGDOC '00 Proceedings of IEEE professional communication society international professional communication conference and Proceedings of the 18th annual ACM international conference on Computer documentation: technology & teamwork
GNU EMACS Manual
Java Language Specification, Second Edition: The Java Series
Java Language Specification, Second Edition: The Java Series
Literate Programming Simplified
IEEE Software
Nordic Journal of Computing
Documentation threads - presentation of fragmented documentation
Nordic Journal of Computing
Minimalist Documentation of Frameworks
Proceedings of the Workshop on Object-Oriented Technology
Nordic Journal of Computing
WPC '97 Proceedings of the 5th International Workshop on Program Comprehension (WPC '97)
Requirements for an Elucidative Programming Environment
IWPC '00 Proceedings of the 8th International Workshop on Program Comprehension
Aspects of Internal Program Documentation " An Elucidative Perspective
IWPC '02 Proceedings of the 10th International Workshop on Program Comprehension
The WEB system of structured documentation
The WEB system of structured documentation
Nordic Journal of Computing
Elucidative Programming in open integrated development environments for Java
PPPJ '03 Proceedings of the 2nd international conference on Principles and practice of programming in Java
Maintaining program understanding: issues, tools, and future directions
Nordic Journal of Computing
Hi-index | 0.00 |
In this paper we present a tool for creating elucidative program tutorials. An elucidative program tutorial explains a program through textual explanations that address relevant places in a program by using hyperlinks or by in-lining fragments of the program in the tutorial text. We present a means for specifying the fragments of a program that are to be in-lined in the tutorial text. These in-line fragments are defined by addressing named syntactical elements, such as classes and methods, but it is also possible to address individual code lines. The fragment specifications help maintaining consistency between the program tutorial and the program. The tool also detects when a program tutorial is addressing program fragments that do not exist. The program tutorials are presented in a web-browser where navigation is provided to other documents such as reference manuals, other tutorials, and to presentations of source code fragments in their original context. We have produced three example program tutorials in order to get some experience with the tool, and we see potential in using the tool to produce program tutorials for frameworks, libraries, and for use in educational contexts.