Effective Communication of Software Development
Knowledge Through Community Portals
Christoph Treude, Margaret-Anne Storey
Dept. of Computer Science, University of Victoria
ctreude@uvic.ca, mstorey@uvic.ca
ABSTRACT
Knowledge management plays an important role in many
software organizations. Knowledge can be captured and dis-
tributed using a variety of media, including traditional help
files and manuals, videos, technical articles, wikis, and blogs.
In recent years, web-based community portals have emerged
as an important mechanism for combining various commu-
nication channels. However, there is little advice on how
they can be effectively deployed in a software project.
In this paper, we present a first study of a community por-
tal used by a closed source software project. Using grounded
theory, we develop a model that characterizes documen-
tation artifacts along several dimensions, such as content
type, intended audience, feedback options, and review mech-
anisms. Our findings lead to actionable advice for indus-
try by articulating the benefits and possible shortcomings of
the various communication channels in a knowledge-sharing
portal. We conclude by suggesting future research on the
increasing adoption of community portals in software engi-
neering projects.
Categories and Subject Descriptors
D.2.9 [Software Engineering]: Management
General Terms
Documentation, Human Factors
Keywords
Community Portal, Knowledge, Documentation
1. INTRODUCTION AND MOTIVATION
Software development is knowledge-intensive [25], and the
effective management and exchange of knowledge is key
in every software organization. Knowledge is distributed
through various artifacts and media forms, from formal
documentation and technical articles, to blogs and wikis.
Permission to make digital or hard copies of all or part of this work for
personal or classroom use is granted without fee provided that copies are
not made or distributed for profit or commercial advantage and that copies
bear this notice and the full citation on the first page. To copy otherwise, to
republish, to post on servers or to redistribute to lists, requires prior specific
permission and/or a fee.
ESEC/FSE’11, September 5–9, 2011, Szeged, Hungary.
Copyright 2011 ACM 978-1-4503-0443-6/11/09 ...$10.00.
However, many organizations struggle with the effective ex-
change and dissemination of knowledge across the commu-
nity [15, 28].
Although various forms of documentation exist, software
projects encounter many knowledge management challenges
[9, 24]: How should knowledge be distributed? How should
knowledge be kept up to date? How should feedback be
solicited? How should knowledge be organized for easy ac-
cess? There is no roadmap for what kind of information is
best presented in a given artifact, and new forms of docu-
mentation, such as wikis and blogs, have evolved [20]. Unlike
more formal mechanisms, wikis and blogs are easy to create
and maintain. However, they do not offer the same author-
itativeness that comes with traditional documentation, and
they can become outdated and less concise over time [5].
While the informality of a wiki page or blog is sometimes
enough, users often expect reviewed technical articles.
One mechanism that has emerged recently and brings var-
ious communication channels together is the use of web or
community portals. Such portals are not just used in soft-
ware communities, but are essential to companies, such as
Amazon.com, eBay or TripAdvisor, where they enable the
development of communities around products. Similarly,
many of today’s software projects wish to solicit feedback
and input from a broader community of users, beta-testers,
and stakeholders. While several projects use community
portals, such as Microsoft’s MSDN
1
or IBM’s Jazz
2
, the use
of portals for software development projects has not been
studied yet. It is unclear how portals can play an effective
role in software development, and how different communi-
cation channels and artifacts should be utilized.
This paper presents a first study of a successful software
project – IBM’s Rational Team Concert – and its use of a
community portal. Our methodology follows a grounded
theory approach, using data from 13 semi-structured in-
terviews with developers, ethnographic field notes gathered
during observations on-site, and quantitative data on the
content of the community portal. Based on our findings,
we develop a model of artifacts in a community portal that
characterizes the artifacts along different dimensions, such
as intended audience, content type, feedback options, and
review mechanisms. We provide actionable advice on how a
community portal can provide benefits to a software project,
and we discuss how the different channels and artifacts avail-
able in a portal can be used effectively. We also identify
the shortcomings of different artifacts, and suggest improve-
1
http://msdn.microsoft.com/en-us/
2
https://jazz.net/pub/index.jsp
91
- 1
- 2
前往页