skip to main content
10.1145/1234324.1234334acmotherconferencesArticle/Chapter ViewAbstractPublication PagescnsrConference Proceedingsconference-collections
Article

Calliope: supporting high-level documentation of open-source projects

Published: 09 November 2005 Publication History

Abstract

Open-source development has long passed the state of infancy. With brands such as Apache, Mozilla and Linux, open-source development is becoming a major player on the global software market. Yet, most open-source projects today are using mailing lists as their primary communication channel and the resulting mailing archives as their only source of documentation. Mailing archives typically contain massive amounts of data, and only support simplistic structures, creating problems such as "information overflow". This makes it difficult for the developers to maintain a common direction of their work, causing reduced productivity and eventually loss of developers.
Various approaches have been suggested to address this and similar problems, both for open-source development and for software development in general. Some approaches enable developers to model their exact reasoning; others extract new data from existing data; yet again others let developers describe low level details of the system in close proximity to the actual code.
The Calliope project aims at facilitating developers in aligning their efforts in a common direction at a high level of abstraction. As an important aspect of this, we propose that the explicit modeling of multivalence could improve the acceptance of more advanced documentation tools into the environment of open-source development. In order to test this claim, we have built a prototype that implements explicit modeling of multivalence. With this prototype we have carried out tests, that support our claim.

References

[1]
W. O. Beeman, K. T. Anderson, G. Bader, J. Larkin, A. P. McClard, P. McQuillan, and M. Shields. Hypertext and pluralism: from lineal to non-lineal thinking. In HYPERTEXT '87: Proceeding of the ACM conference on Hypertext, pages 67 88, New York, NY, USA, 1987. ACM Press.
[2]
M. Bernstein, M. Joyce, and D. Levine. Contours of constructive hypertexts. In ECHT '92: Proceedings of the ACM conference on Hypertext, pages 161--170, New York, NY, USA, 1992. ACM Press.
[3]
L. Carr, T. Miles-Board, A. Woukeu, G. Wills, and W. Hall. The case for explicit knowledge in documents. In Proceeding of the ACM conference on Document Engineering. ACM Press, 2004.
[4]
J. Conklin and M. L. Begeman. gIBIS: a hypertext tool for team design deliberation. In HYPERTEXT '87: Proceeding of the ACM conference on Hypertext, pages 247--251. ACM Press, 1987.
[5]
J. Conklin and M. L. Begeman. gibis: a hypertext tool for exploratory policy discussion. In CSCW '88: Proceedings of the 1988 ACM conference on Computer-supported cooperative work, pages 140--152, New York, NY, USA, 1988. ACM Press.
[6]
D. Cubranic and G. C. Murphy. Hipikat: recommending pertinent software development artifacts. In ICSE '03: Proceedings of the 25th International Conference on Software Engineering, pages 408--418. IEEE Computer Society, 2003.
[7]
B. F. Daily, J. Loveland, and R. Steiner. A comparative analysis of reactions from multicultural and culturally homogeneousteams to decision making with and without gdss technology. SIGCPR Comput. Pers., 18(1):3--14, 1997.
[8]
A. Forward and T. C. Lethbridge. The relevance of software documentation, tools and technologies: a survey. In DocEng '02: Proceedings of the 2002 ACM symposium on Document engineering, pages 26--33, New York, NY, USA, 2002. ACM Press.
[9]
Inkscape Community. Inkscape. WWW, 2005. available via www.inkscape.org, last visited on 2006-02-15.
[10]
L. Kaplinski. Sodipodi. WWW, 2005. available via www.sodipodi.com, last visited on 2006-02-15.
[11]
C. Keep, T. McLaughlin, and R. Parmar. Electronic labyrinth. WWW, 2005. available via www.iath.virginia.edu/elab, last visited on 2006-02-15.
[12]
G. P. Landow. Hypertext 2.0. Johns Hopkins University Press, 1997.
[13]
Literate Programming Community. www.literateprogramming.com. WWW, 2005. available via www.literateprogramming.com, last visited on 2006-02-15.
[14]
F. H. Madsen, M. T. Toustrup, and J. E. M. Thomsen. Calliope: A post-structural approach to improving documentation in open-sourcedevelopment. Master's thesis, Aalborg University Esbjerg, 2005. available via www.huitfeldt.com/repository/calliope.pdf, last visited 2006-02-15.
[15]
Mjølner Informatics. The mjølner integrated development tool. WWW, 2005. available via www.daimi.au.dk/beta/Manuals/latest/, last visited on 2006-02-15.
[16]
A. Mockus, R. T. Fielding, and J. D. Herbsleb. Two case studies of open source software development: Apache and mozilla. ACM Trans. Softw. Eng. Methodol., 11(3):309--346, 2002.
[17]
W. Morgan. Electronic tools for dismantling the master's house: poststructuralist feminist research and hypertext poetics. In HYPERTEXT '99: Proceedings of the tenth ACM Conference on Hypertext and hypermedia: returning to our diverse roots, pages 207--216. ACM Press, 1999.
[18]
S. Moulthrop. Hypertext and the "the hyperreal". In HYPERTEXT '89: Proceedings of the second annual ACM conference on Hypertext, pages 259--267. ACM Press, 1989.
[19]
S. Moulthrop. Beyond the electronic book: a critique of hypertext rhetoric. In HYPERTEXT '91: Proceedings of the third annual ACM conference on Hypertext, pages 291--298, New York, NY, USA, 1991. ACM Press.
[20]
S. Moulthrop. You say you want a revolution? hypertext and the laws of media. Postmodern Culture, 1(3), 1991.
[21]
T. N. Nguyen and E. V. Munson. The Software Concordance: a new software document management environment. In Proceedings of the 21st annual international conference on Documentation, pages 198--205. ACM Press, 2003.
[22]
M. Pavic. Dictionary of the Khazars: A Lexicon Novel in 100,000 words. Hamish Hamilton; Male edition, 1989.
[23]
M. Sarup. An Introductory Guide to Post-Structuralism and Postmodernism. University of Georgia Press, second edition, 1993.
[24]
K. Schmidt. Remarks on the complexity of cooperative work. Pascal Salembier and Tahar Hakim Benchekroun (eds.): Cooperation and Complexity in Sociotechnical Systems, {special issue of} Revue des sciences et technologies de l 'information, {série} Revue d 'intelligence artificielle (RSTI-RAI), 16(4--5):443--483, 2002.
[25]
J. Spaans. Linux kernel mailing list. WWW, 2005. available via www.lkml.org, last visited on 2006-02-15.
[26]
Sun Microsystems Inc. Java Doc. WWW, 2005. available via www.java.sun.com/j2se/javadoc, last visited on 2006-02-15.
[27]
T. Vestdam. Elucidative Programming in open integrated development environments for Java. In PPPJ '03: Proceedings of the 2nd international conference on Principlesand practice of programming in Java, pages 49--54. Computer Science Press, Inc., 2003.
[28]
F. B. Viégas, M. Wattenberg, and K. Dave. Studying cooperation and conflict between authors with history flow visualizations. In CHI '04: Proceedings of the 2004 conference on Human factors in computingsystems, pages 575--582. ACM Press, 2004.
[29]
Wikipedia Community. Wikipedia: The free encyclopedia. WWW, 2005. available via www.wikipedia.org, last visited on 2006-02-15.

Cited By

View all

Recommendations

Comments

Information & Contributors

Information

Published In

cover image ACM Other conferences
MIS '05: Proceedings of the 2005 symposia on Metainformatics
November 2005
139 pages
ISBN:9781595937193
DOI:10.1145/1234324
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. Copyrights for components of this work owned by others than ACM must be honored. Abstracting with credit is permitted. To copy otherwise, or republish, to post on servers or to redistribute to lists, requires prior specific permission and/or a fee. Request permissions from [email protected]

Publisher

Association for Computing Machinery

New York, NY, United States

Publication History

Published: 09 November 2005

Permissions

Request permissions for this article.

Check for updates

Qualifiers

  • Article

Contributors

Other Metrics

Bibliometrics & Citations

Bibliometrics

Article Metrics

  • Downloads (Last 12 months)2
  • Downloads (Last 6 weeks)0
Reflects downloads up to 20 Jan 2025

Other Metrics

Citations

Cited By

View all
  • (2018)Bridging the Academia-Industry Gap in Software EngineeringComputer Systems and Software Engineering10.4018/978-1-5225-3923-0.ch072(1738-1762)Online publication date: 2018
  • (2015)Bridging the Academia-Industry Gap in Software EngineeringSTEM Education10.4018/978-1-4666-7363-2.ch038(710-733)Online publication date: 2015
  • (2015)Bridging the Academia-Industry Gap in Software EngineeringOpen Source Technology10.4018/978-1-4666-7230-7.ch099(1927-1950)Online publication date: 2015
  • (2014)Bridging the Academia-Industry Gap in Software EngineeringOvercoming Challenges in Software Engineering Education10.4018/978-1-4666-5800-4.ch019(373-396)Online publication date: 2014
  • (2012)Automatic Generation of Usage Manuals for Open-Source SoftwareProceedings of the 2012 Sixth International Conference on Complex, Intelligent, and Software Intensive Systems (CISIS)10.1109/CISIS.2012.100(671-676)Online publication date: 4-Jul-2012
  • (2011)Automatic Generation of Configuration Manuals for Open-Source SoftwareProceedings of the 2011 International Conference on Complex, Intelligent, and Software Intensive Systems10.1109/CISIS.2011.109(653-658)Online publication date: 30-Jun-2011
  • (2008)A Proposal of an Installation Manual Generation Method for Open Source Software Using Operation LogsProceedings of the 2008 IEEE International Conference on Signal Image Technology and Internet Based Systems10.1109/SITIS.2008.62(547-554)Online publication date: 30-Nov-2008

View Options

Login options

View options

PDF

View or Download as a PDF file.

PDF

eReader

View online with eReader.

eReader

Media

Figures

Other

Tables

Share

Share

Share this Publication link

Share on social media