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: jsweditorialoffice@gmail.com
  • Mar 01, 2024 News!

    Vol 19, No 1 has been published with online version    [Click]

  • Jan 04, 2024 News!

    JSW will adopt Article-by-Article Work Flow

  • Apr 01, 2024 News!

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

  • Apr 01, 2024 News!

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

  • Nov 02, 2023 News!

    Vol 18, No 4 has been published with online version   [Click]