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.


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:  Quarterly
Editor-in-Chief: Prof. Antanas Verikas
Executive Editor: Ms. Yoyo Y. Zhou
Abstracting/ Indexing: DBLP, EBSCO, CNKIGoogle Scholar, ProQuest, INSPEC(IET), ULRICH's Periodicals Directory, WorldCat, etc
E-mail: jsw@iap.org
  • Apr 26, 2021 News!

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

  • Nov 18, 2021 News!

    Papers published in JSW Vol 16, No 1- Vol 16, No 6 have been indexed by DBLP   [Click]

  • Dec 24, 2021 News!

     Vol 15, No 1- Vol 15, No 6 has been indexed by IET-(Inspec)   [Click]

  • Nov 18, 2021 News!

    [CFP] 2022 the annual meeting of JSW Editorial Board, ICCSM 2022, will be held in Rome, Italy, July 21-23, 2022   [Click]

  • Aug 01, 2023 News!