Citation

Ho, Sin Ban and Chuie, Hong Tan and Chai, Ian (2004) An empirical investigation for different sequences of pedagogical framework documentation in RAD. Proceedings of the IASTED Conference on Software Engineering and Applications, 2004. pp. 253-258. ISSN 1482-7905

Text An empirical investigation for different sequences of pedagogical framework documentation in RAD.pdf Restricted to Repository staff only Download (46kB)

Abstract

Frameworks are increasingly employed as a useful way to enable object-oriented reuse. However, their size and complexity make understanding how to use them difficult. Previous work concentrated on different ways to document frameworks, but it was unclear which ones actually were better. This paper presents a novel way of investigating the sequences of three philosophies for new framework documentation. Step-by-step documentation is the one traditionally used for software documentation. This philosophy gives clear and sequential steps so that people can follow them and learn how to do the task. Minimalist documentation is random-access so that the reader can proceed in a self-directed manner, and promotes using small cards or pages that can be read in the order the reader desires. Patterns centres upon the idea of giving the solution to a problem in its context. It also has the random-access idea of minimalist documentation, but disagrees with it in that contextual information is not minimal - it usually contains information other than what needs to be done. This investigation discovered some guidelines for effective framework documentation, particularly in a Rapid Application Development (RAD) environment. The results suggest that different documentation sequences are better for different goals

Item Type:	Article
Subjects:	T Technology > T Technology (General)
Depositing User:	Ms Suzilawati Abu Samah
Date Deposited:	13 Dec 2013 02:02
Last Modified:	13 Dec 2013 02:02
URII:	http://shdl.mmu.edu.my/id/eprint/4577

Downloads

Edit (login required)