Tag Clouds for Software Documents Visualization

Ra'fat Al-msie'deen - Mutah University, Karak, Jordan

Citation Format:

DOI: http://dx.doi.org/10.30630/joiv.3.4.285


Legacy software documents are hard to understand and visualize. The tag cloud technique helps software developers to visualize the contents of software documents. A tag cloud is a well-known and simple visualization technique. This paper proposes a new method to visualize software documents, using a tag cloud. In this paper, tags visualize in the cloud based on their frequency in an alphabetical order. The most important tags are displayed with a larger font size. The originality of this method is that it visualizes the contents of JavaDoc as a tag cloud. To validate the JavaDocCloud method, it was applied to NanoXML case study, the results of these experiments display the most common and uncommon tags used in the software documents.


Software engineering; Software visualization; Javadoc; Tag cloud.

Full Text:



J. Emerson, Tag Clouds in Software Visualisation, MSc Thesis, University of Canterbury, 2014.

J. Emerson, N. Churcher, A. Cockburn, “Tag Clouds for Software and Information Visualisationâ€, 14th Annual ACM SIGCHI NZ Conference on Computer-Human Interaction, Christchurch, New Zealand, November 15-16, pp. 1-4, 2013.

J. Emerson, N. Churcher, C. Deaker, “From Toy to Tool: Extending Tag Clouds for Software and Information Visualisationâ€, 22nd Australian Software Engineering Conference, Melbourne, Australia, June 4-7, pp. 155-164, 2013.

R. Al-Msie’deen, “Tag Clouds for the Object-Oriented Source Code Visualization,†Engineering, Technology & Applied Science Research, vol. 9, no. 3, pp. 4243–4248, 2019.

D. Kramer, “API documentation from source code comments: a case study of Javadoc,†In Proceedings of the 17th annual international conference on Computer documentation, SIGDOC ’99, pp. 147–153, 1999.

C. Deaker, L. Pettigrew, N. Churcher, and W. Irwin, “Software visualisation with tag clouds,†in ASWEC 2010 Industry Track Proceedings, J. Hosking and B. Long, Eds., Auckland, New Zealand, pp. 129–133, 2010.

R. Cottrell, B. Goyette, R. Holmes, R. J. Walker, J. Denzinger, “Compare and Contrast: Visual Exploration of Source Code Examplesâ€, 5th IEEE International Workshop on Visualizing Software for Understanding and Analysis, Edmonton, Canada, September 25-26, pp. 1-4, 2009.

C. Anslow, J. Noble, S. Marshall, E. D. Tempero, “Visualizing the Word Structure of Java Class Namesâ€, in Companion to the 23rd Annual ACM Sigplan Conference on Object-Oriented Programming, Systems, Languages, and Applications, Nashville, USA, Octomber 13-19, 2008.

M. Stocker, https://misto.ch/2011/09/19/tag-cloud-visualization-for-source-code/, August 25, 2019.

J. Martinez, T. Ziadi, T. F. Bissyande, J. Klein, Y. L. Traon, “Name Suggestions During Feature Identiï¬cation: The Variclouds Approachâ€, 20th International Systems and Software Product Line Conference, Beijing, China, September 16-23, 2016.

ArgoUML Javadocs-0.20: http://argouml-stats.tigris.org/, August 25, 2019.

R. Al-Msie’deen, M. Huchard, A. Seriai, C. Urtado, S. Vauttier, “Automatic documentation of [mined] feature implementations from source code elements and use-case diagrams with the REVPLINE approachâ€, International Journal of Software Engineering and Knowledge Engineering, Vol. 24, No. 10, pp. 1413–1438, 2014.

R. Al-Msie’deen, A. D. Seriai, M. Huchard, C. Urtado, S. Vauttier, “Documenting the mined feature implementations from the object-oriented source code of a collection of software product variantsâ€, 26th International Conference on Software Engineering and Knowledge Engineering, Knowledge Systems, Vancouver, Canada, July 1-July 3, 2014.

G. A. Miller, “Wordnet: A lexical database for Englishâ€, Communications of the ACM, Vol. 38, No. 11, pp. 39–41, 1995.

WordNet: https://wordnet.princeton.edu, August 25, 2019.

ArgoUML Javadocs: http://argouml-stats.tigris.org/nonav/javadocs/javadocs-0.20/, August 25, 2019.

NanoXML: http://nanoxml.sourceforge.net/orig/index.html, August 25, 2019.

R. Al-Msie’deen, https://sites.google.com/site/ralmsideen/tools, August 25, 2019.