Enhancing framework usability through smart documentation

This is an electronic version of the paper presented at the 3rd Argentine Symposium on Object Orientation (ASOO'99), held in Buenos Aires, ArgentinaIn this work we present SmartBooks, a new approach to support framework instantiation based on the active cookbook concept, extended with the combination of the concept of user-tasks modeling and least commitment planning methods. Based on this technique, a tool can present to the developer the different high level activities that can be carried out when creating a new application from a framework, taking as basis the documentation provided by the designer through instantiation rules. For each of these high level activities, there is a list of tasks that the user must carry out in order to complete the activity. When the user selects her next objective, the tool is able to build the sequence of tasks that have to be done to accomplish that objective: the instantiation plan; and the process of plan creation is named planning. In this paper we present the main characteristics of the planning approach and an example of the instantiation tool being developed

Pattern languages in HCI: A critical review

This article presents a critical review of patterns and pattern languages in human-computer interaction (HCI). In recent years, patterns and pattern languages have received considerable attention in HCI for their potential as a means for developing and communicating information and knowledge to support good design. This review examines the background to patterns and pattern languages in HCI, and seeks to locate pattern languages in relation to other approaches to interaction design. The review explores four key issues: What is a pattern? What is a pattern language? How are patterns and pattern languages used? and How are values reflected in the pattern-based approach to design? Following on from the review, a future research agenda is proposed for patterns and pattern languages in HCI

Redocumentation through design pattern recovery:: an investigation and an implementation

In this thesis, two methods are developed in an aid to help users capture valuable design information and knowledge and reuse them. They are the design pattern recovery (DPR) method and pattern-based redocumentation (PBR) method. The DPR method is for matching up metrics of patterns with patterns themselves in order to capture valuable design information. Patterns are used as a container for storing the information. Two new metrics, i.e., p-value and s-value are introduced. They are obtained by analysing product metrics statistically. Once patterns have been detected from a system, the system can be redocumented using these patterns. Some existing XML (extensible Markup Language) technologies are utilised in order to realise the PRB method. Next, a case study is carried out to validate the soundness and usefulness of the DPR method. Finally, some conclusions drawn from this research are summarised, and further work is suggested for the researchers in software engineering

Facilitated hypertext for collective sensemaking: 15 years on from gIBIS

Hypertext research in the mid-1980s on representing argumentation for design rationale (DR) foreshadowed what are now dominant concerns in knowledge management: representing, codifying and manipulating semiformal concepts, the use of formalisms to mediate collective sensemaking, and the construction of group memory. With the benefit of 15 years' hindsight, we can see the failure of so many DR systems to be adopted as symptomatic of the more general problem of fostering new kinds of 'literacy' in real working environments. Pursuing Engelbart's goal of "augmenting human intellect", we describe the Compendium approach to collective sensemaking, which demonstrates the impact that a facilitator can have on the learning and adoption problems that plagued earlier DR systems. We also describe how conventional documents and modelling notations can be morphed into and out of Compendium's 'native hypertext' in order to support other modes of working across diverse communities of practice

Programming patterns and development guidelines for Semantic Sensor Grids (SemSorGrid4Env)

The web of Linked Data holds great potential for the creation of semantic applications that can combine self-describing structured data from many sources including sensor networks. Such applications build upon the success of an earlier generation of 'rapidly developed' applications that utilised RESTful APIs. This deliverable details experience, best practice, and design patterns for developing high-level web-based APIs in support of semantic web applications and mashups for sensor grids. Its main contributions are a proposal for combining Linked Data with RESTful application development summarised through a set of design principles; and the application of these design principles to Semantic Sensor Grids through the development of a High-Level API for Observations. These are supported by implementations of the High-Level API for Observations in software, and example semantic mashups that utilise the API

Collaborative design : managing task interdependencies and multiple perspectives

This paper focuses on two characteristics of collaborative design with respect to cooperative work: the importance of work interdependencies linked to the nature of design problems; and the fundamental function of design cooperative work arrangement which is the confrontation and combination of perspectives. These two intrinsic characteristics of the design work stress specific cooperative processes: coordination processes in order to manage task interdependencies, establishment of common ground and negotiation mechanisms in order to manage the integration of multiple perspectives in design

Developing a design methodology for the construction of hypertext and hypermedia, with particular reference to hypertext electronic prospectuses

Use and development of hypertext-based documents is becoming more widespread in both industry and die academic world. This has obvious implications for the design of hypertext documents. The hypertext designer has been relatively ignored until recently, with attention largely focused on the quality of the hypertext rather than support for the designer. Recent hypertext design methodologies, such as that described by Isakowitz et al. (1995) have made a useful contribution, but are oriented towards designers with a background in computing science and related professions. This research addresses this problem by the development of a design methodology which is intended to be accessible to the general author. The design methodology was based on three sources of data: a taxonomy of existing design guidance, including a range of principles and guidelines and previous design methodologies for hypertext; hypertext versions of a higher education college prospectus, and a case study of a CD-ROM higher education prospectus. This material was assembled and synthesised to produce a provisional design methodology that is positioned between existing design methodologies such as Relationship Management Methodology (Isakowitz et al 1995) and Object-Oriented Hypermedia Design Method (Schwabe et al 1995), which are influenced by software engineering and database design concepts, and other less formal descriptions of the hypertext design process. The design methodology supports and encourages iterative methods of working, and includes supporting documentation and pro formas designed to encourage a thorough approach to hypertext design