Article

5th international workshop on graphical documentation: determining the barriers to adoption of UML diagrams

Authors:

SIGDOC '05: Proceedings of the 23rd annual international conference on Design of communication: documenting & designing for pervasive information

Pages 4 - 5

https://doi.org/10.1145/1085313.1085317

Published: 21 September 2005 Publication History

Get Access

Abstract

The Unified Modeling Language (UML) is the de facto standard for graphically documenting modern software systems. Unfortunately, learning how to properly construct high-quality UML diagrams so that they are an effective means of communication is a challenging task. This workshop will focus on the refinement of an assessment instrument to determine the barriers to increased adoption of UML diagrams by professional software engineers, technical writers, and other project stakeholders. The ultimate goal is to develop a series of recommendations on how to improve UML diagramming practice, and how those practices can be codified in existing methodologies and supported by common tools to foster widespread use.

References

[1]

Ambler, S. The Elements of UML 2.0 Style. Cambridge University Press, 2005.

Digital Library

Google Scholar

[2]

Bist, Gary, MacKinnon, N. and Murphy, S. "Sequence Diagram Presentation in Technical Documentation." Proceedings of the 22nd International Conference on Design of Communication (SIGDOC 2004: October 10-13, 2004; Memphis, TN), pp. 128--133. ACM Press: New York, 2004.

Digital Library

Google Scholar

[3]

Fowler, M. UML Distilled (3rd Ed.) Addison-Wesley, 2004.

Google Scholar

[4]

Huang, S. and Tilley, S. "Workshop on Graphical Documentation for Programmers: Assessing the Efficacy of UML Diagrams for Program Understanding." Held in conjunction with The 11th International Workshop on Program Comprehension (IWPC 2003: May 10, 2003; Portland, OR).

Digital Library

Google Scholar

[5]

MacKinnon, N. and Murphy, S. "Designing UML Diagrams for Technical Documentation." Proceedings of the 21st Annual International Conference on Design of Communication (SIGDOC 2003: October 12-15, 2003; San Francisco, CA), pp. 105--112. ACM Press: New York, 2003.

Digital Library

Google Scholar

[6]

Murphy, S.; Tilley, S.; and Huang, S. "4th Workshop on Graphical Documentation: UML Style Guidelines." Held in conjunction with The 22nd International Conference on Systems Documentation (SIGDOC 2004: October 12, 2004; Memphis, TN).

Digital Library

Google Scholar

[7]

Object Management Group (OMG). "UML Resource Page". Online at http://www.uml.org.

Google Scholar

[8]

Tilley, S. and Wong, K. "Workshop on Graphical Documentation for Programmers." Held in conjunction with The 20th Annual International Conference on Systems Documentation (SIGDOC 2002: October 21, 2002; Toronto, Canada).

Digital Library

Google Scholar

[9]

Tilley, S.; Smith, D.; and Thomas, B. "Documentation for Software Engineers: What is Needed to Aid System Understanding?" Held in conjunction with The 19th Annual International Conference on Systems Documentation (SIGDOC 2001: Santa Fe, NM; October 21-24, 2001).

Digital Library

Google Scholar

Cited By

View all

Elaasar MBadreddin O(2016)Modeling Meets Programming: A Comparative Study in Model Driven Engineering Action LanguagesLeveraging Applications of Formal Methods, Verification and Validation: Discussion, Dissemination, Applications10.1007/978-3-319-47169-3_5(50-67)Online publication date: 5-Oct-2016
https://doi.org/10.1007/978-3-319-47169-3_5
Hoyos HCasallas RJiménez FCorreal DWainer GTraoré MHeckel RHimmelspach J(2011)HiLeS2Proceedings of the 2011 Symposium on Theory of Modeling & Simulation: DEVS Integrative M&S Symposium10.5555/2048476.2048485(75-82)Online publication date: 3-Apr-2011
https://dl.acm.org/doi/10.5555/2048476.2048485
Tilley SBellomo SMehlenbacher BProtopsaltis AWilliams ASlattery S(2009)7th international workshop on graphical documentationProceedings of the 27th ACM international conference on Design of communication10.1145/1621995.1622059(309-310)Online publication date: 5-Oct-2009
https://dl.acm.org/doi/10.1145/1621995.1622059
Show More Cited By

Index Terms

5th international workshop on graphical documentation: determining the barriers to adoption of UML diagrams
1. Software and its engineering
  1. Software creation and management
    1. Software post-development issues
      1. Documentation
      2. Software reverse engineering

Recommendations

Towards interoperability of UML tools for exchanging high-fidelity diagrams
SIGDOC '07: Proceedings of the 25th annual ACM international conference on Design of communication

In today's global software engineering projects, where development activities are distributed geographically and temporally, it is increasingly important for CASE tools to maintain the information (both syntactic and semantic) captured in the design ...
Workshop on Graphical Documentation for Programmers: Assessing the Efficacy of UML Diagrams for Program Understanding
IWPC '03: Proceedings of the 11th IEEE International Workshop on Program Comprehension

Programmers often use graphical forms of documentation that rely on software visualization techniques to make complicated information easier to understand. However, it is an open question exactly which types of graphical documentation are most suitable ...
7th international workshop on graphical documentation: documenting SOA-based systems
SIGDOC '09: Proceedings of the 27th ACM international conference on Design of communication

Service-Oriented Architecture (SOA) is a way of designing, developing, deploying, and managing enterprise systems when business needs and technical solutions are closely aligned. SOA-based systems can be so large and complex, so the role of ...

Comments

Information & Contributors

Information

Published In

SIGDOC '05: Proceedings of the 23rd annual international conference on Design of communication: documenting & designing for pervasive information

September 2005

176 pages

ISBN:1595931759

DOI:10.1145/1085313

General Chair:
Scott Tilley
Florida Institute of Technology, USA
,
Program Chair:
Robert M. Newman
Coventry University, UK

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: 21 September 2005

Permissions

Request permissions for this article.

Request Permissions

Check for updates

Author Tags

Qualifiers

Article

Conference

SIGDOC05

Sponsor:

SIGDOC05: ACM 23rd Annual International Conference on Documentation

September 21 - 23, 2005

Coventry, United Kingdom

Acceptance Rates

Overall Acceptance Rate 355 of 582 submissions, 61%

Contributors

Other Metrics

View Article Metrics

Bibliometrics & Citations

Bibliometrics

Article Metrics

5
Total Citations
View Citations
254
Total Downloads

Downloads (Last 12 months)1
Downloads (Last 6 weeks)0

Reflects downloads up to 07 Mar 2025

Other Metrics

View Author Metrics

Citations

Cited By

View all

Elaasar MBadreddin O(2016)Modeling Meets Programming: A Comparative Study in Model Driven Engineering Action LanguagesLeveraging Applications of Formal Methods, Verification and Validation: Discussion, Dissemination, Applications10.1007/978-3-319-47169-3_5(50-67)Online publication date: 5-Oct-2016
https://doi.org/10.1007/978-3-319-47169-3_5
Hoyos HCasallas RJiménez FCorreal DWainer GTraoré MHeckel RHimmelspach J(2011)HiLeS2Proceedings of the 2011 Symposium on Theory of Modeling & Simulation: DEVS Integrative M&S Symposium10.5555/2048476.2048485(75-82)Online publication date: 3-Apr-2011
https://dl.acm.org/doi/10.5555/2048476.2048485
Tilley SBellomo SMehlenbacher BProtopsaltis AWilliams ASlattery S(2009)7th international workshop on graphical documentationProceedings of the 27th ACM international conference on Design of communication10.1145/1621995.1622059(309-310)Online publication date: 5-Oct-2009
https://dl.acm.org/doi/10.1145/1621995.1622059
Williams AMoore MHuang SPierce RStamey J(2006)Designing communicationProceedings of the 24th annual ACM international conference on Design of communication10.1145/1166324.1166338(59-63)Online publication date: 18-Oct-2006
https://dl.acm.org/doi/10.1145/1166324.1166338
Witmer KKoss RKasza THuang SPierce RStamey J(2006)A method for risk mitigation during the requirements phase for multimedia software systemsProceedings of the 24th annual ACM international conference on Design of communication10.1145/1166324.1166330(19-22)Online publication date: 18-Oct-2006
https://dl.acm.org/doi/10.1145/1166324.1166330

View Options

Login options

Check if you have access through your login credentials or your institution to get full access on this article.

Full Access

Get this Publication

View options

PDF

View or Download as a PDF file.

PDF

eReader

View online with eReader.

eReader

Abstract

References

Cited By

Index Terms

Recommendations

Towards interoperability of UML tools for exchanging high-fidelity diagrams

Workshop on Graphical Documentation for Programmers: Assessing the Efficacy of UML Diagrams for Program Understanding

7th international workshop on graphical documentation: documenting SOA-based systems

Comments

Information

Published In

Sponsors

Publisher

Publication History

Permissions

Check for updates

Author Tags

Qualifiers

Conference

Acceptance Rates

Contributors

Other Metrics

Bibliometrics

Article Metrics

Other Metrics

Citations

Cited By

Login options

Full Access

View options

PDF

eReader

Share

Share this Publication link

Share on social media

Affiliations