{"status":"ok","message-type":"work","message-version":"1.0.0","message":{"indexed":{"date-parts":[[2025,6,13]],"date-time":"2025-06-13T05:24:22Z","timestamp":1749792262740,"version":"3.37.3"},"reference-count":41,"publisher":"Springer Science and Business Media LLC","issue":"5","license":[{"start":{"date-parts":[[2020,8,26]],"date-time":"2020-08-26T00:00:00Z","timestamp":1598400000000},"content-version":"tdm","delay-in-days":0,"URL":"https:\/\/www.springer.com\/tdm"},{"start":{"date-parts":[[2020,8,26]],"date-time":"2020-08-26T00:00:00Z","timestamp":1598400000000},"content-version":"vor","delay-in-days":0,"URL":"https:\/\/www.springer.com\/tdm"}],"funder":[{"name":"Natural Sciences and Engineering Research Council (NSERC) Discovery Grant","award":["00000000"],"award-info":[{"award-number":["00000000"]}]}],"content-domain":{"domain":["link.springer.com"],"crossmark-restriction":false},"short-container-title":["Empir Software Eng"],"published-print":{"date-parts":[[2020,9]]},"DOI":"10.1007\/s10664-020-09857-0","type":"journal-article","created":{"date-parts":[[2020,8,26]],"date-time":"2020-08-26T07:02:42Z","timestamp":1598425362000},"page":"4069-4096","update-policy":"https:\/\/doi.org\/10.1007\/springer_crossmark_policy","source":"Crossref","is-referenced-by-count":8,"title":["Information correspondence between types of documentation for APIs"],"prefix":"10.1007","volume":"25","author":[{"ORCID":"https:\/\/orcid.org\/0000-0002-3719-5011","authenticated-orcid":false,"given":"Deeksha M.","family":"Arya","sequence":"first","affiliation":[]},{"given":"Jin L. C.","family":"Guo","sequence":"additional","affiliation":[]},{"given":"Martin P.","family":"Robillard","sequence":"additional","affiliation":[]}],"member":"297","published-online":{"date-parts":[[2020,8,26]]},"reference":[{"key":"9857_CR1","doi-asserted-by":"crossref","unstructured":"Al Omran FNA, Treude C (2017) Choosing an nlp library for analyzing software documentation: a systematic literature review and a series of experiments. In: 2017 IEEE\/ACM 14th international conference on mining software repositories (MSR). IEEE, pp 187\u2013197","DOI":"10.1109\/MSR.2017.42"},{"key":"9857_CR2","unstructured":"Angelini G (2018) Current practices in Web API documentation. In: European academic colloquium on technical communication, p 70"},{"key":"9857_CR3","doi-asserted-by":"crossref","unstructured":"Caponi A, Di Iorio A, Vitali F, Alberti P, Scat\u00e1 M (2018) Exploiting patterns and templates for technical documentation. In: Proceedings of the ACM symposium on document engineering 2018. DocEng \u201918. Association for Computing Machinery, New York","DOI":"10.1145\/3209280.3209537"},{"key":"9857_CR4","unstructured":"Checkstyle - JavadocStyle (2020) https:\/\/checkstyle.sourceforge.io\/config_javadoc.html#JavadocStyle (Online; Accessed 7 May 2020)"},{"key":"9857_CR5","doi-asserted-by":"crossref","unstructured":"Cleland-Huang J, Guo J (2014) Towards more intelligent trace retrieval algorithms. In: Proceedings of the 3rd international workshop on realizing artificial intelligence synergies in software engineering, pp 1\u20136","DOI":"10.1145\/2593801.2593802"},{"key":"9857_CR6","doi-asserted-by":"crossref","unstructured":"Dagenais B, Robillard MP (2010) Creating and evolving developer documentation: understanding the decisions of open source contributors. In: Proceedings of the 18th ACM SIGSOFT international symposium on foundations of software engineering, pp 127\u2013136","DOI":"10.1145\/1882291.1882312"},{"key":"9857_CR7","doi-asserted-by":"publisher","first-page":"1126","DOI":"10.1109\/TSE.2014.2347969","volume":"11","author":"B Dagenais","year":"2014","unstructured":"Dagenais B, Robillard MP (2014) Using traceability links to recommend adaptive changes for documentation evolution. IEEE Trans Softw Eng 11:1126\u20131146","journal-title":"IEEE Trans Softw Eng"},{"key":"9857_CR8","doi-asserted-by":"crossref","unstructured":"Dekel U, Herbsleb JD (2009) Improving API documentation usability with knowledge pushing. In: Proceedings of the 31st international conference on software engineering, pp 320\u2013330","DOI":"10.1109\/ICSE.2009.5070532"},{"key":"9857_CR9","doi-asserted-by":"crossref","unstructured":"Forward A, Lethbridge TC (2002) The relevance of software documentation, tools and technologies: a survey. In: Proceedings of the ACM symposium on document engineering, pp 26\u201333","DOI":"10.1145\/585058.585065"},{"key":"9857_CR10","doi-asserted-by":"crossref","unstructured":"Fourney A, Terry M (2014) Mining online software tutorials: challenges and open problems. In: Proceedings of extended abstracts on human factors in computing systems, pp 653\u2013664","DOI":"10.1145\/2559206.2578862"},{"key":"9857_CR11","doi-asserted-by":"crossref","unstructured":"Garousi G, Garousi V, Moussavi M, Ruhe G, Smith B (2013) Evaluating usage and quality of technical software documentation: an empirical study. In: Proceedings of the 17th international conference on evaluation and assessment in software engineering, pp 24\u201335","DOI":"10.1145\/2460999.2461003"},{"key":"9857_CR12","unstructured":"Git-commit (2020). https:\/\/git-scm.com\/docs\/git-commit (Online; Accessed 7 May 2020)"},{"key":"9857_CR13","unstructured":"IEEE Standard (2009) IEEE standard for information technology\u2013systems design\u2013software design descriptions. In: IEEE STD 1016-2009, pp 1\u201335"},{"key":"9857_CR14","doi-asserted-by":"crossref","unstructured":"Jiang H, Zhang J, Ren Z, Zhang T (2017) An unsupervised approach for discovering relevant tutorial fragments for APIs. In: Proceedings of the 39th international conference on software engineering, pp 38\u201348","DOI":"10.1109\/ICSE.2017.12"},{"key":"9857_CR15","unstructured":"Josyula JRA, Panamgipalli SSSC (2016) Identifying the information needs and sources of software practitioners: a mixed method approach. Master\u2019s thesis. http:\/\/urn.kb.se\/resolve?urn=urn:nbn:se:bth-12832"},{"key":"9857_CR16","doi-asserted-by":"crossref","unstructured":"Koznov D, Luciv D, Basit HA, Lieh OE, Smirnov M (2015) Clone detection in reuse of software technical documentation. In: Proceedings of international Andrei Ershov memorial conference on perspectives of system informatics, pp 170\u2013185","DOI":"10.1007\/978-3-319-41579-6_14"},{"key":"9857_CR17","unstructured":"Koznov D, Luciv D, Chernishev G (2017) Duplicate management in software documentation maintenance. In: Proceedings of the 5th international conference on actual problems of system and software engineering. CEUR Workshops proceedings, vol 1989, pp 195\u2013201"},{"key":"9857_CR18","doi-asserted-by":"crossref","unstructured":"Kramer D (1999) API documentation from source code comments: a case study of Javadoc. In: Proceedings of the 17th annual international conference on computer documentation, pp 147\u2013153","DOI":"10.1145\/318372.318577"},{"key":"9857_CR19","volume-title":"Content analysis: an introduction to its methodology","author":"K Krippendorff","year":"2018","unstructured":"Krippendorff K (2018) Content analysis: an introduction to its methodology. Sage Publications, Thousand Oaks"},{"key":"9857_CR20","doi-asserted-by":"publisher","first-page":"216","DOI":"10.1134\/S0361768816040046","volume":"42","author":"D Luciv","year":"2016","unstructured":"Luciv D, Koznov D, Basit H, Terekhov A (2016) On fuzzy repetitions detection in documentation reuse. Program Comput Softw 42:216\u2013224","journal-title":"Program Comput Softw"},{"key":"9857_CR21","doi-asserted-by":"publisher","first-page":"335","DOI":"10.1134\/S0361768818050079","volume":"44","author":"D Luciv","year":"2018","unstructured":"Luciv D, Koznov D, Chernishev G, Terekhov A, Romanovsky KY, Grigoriev D (2018) Detecting near duplicates in software documentation. Program Comput Softw 44:335\u2013343","journal-title":"Program Comput Softw"},{"key":"9857_CR22","doi-asserted-by":"crossref","unstructured":"Maalej W, Robillard MP (2013) Patterns of knowledge in API reference documentation. In: IEEE Trans Softw Eng, vol 39, pp 1264\u20131282","DOI":"10.1109\/TSE.2013.12"},{"key":"9857_CR23","doi-asserted-by":"publisher","first-page":"295","DOI":"10.1177\/0047281617721853","volume":"48","author":"M Meng","year":"2018","unstructured":"Meng M, Steinhardt S, Schubert A (2018) Application programming interface documentation: what do software developers want? J Tech Writ Commun 48:295\u2013330","journal-title":"J Tech Writ Commun"},{"key":"9857_CR24","doi-asserted-by":"publisher","first-page":"40","DOI":"10.1145\/3358931.3358937","volume":"7","author":"M Meng","year":"2019","unstructured":"Meng M, Steinhardt S, Schubert A (2019) How developers use API documentation: an observation study. Commun Des Q Rev 7:40\u201349","journal-title":"Commun Des Q Rev"},{"key":"9857_CR25","doi-asserted-by":"publisher","first-page":"703","DOI":"10.1007\/s10664-011-9186-4","volume":"17","author":"M Monperrus","year":"2012","unstructured":"Monperrus M, Eichberg M, Tekes E, Mezini M (2012) What should developers be aware of? An empirical study on the directives of API documentation. Empir Softw Eng 17:703\u2013737","journal-title":"Empir Softw Eng"},{"key":"9857_CR26","doi-asserted-by":"crossref","unstructured":"Oumaziz MA, Charpentier A, Falleri JR, Blanc X (2017) Documentation reuse: hot or not? An empirical study. In: Proceedings of international conference on software reuse, pp 12\u201327","DOI":"10.1007\/978-3-319-56856-0_2"},{"key":"9857_CR27","doi-asserted-by":"crossref","unstructured":"Parnin C, Treude C (2011) Measuring API documentation on the web. In: Proceedings of the 2nd international workshop on Web 2.0 for software engineering, pp 25\u201330","DOI":"10.1145\/1984701.1984706"},{"key":"9857_CR28","doi-asserted-by":"publisher","first-page":"97","DOI":"10.1109\/2.625327","volume":"30","author":"V Phoha","year":"1997","unstructured":"Phoha V (1997) A standard for software documentation. Computer 30:97\u201398","journal-title":"Computer"},{"key":"9857_CR29","doi-asserted-by":"crossref","unstructured":"Ries R (1990) IEEE standard for software user documentation. In: International conference on professional communication, communication across the sea: North American and European practices, pp 66\u201368","DOI":"10.1109\/IPCC.1990.111154"},{"key":"9857_CR30","doi-asserted-by":"crossref","unstructured":"Robillard MP (2009) What makes APIs hard to learn? answers from developers. In: IEEE Softw, vol 26, pp 27\u201334","DOI":"10.1109\/MS.2009.193"},{"key":"9857_CR31","doi-asserted-by":"publisher","first-page":"703","DOI":"10.1007\/s10664-010-9150-8","volume":"16","author":"MP Robillard","year":"2011","unstructured":"Robillard MP, Deline R (2011) A field study of API learning obstacles. Empir Softw Eng 16:703\u2013732","journal-title":"Empir Softw Eng"},{"key":"9857_CR32","doi-asserted-by":"publisher","DOI":"10.1002\/9781118181034","volume-title":"Case study research in software engineering: guidelines and examples","author":"P Runeson","year":"2012","unstructured":"Runeson P, Host M, Rainer A, Regnell B (2012) Case study research in software engineering: guidelines and examples. Wiley, New York"},{"key":"9857_CR33","unstructured":"Rupakheti CR (2012) A critic for api client code using symbolic execution. PhD thesis, Clarkson University"},{"key":"9857_CR34","doi-asserted-by":"crossref","unstructured":"Treude C, Robillard MP (2016) Augmenting API documentation with insights from stack overflow. In: Proceedings of 38th international conference on software engineering, pp 392\u2013403","DOI":"10.1145\/2884781.2884800"},{"key":"9857_CR35","doi-asserted-by":"publisher","first-page":"565","DOI":"10.1109\/TSE.2014.2387172","volume":"41","author":"C Treude","year":"2014","unstructured":"Treude C, Robillard MP, Dagenais B (2014) Extracting development tasks to navigate software documentation. IEEE Trans Softw Eng 41:565\u2013581","journal-title":"IEEE Trans Softw Eng"},{"key":"9857_CR36","doi-asserted-by":"publisher","first-page":"68","DOI":"10.1109\/MS.2014.80","volume":"32","author":"G Uddin","year":"2015","unstructured":"Uddin G, Robillard MP (2015) How API documentation fails. IEEE Softw 32:68\u201375","journal-title":"IEEE Softw"},{"key":"9857_CR37","doi-asserted-by":"crossref","unstructured":"Watson RB (2012) Development and application of a heuristic to assess trends in api documentation. In: Proceedings of the 30th ACM international conference on design of communication, pp 295\u2013302","DOI":"10.1145\/2379057.2379112"},{"key":"9857_CR38","doi-asserted-by":"crossref","unstructured":"Watson R, Stamnes M, Jeannot-Schroeder J, Spyridakis JH (2013) API documentation and software community values: a survey of open-source api documentation. In: Proceedings of the 31st ACM international conference on design of communication, pp 165\u2013174","DOI":"10.1145\/2507065.2507076"},{"key":"9857_CR39","unstructured":"Wikipedia Contributors (2020) Wikipedia: manual of style\/lead section. https:\/\/en.wikipedia.org\/wiki\/Wikipedia:Manual_of_Style\/Lead_section (Online; Accessed 7 May 2020)"},{"key":"9857_CR40","unstructured":"Wildermann S (2014) Messung der Informationstypen-H\u00e4ufigkeiten in der Python-Dokumentation. Bachelor\u2019s thesis"},{"key":"9857_CR41","doi-asserted-by":"crossref","unstructured":"Zhong H, Zhang L, Xie T, Mei H (2009) Inferring resource specifications from natural language API documentation. In: Proceedings of the international conference on automated software engineering, pp 307\u2013318","DOI":"10.1109\/ASE.2009.94"}],"container-title":["Empirical Software Engineering"],"original-title":[],"language":"en","link":[{"URL":"https:\/\/link.springer.com\/content\/pdf\/10.1007\/s10664-020-09857-0.pdf","content-type":"application\/pdf","content-version":"vor","intended-application":"text-mining"},{"URL":"https:\/\/link.springer.com\/article\/10.1007\/s10664-020-09857-0\/fulltext.html","content-type":"text\/html","content-version":"vor","intended-application":"text-mining"},{"URL":"https:\/\/link.springer.com\/content\/pdf\/10.1007\/s10664-020-09857-0.pdf","content-type":"application\/pdf","content-version":"vor","intended-application":"similarity-checking"}],"deposited":{"date-parts":[[2021,8,25]],"date-time":"2021-08-25T23:53:05Z","timestamp":1629935585000},"score":1,"resource":{"primary":{"URL":"https:\/\/link.springer.com\/10.1007\/s10664-020-09857-0"}},"subtitle":[],"short-title":[],"issued":{"date-parts":[[2020,8,26]]},"references-count":41,"journal-issue":{"issue":"5","published-print":{"date-parts":[[2020,9]]}},"alternative-id":["9857"],"URL":"https:\/\/doi.org\/10.1007\/s10664-020-09857-0","relation":{},"ISSN":["1382-3256","1573-7616"],"issn-type":[{"type":"print","value":"1382-3256"},{"type":"electronic","value":"1573-7616"}],"subject":[],"published":{"date-parts":[[2020,8,26]]},"assertion":[{"value":"26 August 2020","order":1,"name":"first_online","label":"First Online","group":{"name":"ArticleHistory","label":"Article History"}}]}}