EL.SEVIER
Computers in Industry 29 (1996) 27-35
Engineering design notebook for sharing and reuse Jack Hong
*, George
Toye, Larry J. Leifer
Centerfor Design Research, Stanford University, 560 Panama St., Stanford, CA 943052232, USA
Abstract The concept of an electronic or digital engineering
design notebook used by designers to capture information for reuse PENS (Personal Electronic Notebook with Sharing) responds to observed designers’ needs for a lightweight tool that is facile enough to compete with paper notebooks in functionality. Each time informal design notes are entered in PENS, a project information web automatically grows. As it grows, selections can be incrementally shared with collaborators over the Internet’s World-Wide Web (WWW>. In an era where both network security concerns and distributed collaboration demands are growing together, PENS has the capability for information sharing that is independent of security firewalls. To evaluate the utility of the PENS notebook concept, a prototype was developed and used by 14 mechanical engineering design teams, many of which were composed of geographically distributed team members.
and sharing is becoming reality in many different flavors. Our development of
Keywords: Electronic notebook; Informal work, Concurrent engineering: World-wide
knowledge capture; web; Internet
Distance
1. Introduction The SHARE 111 project at Stanford University is actively developing and assessing tools and services to enhance the design process for distributed collaborating engineering teams. The unifying SHARE vision is one in which distributed engineers individually collect design infonnation, and share it over the Internet via electronic notebooks. While paper may still be best for pers’onal notes, electronic notes are vastly superior for sharing and reuse. Electronically captured design data can be quickly modified and reused in simulatiom and analysis. By building on top of the Internet infrastructure, we gain world-wide access and an open system architecture. Unfortunately, existing notebook products have
’ Corresponding
author. Email:
[email protected]
0166-3615/96/$15.00 0 1996 Elsevier Science B.V. All rights reserved SSDI 0166-3615(95)00052-6
collaboration;
Virtual teams; Computer-supported
collaborative
met with limited success in the engineering domain. Electronic design notebooks from the research community require continuous network connectivity [2,3], require specialized (expensive) workstations [41, and are not usable in meetings or outside the office. They are rarely tested across an extended product development cycle and focus on proprietary systems with uncertain prospects for scaling up beyond the original testbed. This factor makes it difficult to transfer the innovations from academia to industry. As a development strategy, we believe that collaboration environments must be iteratively used, redesigned and improved. Designers must be engaged with real time pressures that are encountered in an extended product design cycle. In this paper, we present the technology behind our PENS (Personal Electronic Notebook with Sharing) prototype, and how it has been deployed in a live engineering testbed. By building it on top of the Internet’s popu-
2s
J. Hong et al. /Computers
lar World-Wide Web, PENS was immediately accessible to testbed participants across the country with minimal infrastructure investment. Using a combination of quantitative and qualitative data collected from our distributed testbed, we concretely examine our assumptions on tools design, and outline plans for further development.
in Industry 29 (19961 27-35 Table 1 Comparison of discourse-based vs. reflection-based tools Collaborative knowledge consists of both information generated during collective discourse and individual reflection. E-mail and conversations are conventional vehicles for discourse, while paper notebooks are used for reflection. PENS fills the niche for reflective knowledge in electronic collaboration. Attributes\media
type
Primary audience Native tendency
2. Knowledge capture in collaborative design
engineering
It is the custom in industry to conserve engineering knowledge through formal documentation. Though this benefits redesign across generations of engineering teams, individual engineers often consider immediate benefits of documentation too small to justify the required effort. Consequently, documentation is treated as a necessary evil to be done after the fact, once finer points of decisions and rationale have eroded from memory. While some engineers have such details written down informally in meeting notes and notebook entries, these tend to be personal accounts which are physically difficult to share with colleagues during the course of design. In a survey of existing computer-supported collaboration tools, we observed that most information exchange mechanisms are built on a metaphor of active discourse. Designers in a virtual co-located meeting scenario may use shared white boards, IRC (Internet Relay Chat), e-mail or usenet newsgroups to actively enter into synchronous and asynchronous conversation threads. These tools allow one to extend meetings over space, time and offer opportunities to record ongoing discourse. However, as engineers know, meetings are only one part of teamwork. In fact, a significant portion of teamwork occurs in parallel outside of conference rooms. Indeed, the strategy of concurrent engineering is to gain lead time by minimizing sequential dependencies and maximizing parallel task flows. To be effective in an engineering team, it is equally important to be aware of parallel tasks without engaging in prolonged discussions. This mode of informal sharing is exhibited when teammates peek into one another’s offices, look over another person’s shoulder while they work, or ask one another, “What are you working on?”
Analog examples Internet examples
2.1. The importance work
Discourse-based
Reflection-based
others shared but not recorded conversations e-mail
self recorded but not shared personal notes
of monologues
FENS
in collaborative
In contrast with the discourse-based nature of meetings and conversations, we introduce the notion of rejlection-based information to characterize knowledge generated on a individual basis, as contrasted in Table 1. Discourse-based information transpires in the course of communicating with others, in conversations. While it is possible to record conversations, the inherent purpose is to exchange information and negotiate rather than archive. Conversely, reflection-based information is primarily intended for the individual. While it is possible to share reflection-based information, it takes extra effort over its intended purpose of recording and facilitating thought. For effective collaboration, we propose that it is essential to integrate both knowledge generated collectively, as well as knowledge generated on an individual basis, with ratios of these modes of capture variable with respect to domain and project phase.
3. PENS: Personal Electronic Notebook with Sharing On its own, a paper notebook is little more than a bound collection of paper. Used as an informal engineering support tool, however, it becomes an extended memory of design process and rationale. PENS has been designed with the paper notebook in mind, and is first and foremost a recording tool for
J. Hong et al. / Computers in Industry 29 (1996127-35
the individual. To support ubiquitous note taking with the understandmg that one takes notes almost anywhere, our first PENS prototype has been designed for the mobile designer who uses a low-cost, portable Macintosh computer. As with any paper notebook, a designer with a notebook computer can take PENS to site visits, vendors, meetings or working sessions, and take notes on pricing, planning, action items, or any other relevant activities. To compete with a paper notebook, it is important to support agile browsing of note pages. The PENS note interface, shown in Fig. 1, has been designed to support quick data entry and browsing between notes.On a single 640 X 480 pixel screen, the user is able to see not only the note, but titles of adjacent notes, and the top-level category under which that note is classified. Shifting between categories is accomplished via mouse click or the left/right arrow keys. The up/down arrow keys cycle through notes within a single category. Automatic time stamping
29
provided for a historical perspective on the design notes. This has been revealed to be a significant need in prior research in electronic notebooks [4]. PENS steps beyond the paper notebook when the user decides to share its contents. Upon returning to the office, home, or any other place with a connection to the Internet (via AppleTalk or modem), a single button-push allows both contents and structure of this individual notebook to be woven onto a group notebook located on the World-Wide Web-the shared equivalent of Fig. 1 is shown in Fig. 2. This allows all team members, managers or trainees who have been given access, to view the complete set of all project notes via any Web-browser from anywhere on the Internet, whether or not they are PENS users. The concept of structure-mirroring is important. PENSgoes beyond the simple sharing of a piece meal document to support sharing of a full network of documents and their semantic relationships. Each
Outline About SHAREing Notebook: SECOND
Fourth
WET Uorkshop
IEEE
Infrastructure
for Apri
Berkeley The
Concurrent
University,
Engineering with
support
from
in
1995,
Berkeley
cooperation workshop). The workshop collaboration to
healthcare.
development, collaboration
ICE on 20-22,
Springs,
Research
sponsorship
‘95 Enabling 1995
Center
from
the
olt
the
Cool
of
RCIl
font
West (RCtl
cloal is to in diverse Papers
Resort,
Uirginia.
SIGOIS
IEEE
focus on application reporting
clnd applications are sought in
survey,
Virginia
Society
Center,
have
and
original
and
applied
cooperation
infrastructural domains,
of enabling the following
West
Workshop on Enabling Enterprises on
Conference their
Acknowlegementa at
Computer
We also lent
Uirginia
(CERC)
will conduct the Fourth Infrastructure for Collaborative
Springs,
Enterprises
West
[
ME2 10 Testbed Usage Data Future Work
Technologies:
Collaborative
I
WWW as a Collaborative PENS Design Consideration
FOR PAPERS
RIRRI,
Technologies: 20-22,
CRLL
for to
last
Rpril
Health
Spa
the year’s
issues related to ranging from engineering research,
technologies areas:
design
and
for
Fig. 1. The FENSnote interface. The first FENSprototype has four top-level categories for note classification, automatic time-stamping, listing of all files in the current category, displayed concurrently with the current note. Once the ‘POST’ button is pressed, changes current notebook are translated into HTh4L and then transmitted to a pre-designated Web server.
and a in the
30 PENS notebook contains notes organized in sequence and categories specified by the author. When sharing these notes with a larger audience, this structure is mirrored on the Web, but also systematically woven into the group network of notes.
3.1. PENS client-server
architecture
Technically speaking, PENS is a custom off-line WWW authoring application that consists of both client and server software components. 3.1.1. Client sofhvare The PENS client is a custom HyperCard stack with embedded TCP/IP code for handling file transmission. A PENS author takes notes in predefined note templates, shown previously in Fig. 1. When a ‘POST’ command is invoked, PENS looks only at notes which have been updated since the last posting, carefully translates each new note into an HTML document, and packages these notes into a single MIME message. This packaged message includes master index files as well as directory depositing
PENS
Client
\:
PENSIWWW
Server
Fig. 3. Flow diagram of PENS transport mechanism. When the ‘POST’ button is pushed, the PENS client generates a new index file and integrates with other new note files to create a composite MIME (Multi-media Mail Extension) tile for transmission. Upon receipt, the server-side PENS code separates the original MIME message into multiple parts and deposits them into appropriate directories.
information. A TCP/IP connection is then opened to an SMTP (Simple Mail Transport Protocol) server, and this MIME message is transferred to a predesignated mail account for processing by the PENS/WWW server, as depicted in Fig. 3. By using an e-mail transport mechanism, the encapsulated PENS notes package easily passes through network security firewalls and other e-mail gateways. This facilitates cross-industry information sharing crucial to the dynamic partnership requirements of multinational cor-
Fig. 2. WWW version of the PENS note shown in Fig. 1. Once the ‘POST’ operation is completed, the server-side masl ter group index file and deposits all new notes in a pre-defined notebook area on the Web server.
PENS code updates the
31
J. Hong et al./ Computersin Industry29 (1996) 27-35
porations. Collaboration servers can easily be set up for the project duration, with no need for significant changes in tbe legacy information infrastructures of partner companies. 3.1.2. PENS server The PENS server code co-resides on a machine with a functioning World-Wide Web server. The PENS notes package is received by an automated mail-handling account and serviced by the PENS server, implemented1 using ServiceMailTM 111 with custom TCL scripts. This PENS ServiceMail application looks at the subject header of the mail message, and determines (upon acceptance) where to deposit the set of PENS elem’ents as files. It then decomposes the package into individual HTML files for access on the World-Wide Web. After separating and depositing these files.. it launches a post-processing program which ‘weaves’ the new index into the existing group index. A mail message is optionally sent back to the PENS author, notifying acceptance and completion of the posting. 3.1.3. Administration The PENS server code determines where PENS files are to be deposited on the World-Wide Web server, so that distinct personal and group spaces are maintained. User authentication is implemented via custom group names, login and password scheme which does not require establishment of individual UNIX accounts. For the PENS user, these settings are specified in the preferences card on the PENS Client, shown in Fig. 4. Because the shared contents are located on the Web server, all Web access security and privacy mechanisms are inherited. In our testbed environment, e-mail and HyperMail [5] are used for discourse-based information, while PENS has been introduced to provide a forum for reflection-based infomrrnation. The inclusion of reflection-based information allows us to recreate circumstances of incidental knowledge transfer in a virtual team. What would have been learned in a co-located office by ‘dropping by’ a colleague’s desk can now be glimpsed from the master PENS index for the group. With PENS, we attempt to recreate the informal knowledge sharing environment of an open studio, or a ‘virtual design loft’. How effective this mechanism works can only be determined through
21OWebSettings mstrr tit* foryawnotn: Jrk’r WWW Gwalopmdnt Notea W*Lop*,nm
Pwrrwd
jhpnO/
( .-.
T*rrn Nrn L SlIRRE
I
v
Fig. 4. Preferences card for PENS client. Specific user login, password and group information is specified on the PENS client. This determines server transmission privileges and destination.
empirical testing. The following sections give some background on our testbed and describes how PENS has been deployed.
4. A distributed
engineering
design testbed
for
PENS
ME210: Mechatronic Systems Design, is a graduate-level engineering design class offered by Stanford University’s Department of Mechanical Engineering. Each year, ME210 provides an environment for 14 + three-person teams to tackle a wide range of industry sponsored projects. The educational goal of the course is to create a shared learning experience in collaborative mechatronic product design and development. Each student team benefits directly from working on a unique industry-sponsored project with a $10,000 design/fabrication budget, and indirectly from the design experiences of peer project teams. In Autumn 1994, ME210 took on tbe additional challenge of being offered concurrently to both traditional on-campus students and off-campus Honors Co-op students through Stanford’s Instructional Television Network (SITN). This resulted in a hybrid class of local and remote students. Based on different
J. Hong et al. / Computers in Industry 29 (1996) 27-35
32
communication needs and life-styles, four classes of students are identified in Table 2 below: Traditional students who live in the dormitories; traditional students who commute; SITN students in the San Francisco Bay Area; and out-of-state SITN students. In this distributed environment, paper-based communications no longer reached the whole class in a timely fashion. Consequently, we moved to a completely Web-mediated classroom infrastructure. While precedents exist for the support of Webmediated classrooms in distance education, they tend to be didactic lecture courses [6], and the deliverables are non-physical pieces of information. Resembling an engineering consultancy more than a lecture hall, ME210 defies the convention of typical classrooms. In the ME210 environment, students teams, typically not facile with Internet technology, manage a real budget while working on real industry problems, specifying, fabricating and delivering tangible artifacts with both co-located and non-co-located partners. The one distinguishing difference between our student teams and industry engineering teams is that immediate market pressure is replaced with an even more rigid academic time line - there is no slippage allowed. It is exactly this close parallel to
industry settings that makes ME210 a superior testbed for PENS. To exercise the vision of an ubiquitous electronic notebook, each ME210 student is asked to use a Macintosh Duo 2 10 as their design notebook. Among other tools, this computer has Eudora [7], Netscape Navigator [8], and PENS on board with MacTCP [9], and MacSLIP [lo] for off-campus students. Each project team has its own home page under the ME2 10 class Web. Each project home page has links to a group HyperMail archive, individual PENS notebook spaces and a master PENS index page for the group notebook. For confidentiality purposes, access to these pages are restricted to the Stanford campus network, except for remote students, coaches and sponsors who also have access to the World-Wide Web.
5. Testbed results In 20 weeks of deployment between November ‘94 and April ‘95, close to 700 PENS postings were logged by the PENS server. Plotting the distribution of these postings by project team, we find that three
Table 2 Overview of ‘hybrid’ design teams in ME210, academic year 1994-95 Engineering teams were composed of both traditional and honors co-op students. The highlighted most heavy users of PENS. Team name
Traditional dorm
GM-Window FMC GM-Door Lockheed Raychem Redwood Ford Pfizer Quantum Seiko 3M HP
1 1 3 2 2 1 2 2 2 2 2 3
students
SF Bay Area
2 2 1 1 1 1 1
1
23
out-of-state
9
Remote sponsor? (default is yes)
3 (CMU)
n n 1 1 2 1
JPL Total
Television students
commuters
teams were remote partnerships
n
4 (Mass.) 1 (Oregon)
n
2 8
8
48 [students]
and the
J. Hong et al. / Computers
in Industry
29 (1996) 27-35
120
60
Teams Fig. 5. Total number of ENS postings for each ME210 project team. More than 700 PENS postings were made over a 20 week test period. Leading adopters are plotted in dark gray. The HP team was completely remote and did not have access to PENS.
Number of Posts
Fig. 6. PENS posting history for a single ME210 project team. Internal PENS posting history for the Pfizer team shows most contributions being made by a single member during the first two weeks, with sporadic use by other team members.
34
J. Hong et al. / Computers in Industry 29 (1996) 27-35
teams have made far greater numbers of PENS postings than others, as shown in Fig. 5, contributing to 70% of the total postings. Two of these teams are widely distributed. Members of the JPL project team are all remote SITN students distributed in Oregon and California, while FMC project members are distributed between Stanford University in California and Carnegie Mellon University in Pennsylvania. The internal PENS posting history of the Pfizer team is plotted in Fig. 6. This distribution reveals that most of the postings for this team are contributed by a single team member (b) in the first few weeks, while few postings were made by members (d) and (a). Internal plots for the two previous teams show a more even distribution. 6. Lessons learned Based on data for all the teams, using e-mail and Web-based class surveys over the 20-week period, the following lessons were learned: (1) More buy-in to PENS was seen from teams with remote partnerships. In addition to PENS posting data, class surveys indicate that local teams do not perceive a compelling need for electronic communications in light of being co-located. To further investigate collaboration dynamics of distributed teams, we will consider requiring all ME210 project teams to have at least one remote student in the coming year. (2) A rough metric for inter-team work load was obtained. In evaluating group engineering projects, it is often difficult for management to assess individual contributions without a heavy time investment. PENS provides a mechanism for better understanding communication activities within a team and catching opportunities for intervention as the project progresses. While this data can not be used exclusively, it provides a quantitative dimension which can be used to augment qualitative performance assessments. (3) PENS clients are needed for non-Mac platforms. We have deployed PENS on the Macintosh platform to take advantage of Stanford’s highly Macintosh-centric campus environment. As we increase enrolment of remote students, PENS clients must be developed for other popular platforms in the work environment of remote students.
7. Future work The first generation of PENS has been successfully deployed in a 48-person testbed. In the interest of timely deployment, many planned features did not leave the drawing board for first stage implementation, these include: (1) Graphics. We are reminded frequently by users that engineers need to see pictures, yet the first generation of PENS only supported text. Support for rudimentary graphics, as well as intemote hypertext linking has been developed and will be included in our next test cycle. Still-frame video capture has now been enabled and is compatible with the sub $100 Connectix QuickCam. (2) Reading activity. Due to limitations of our current server implementation, we were not able to track individual PENS reading activity for each team to complement the data we have gathered for individual team posting. An improved user-tracking system will make this possible next year.
8. Closure We have described the concept, architecture and deployment history of a World-Wide Web-based electronic notebook for distributed engineering design teams. While we have focused on the utility of this concept for engineering design, the group notebook concept can be generalized to other domains, such as marketing, field survey work and construction industry coordination. As the notion of a globally sharable notebook is a new one for most of us, our strategy is to continuously deploy PENS in a variety of cross-domain testbeds and iteratively improve its design based on user feedback.
Acknowledgements We thank the students and teaching team of ME210 over the past two years for putting up with our development efforts. Special thanks to Brian Luehrs for making sure the 210Web stays ‘live’. PENS was developed under the SHARE project, carried out under the Department of Navy Contract NOO01492-J-1833.
J. Hong et al. /Computers
in Industry 29 (1996) 27-35
References ill G. Toye et al.,
“SHABE: A methodology and environment for collaborative product development”, IEEE Proc. 2nd Workshop on Enabling Technologies: Infrastructure for Collaboratiue Enterprises, Morgantown, April 1993, pp. 33-47. PI A. Burger, B. Meyer, C. Jung and K. Long, “The virtual notebook system”, juroc. Hypertext ‘91 Cof, November 1991. and [31M. Guzdial, N. Rappin and D. Carlson, “Collaborative multimedia interactive learning environment for engineering education”, accepted for ACM Symp. on Applied Computing ‘95. [41F. Lakin, V. Baya, D.M. Cannon, M. Brereton, L.J. Leifer
[5] [6]
[7] [8] [9] [lo]
35
and Cl. Toye, “Mapping design information”, AAAI Workshop on Design Rationale Capture and Use, AAAI 1992, San Jose, CA, June 1992. K. Hughes, HyperMail Documentation, http://www.eit. com/software/hypermail/hypermail.html. D. Perron, “Learning on the WWW: A case study”, Electronic Proc. 2nd WWW Co@, http://www.ncsa.uiuc.edu/ SDG/IT94/Proceedings/Educ/perron/perron.html Chicago, IL, October 1994. Eudora, Qualcomm Incorporated, Copyright 1992-93. Netscape Navigator, Netscape Communications Corporation, Copyright 1994-1995. MacTCP, Apple Computer, Inc., 1987-93. MacSLIP, Hyde Park Software, Copyright 1993.