A Domain Independent Readability Metric for Web Service Descriptions [JCR]

ALAN DE RENZIS; MARTÍN GARRIGA; ANDRÉS FLORES; ALEJANDRA CECHICH; CRISTIAN MATEOS; ALEJANDRO ZUNINO

COMPUTER STANDARDS & INTERFACES

ELSEVIER SCIENCE BV

Lugar: Amsterdam; Año: 2016

0920-5489

/* Layout-provided Styles */div.standard {margin-bottom: 2ex;}Web Services are influencing most IT-based industries as the basic building block of business infrastruc- tures. A Web Service has an interface described in a machine-processable format (specifically WSDL). Service providers expose their services by publishing the corresponding WSDL documents. Service con- sumers can learn about service capability and how to interact with the services. Service descriptions (WSDL documents) should be ideally understood easily by service stakeholders so that the process of consuming services is simplified. In this work we present a practical metric to quantify readability in WSDL documents ? attending to their semantics by using WordNet as the underlying concept hierarchy. In addition, we propose a set of best practices to be used during the development of WSDL documents to improve their readability. To validate our proposals, we performed both qualitative and quantitative exper- iments. A controlled survey with a group of (human) service consumers showed that software engineers required less time and effort to analyze WSDL documents with higher readability values. Other experiment compares readability values of a data-set of real-life WSDL documents from the industry before and after modifying them to adhere to the readability best practices proposed in this paper. We detected a significant readability improvement for WSDL documents written according to the best practices. In another experi- ment, we applied existing readability metrics for natural language texts detecting their unsuitability to the Web Service context.Lastly, we analyzed the readability best practices identifying their useful applicability to the industry.