Volume 10 Number 11 (Nov. 2015)
Home > Archive > 2015 > Volume 10 Number 11 (Nov. 2015) >
JSW 2015 Vol.10(11): 1327-1335 ISSN: 1796-217X
doi: 10.17706/jsw.10.11.1327-1335

On Collaboration in Software: Annotation vs. Flow-Based Diagrams

Sabah Al-Fedaghi
Computer Engineering Department, Kuwait University, P.O. Box 5969 Safat 13060 Kuwait.

Abstract—Programming may involve a fair amount of complexity. Accordingly, development of a description is needed to facilitate understanding and to serve more than documentation and initial planning requirements of a program. This paper focuses on the programming level at the point where stakeholders (e.g., designers, algorithm specialists) have concerns about the implementation method (coding) to be used, a concern that stems from the collective accountability of the software project team. The paper claims that current methodologies of producing high-level description to represent structural units and control streams in software programs fall short of providing a foundation for an easily understandable, high-level overview of what the code actually does. The paper contributes to the solution of such a problem by proposing an alternative approach to diagramming of programs. Without loss of generality, the focus on a very recent tool that generates flowcharts from annotated C++ source code to a set of interconnected high-level UML (Unified Modeling Language) activity diagrams. For comparison purposes, the diagrams produced by the methodologies are put side by side for the same source programs. The proposed diagrammatic representation seems to offer a viable alternative in the examined context to activity diagrams.

Index Terms—Software complexity, program annotation, C++, diagramming software, activity diagram.

[PDF]

Cite: Sabah Al-Fedaghi, "On Collaboration in Software: Annotation vs. Flow-Based Diagrams," Journal of Software vol. 10, no. 11, pp. 1327-1335, 2015.

General Information

ISSN: 1796-217X (Online)
Frequency: Monthly (2006-2019); Bimonthly (Since 2020)
Editor-in-Chief: Prof. Antanas Verikas
Executive Editor: Ms. Yoyo Y. Zhou
Abstracting/ Indexing: DBLP, EBSCO, Google Scholar, ProQuest, INSPEC, ULRICH's Periodicals Directory, WorldCat, etc
E-mail: jsw@iap.org
  • Dec 06, 2019 News!

    Vol 14, No 1- Vol 14, No 4 has been indexed by EI (Inspec)   [Click]

  • Jun 22, 2020 News!

    Papers published in JSW Vol 14, No 1- Vol 15 No 4 have been indexed by DBLP     [Click]

  • Sep 30, 2020 News!

    The papers published in Vol 15, No 6 have all received dois from Crossref   [Click]

  • Aug 01, 2018 News!

    [CFP] 2020 the annual meeting of JSW Editorial Board, ICCSM 2020, will be held in Rome, Italy, July 17-19, 2020   [Click]

  • Sep 30, 2020 News!

    Vol 15, No 6 has been published with online version     [Click]