HOW TO WRITE COMMENTS SUITABLE FOR AUTOMATIC SOFTWARE INDEXING

Citation
P. Difelice et G. Fonzi, HOW TO WRITE COMMENTS SUITABLE FOR AUTOMATIC SOFTWARE INDEXING, The Journal of systems and software, 42(1), 1998, pp. 17-28
Citations number
14
Categorie Soggetti
Computer Science Theory & Methods","Computer Science Software Graphycs Programming","Computer Science Theory & Methods","Computer Science Software Graphycs Programming
ISSN journal
01641212
Volume
42
Issue
1
Year of publication
1998
Pages
17 - 28
Database
ISI
SICI code
0164-1212(1998)42:1<17:HTWCSF>2.0.ZU;2-7
Abstract
This paper proposes a strategy for writing the comments (that is, natu ral-language text) embedded in the source code of software components. The novelty of the strategy is that it suggests to proceed step by st ep starting from given specifications. At the end of the writing proce ss we have, besides the comments themselves, a set of indices forming a short description of the software component (its profile), which is much easier to manipulate than the full text. By storing profiles into a database a software catalog is built. The availability of software catalogs is strategic to locate reusable components matching specific requirements. (C) 1998 Elsevier Science Inc. All rights reserved.