{"id":"https://openalex.org/W2947988714","doi":"https://doi.org/10.1109/tse.2019.2919304","title":"Enriching API Documentation with Code Samples and Usage Scenarios from Crowd Knowledge","display_name":"Enriching API Documentation with Code Samples and Usage Scenarios from Crowd Knowledge","publication_year":2019,"publication_date":"2019-05-27","ids":{"openalex":"https://openalex.org/W2947988714","doi":"https://doi.org/10.1109/tse.2019.2919304","mag":"2947988714"},"language":"en","primary_location":{"id":"doi:10.1109/tse.2019.2919304","is_oa":false,"landing_page_url":"https://doi.org/10.1109/tse.2019.2919304","pdf_url":null,"source":{"id":"https://openalex.org/S8351582","display_name":"IEEE Transactions on Software Engineering","issn_l":"0098-5589","issn":["0098-5589","1939-3520","2326-3881"],"is_oa":false,"is_in_doaj":false,"is_core":true,"host_organization":"https://openalex.org/P4310320439","host_organization_name":"IEEE Computer Society","host_organization_lineage":["https://openalex.org/P4310320439","https://openalex.org/P4310319808"],"host_organization_lineage_names":["IEEE Computer Society","Institute of Electrical and Electronics Engineers"],"type":"journal"},"license":null,"license_id":null,"version":"publishedVersion","is_accepted":true,"is_published":true,"raw_source_name":"IEEE Transactions on Software Engineering","raw_type":"journal-article"},"type":"article","indexed_in":["crossref"],"open_access":{"is_oa":false,"oa_status":"closed","oa_url":null,"any_repository_has_fulltext":false},"authorships":[{"author_position":"first","author":{"id":"https://openalex.org/A5005439960","display_name":"Jingxuan Zhang","orcid":"https://orcid.org/0000-0002-8437-6640"},"institutions":[{"id":"https://openalex.org/I9842412","display_name":"Nanjing University of Aeronautics and Astronautics","ror":"https://ror.org/01scyh794","country_code":"CN","type":"education","lineage":["https://openalex.org/I9842412"]}],"countries":["CN"],"is_corresponding":false,"raw_author_name":"Jingxuan Zhang","raw_affiliation_strings":["College of Computer Science and Technology, Nanjing University of Aeronautics and Astronautics, Nanjing, Jiangsu, China"],"raw_orcid":"https://orcid.org/0000-0002-8437-6640","affiliations":[{"raw_affiliation_string":"College of Computer Science and Technology, Nanjing University of Aeronautics and Astronautics, Nanjing, Jiangsu, China","institution_ids":["https://openalex.org/I9842412"]}]},{"author_position":"middle","author":{"id":"https://openalex.org/A5002119636","display_name":"He Jiang","orcid":"https://orcid.org/0000-0001-8674-4948"},"institutions":[{"id":"https://openalex.org/I125839683","display_name":"Beijing Institute of Technology","ror":"https://ror.org/01skt4w74","country_code":"CN","type":"education","lineage":["https://openalex.org/I125839683","https://openalex.org/I890469752"]},{"id":"https://openalex.org/I27357992","display_name":"Dalian University of Technology","ror":"https://ror.org/023hj5876","country_code":"CN","type":"education","lineage":["https://openalex.org/I27357992"]}],"countries":["CN"],"is_corresponding":false,"raw_author_name":"He Jiang","raw_affiliation_strings":["Dalian University of Technology, Dalian, Liaoning, China","Beijing Institute of Technology, Beijing, China"],"raw_orcid":"https://orcid.org/0000-0001-8674-4948","affiliations":[{"raw_affiliation_string":"Dalian University of Technology, Dalian, Liaoning, China","institution_ids":["https://openalex.org/I27357992"]},{"raw_affiliation_string":"Beijing Institute of Technology, Beijing, China","institution_ids":["https://openalex.org/I125839683"]}]},{"author_position":"middle","author":{"id":"https://openalex.org/A5108246345","display_name":"Zhilei Ren","orcid":null},"institutions":[{"id":"https://openalex.org/I27357992","display_name":"Dalian University of Technology","ror":"https://ror.org/023hj5876","country_code":"CN","type":"education","lineage":["https://openalex.org/I27357992"]}],"countries":["CN"],"is_corresponding":false,"raw_author_name":"Zhilei Ren","raw_affiliation_strings":["School of Software, Dalian University of Technology, Dalian, Liaoning, China"],"raw_orcid":null,"affiliations":[{"raw_affiliation_string":"School of Software, Dalian University of Technology, Dalian, Liaoning, China","institution_ids":["https://openalex.org/I27357992"]}]},{"author_position":"middle","author":{"id":"https://openalex.org/A5100375823","display_name":"Tao Zhang","orcid":"https://orcid.org/0000-0002-6272-4069"},"institutions":[{"id":"https://openalex.org/I151727225","display_name":"Harbin Engineering University","ror":"https://ror.org/03x80pn82","country_code":"CN","type":"education","lineage":["https://openalex.org/I151727225"]}],"countries":["CN"],"is_corresponding":false,"raw_author_name":"Tao Zhang","raw_affiliation_strings":["College of Computer Science and Technology, Harbin Engineering University, Harbin, Heilongjiang, China"],"raw_orcid":"https://orcid.org/0000-0002-6272-4069","affiliations":[{"raw_affiliation_string":"College of Computer Science and Technology, Harbin Engineering University, Harbin, Heilongjiang, China","institution_ids":["https://openalex.org/I151727225"]}]},{"author_position":"last","author":{"id":"https://openalex.org/A5025184050","display_name":"Zhiqiu Huang","orcid":"https://orcid.org/0000-0001-6843-1892"},"institutions":[{"id":"https://openalex.org/I9842412","display_name":"Nanjing University of Aeronautics and Astronautics","ror":"https://ror.org/01scyh794","country_code":"CN","type":"education","lineage":["https://openalex.org/I9842412"]}],"countries":["CN"],"is_corresponding":false,"raw_author_name":"Zhiqiu Huang","raw_affiliation_strings":["College of Computer Science and Technology, Nanjing University of Aeronautics and Astronautics, Nanjing, Jiangsu, China"],"raw_orcid":"https://orcid.org/0000-0001-6843-1892","affiliations":[{"raw_affiliation_string":"College of Computer Science and Technology, Nanjing University of Aeronautics and Astronautics, Nanjing, Jiangsu, China","institution_ids":["https://openalex.org/I9842412"]}]}],"institutions":[],"countries_distinct_count":1,"institutions_distinct_count":4,"corresponding_author_ids":[],"corresponding_institution_ids":[],"apc_list":null,"apc_paid":null,"fwci":6.8885,"has_fulltext":false,"cited_by_count":32,"citation_normalized_percentile":{"value":0.9693334,"is_in_top_1_percent":false,"is_in_top_10_percent":true},"cited_by_percentile_year":{"min":94,"max":99},"biblio":{"volume":"47","issue":"6","first_page":"1299","last_page":"1314"},"is_retracted":false,"is_paratext":false,"is_xpac":false,"primary_topic":{"id":"https://openalex.org/T10260","display_name":"Software Engineering Research","score":0.9995999932289124,"subfield":{"id":"https://openalex.org/subfields/1710","display_name":"Information Systems"},"field":{"id":"https://openalex.org/fields/17","display_name":"Computer Science"},"domain":{"id":"https://openalex.org/domains/3","display_name":"Physical Sciences"}},"topics":[{"id":"https://openalex.org/T10260","display_name":"Software Engineering Research","score":0.9995999932289124,"subfield":{"id":"https://openalex.org/subfields/1710","display_name":"Information Systems"},"field":{"id":"https://openalex.org/fields/17","display_name":"Computer Science"},"domain":{"id":"https://openalex.org/domains/3","display_name":"Physical Sciences"}},{"id":"https://openalex.org/T11704","display_name":"Mobile Crowdsensing and Crowdsourcing","score":0.993399977684021,"subfield":{"id":"https://openalex.org/subfields/1706","display_name":"Computer Science Applications"},"field":{"id":"https://openalex.org/fields/17","display_name":"Computer Science"},"domain":{"id":"https://openalex.org/domains/3","display_name":"Physical Sciences"}},{"id":"https://openalex.org/T11675","display_name":"Open Source Software Innovations","score":0.9789999723434448,"subfield":{"id":"https://openalex.org/subfields/1706","display_name":"Computer Science Applications"},"field":{"id":"https://openalex.org/fields/17","display_name":"Computer Science"},"domain":{"id":"https://openalex.org/domains/3","display_name":"Physical Sciences"}}],"keywords":[{"id":"https://openalex.org/keywords/computer-science","display_name":"Computer science","score":0.8568211793899536},{"id":"https://openalex.org/keywords/documentation","display_name":"Documentation","score":0.8139740824699402},{"id":"https://openalex.org/keywords/application-programming-interface","display_name":"Application programming interface","score":0.7253401875495911},{"id":"https://openalex.org/keywords/correctness","display_name":"Correctness","score":0.6692525148391724},{"id":"https://openalex.org/keywords/java","display_name":"Java","score":0.5447609424591064},{"id":"https://openalex.org/keywords/code","display_name":"Code (set theory)","score":0.4828677475452423},{"id":"https://openalex.org/keywords/usability","display_name":"Usability","score":0.4716041684150696},{"id":"https://openalex.org/keywords/software-documentation","display_name":"Software documentation","score":0.46951693296432495},{"id":"https://openalex.org/keywords/source-code","display_name":"Source code","score":0.46832019090652466},{"id":"https://openalex.org/keywords/android","display_name":"Android (operating system)","score":0.44093963503837585},{"id":"https://openalex.org/keywords/internal-documentation","display_name":"Internal documentation","score":0.4365394711494446},{"id":"https://openalex.org/keywords/programming-language","display_name":"Programming language","score":0.4243784546852112},{"id":"https://openalex.org/keywords/database","display_name":"Database","score":0.4180339276790619},{"id":"https://openalex.org/keywords/world-wide-web","display_name":"World Wide Web","score":0.3346157670021057},{"id":"https://openalex.org/keywords/operating-system","display_name":"Operating system","score":0.21273165941238403},{"id":"https://openalex.org/keywords/software","display_name":"Software","score":0.2010478973388672},{"id":"https://openalex.org/keywords/software-development","display_name":"Software development","score":0.17238518595695496},{"id":"https://openalex.org/keywords/software-development-process","display_name":"Software development process","score":0.0745023787021637},{"id":"https://openalex.org/keywords/software-construction","display_name":"Software construction","score":0.07403427362442017}],"concepts":[{"id":"https://openalex.org/C41008148","wikidata":"https://www.wikidata.org/wiki/Q21198","display_name":"Computer science","level":0,"score":0.8568211793899536},{"id":"https://openalex.org/C56666940","wikidata":"https://www.wikidata.org/wiki/Q788790","display_name":"Documentation","level":2,"score":0.8139740824699402},{"id":"https://openalex.org/C99613125","wikidata":"https://www.wikidata.org/wiki/Q165194","display_name":"Application programming interface","level":2,"score":0.7253401875495911},{"id":"https://openalex.org/C55439883","wikidata":"https://www.wikidata.org/wiki/Q360812","display_name":"Correctness","level":2,"score":0.6692525148391724},{"id":"https://openalex.org/C548217200","wikidata":"https://www.wikidata.org/wiki/Q251","display_name":"Java","level":2,"score":0.5447609424591064},{"id":"https://openalex.org/C2776760102","wikidata":"https://www.wikidata.org/wiki/Q5139990","display_name":"Code (set theory)","level":3,"score":0.4828677475452423},{"id":"https://openalex.org/C170130773","wikidata":"https://www.wikidata.org/wiki/Q216378","display_name":"Usability","level":2,"score":0.4716041684150696},{"id":"https://openalex.org/C81587897","wikidata":"https://www.wikidata.org/wiki/Q181702","display_name":"Software documentation","level":5,"score":0.46951693296432495},{"id":"https://openalex.org/C43126263","wikidata":"https://www.wikidata.org/wiki/Q128751","display_name":"Source code","level":2,"score":0.46832019090652466},{"id":"https://openalex.org/C557433098","wikidata":"https://www.wikidata.org/wiki/Q94","display_name":"Android (operating system)","level":2,"score":0.44093963503837585},{"id":"https://openalex.org/C140396857","wikidata":"https://www.wikidata.org/wiki/Q16934771","display_name":"Internal documentation","level":5,"score":0.4365394711494446},{"id":"https://openalex.org/C199360897","wikidata":"https://www.wikidata.org/wiki/Q9143","display_name":"Programming language","level":1,"score":0.4243784546852112},{"id":"https://openalex.org/C77088390","wikidata":"https://www.wikidata.org/wiki/Q8513","display_name":"Database","level":1,"score":0.4180339276790619},{"id":"https://openalex.org/C136764020","wikidata":"https://www.wikidata.org/wiki/Q466","display_name":"World Wide Web","level":1,"score":0.3346157670021057},{"id":"https://openalex.org/C111919701","wikidata":"https://www.wikidata.org/wiki/Q9135","display_name":"Operating system","level":1,"score":0.21273165941238403},{"id":"https://openalex.org/C2777904410","wikidata":"https://www.wikidata.org/wiki/Q7397","display_name":"Software","level":2,"score":0.2010478973388672},{"id":"https://openalex.org/C529173508","wikidata":"https://www.wikidata.org/wiki/Q638608","display_name":"Software development","level":3,"score":0.17238518595695496},{"id":"https://openalex.org/C180152950","wikidata":"https://www.wikidata.org/wiki/Q2904257","display_name":"Software development process","level":4,"score":0.0745023787021637},{"id":"https://openalex.org/C186846655","wikidata":"https://www.wikidata.org/wiki/Q3398377","display_name":"Software construction","level":4,"score":0.07403427362442017},{"id":"https://openalex.org/C177264268","wikidata":"https://www.wikidata.org/wiki/Q1514741","display_name":"Set (abstract data type)","level":2,"score":0.0}],"mesh":[],"locations_count":1,"locations":[{"id":"doi:10.1109/tse.2019.2919304","is_oa":false,"landing_page_url":"https://doi.org/10.1109/tse.2019.2919304","pdf_url":null,"source":{"id":"https://openalex.org/S8351582","display_name":"IEEE Transactions on Software Engineering","issn_l":"0098-5589","issn":["0098-5589","1939-3520","2326-3881"],"is_oa":false,"is_in_doaj":false,"is_core":true,"host_organization":"https://openalex.org/P4310320439","host_organization_name":"IEEE Computer Society","host_organization_lineage":["https://openalex.org/P4310320439","https://openalex.org/P4310319808"],"host_organization_lineage_names":["IEEE Computer Society","Institute of Electrical and Electronics Engineers"],"type":"journal"},"license":null,"license_id":null,"version":"publishedVersion","is_accepted":true,"is_published":true,"raw_source_name":"IEEE Transactions on Software Engineering","raw_type":"journal-article"}],"best_oa_location":null,"sustainable_development_goals":[{"score":0.4300000071525574,"id":"https://metadata.un.org/sdg/8","display_name":"Decent work and economic growth"},{"score":0.4000000059604645,"id":"https://metadata.un.org/sdg/9","display_name":"Industry, innovation and infrastructure"}],"awards":[{"id":"https://openalex.org/G1958249691","display_name":null,"funder_award_id":"2018YFB1003900","funder_id":"https://openalex.org/F4320335777","funder_display_name":"National Key Research and Development Program of China"},{"id":"https://openalex.org/G2730748290","display_name":null,"funder_award_id":"61722202","funder_id":"https://openalex.org/F4320321001","funder_display_name":"National Natural Science Foundation of China"},{"id":"https://openalex.org/G4060891823","display_name":null,"funder_award_id":"61602258","funder_id":"https://openalex.org/F4320321001","funder_display_name":"National Natural Science Foundation of China"},{"id":"https://openalex.org/G5380116598","display_name":null,"funder_award_id":"2017M621247","funder_id":"https://openalex.org/F4320321543","funder_display_name":"China Postdoctoral Science Foundation"}],"funders":[{"id":"https://openalex.org/F4320321001","display_name":"National Natural Science Foundation of China","ror":"https://ror.org/01h0zpd94"},{"id":"https://openalex.org/F4320321543","display_name":"China Postdoctoral Science Foundation","ror":"https://ror.org/0426zh255"},{"id":"https://openalex.org/F4320335777","display_name":"National Key Research and Development Program of China","ror":null}],"has_content":{"grobid_xml":false,"pdf":false},"content_urls":null,"referenced_works_count":60,"referenced_works":["https://openalex.org/W1884204318","https://openalex.org/W1975296856","https://openalex.org/W1975976188","https://openalex.org/W1998549095","https://openalex.org/W2003343927","https://openalex.org/W2003468239","https://openalex.org/W2008107570","https://openalex.org/W2009957868","https://openalex.org/W2014577207","https://openalex.org/W2026003524","https://openalex.org/W2050372846","https://openalex.org/W2051204868","https://openalex.org/W2097001189","https://openalex.org/W2100310705","https://openalex.org/W2107376583","https://openalex.org/W2108632968","https://openalex.org/W2114739320","https://openalex.org/W2115130131","https://openalex.org/W2122156963","https://openalex.org/W2123333323","https://openalex.org/W2147743860","https://openalex.org/W2154221125","https://openalex.org/W2154706669","https://openalex.org/W2164803710","https://openalex.org/W2165232124","https://openalex.org/W2165739648","https://openalex.org/W2166069603","https://openalex.org/W2167180295","https://openalex.org/W2197753807","https://openalex.org/W2246822044","https://openalex.org/W2342696155","https://openalex.org/W2366278923","https://openalex.org/W2366532918","https://openalex.org/W2394783112","https://openalex.org/W2400051121","https://openalex.org/W2402619042","https://openalex.org/W2476494490","https://openalex.org/W2510315298","https://openalex.org/W2546999186","https://openalex.org/W2548718128","https://openalex.org/W2573790273","https://openalex.org/W2593635859","https://openalex.org/W2735173242","https://openalex.org/W2773151081","https://openalex.org/W2793943299","https://openalex.org/W2795562547","https://openalex.org/W2810627707","https://openalex.org/W2888017562","https://openalex.org/W2963900765","https://openalex.org/W2964315653","https://openalex.org/W3098688226","https://openalex.org/W3100105221","https://openalex.org/W3103506234","https://openalex.org/W3125137594","https://openalex.org/W3147698126","https://openalex.org/W4293868045","https://openalex.org/W6651169554","https://openalex.org/W6713073691","https://openalex.org/W6725674429","https://openalex.org/W6732348001"],"related_works":["https://openalex.org/W2646159910","https://openalex.org/W4244946961","https://openalex.org/W2767775279","https://openalex.org/W2739693438","https://openalex.org/W2896566650","https://openalex.org/W2073875337","https://openalex.org/W3188888451","https://openalex.org/W2077694039","https://openalex.org/W4386043245","https://openalex.org/W2791817847"],"abstract_inverted_index":{"As":[0],"one":[1],"key":[2],"resource":[3],"to":[4,35,51,71,152,156],"learn":[5],"Application":[6],"Programming":[7],"Interfaces":[8],"(APIs),":[9],"a":[10,79,102,120,245],"lot":[11],"of":[12,58,67,112,175,201,211,221,231,263,266,272],"API":[13,37,86,116,169,177,182,196,253,267,283,287],"reference":[14],"documentation":[15,38,87,170,183,268,288],"lacks":[16],"code":[17,40,44,61,69,89,121,147,202,212,233],"samples":[18,41,62,70,90,148,203,213,234],"with":[19,28,39,88],"usage":[20,72,93,140,154],"scenarios,":[21],"thus":[22],"heavily":[23],"hindering":[24],"developers":[25,130,273,291],"from":[26,42,99],"programming":[27,298],"APIs.":[29],"Although":[30],"researchers":[31],"have":[32],"investigated":[33],"how":[34],"enrich":[36],"general":[43],"search":[45],"engines,":[46],"two":[47],"main":[48],"challenges":[49],"remain":[50],"be":[52],"resolved,":[53],"including":[54],"the":[55,64,124,135,138,158,164,173,180,194,199,215,227,249,261,270,278,281,285,302],"quality":[56,200],"challenge":[57,66],"acquiring":[59],"high-quality":[60,146],"and":[63,91,106,131,149,167,186,224,238,242,280,294,300,308],"mapping":[65],"matching":[68],"scenarios.":[73],"In":[74,255],"this":[75],"study,":[76],"we":[77],"propose":[78],"novel":[80],"approach":[81,217],"named":[82],"ADECK":[83,143,206,237],"towards":[84,133],"enriching":[85],"corresponding":[92,153],"scenarios":[94,155],"by":[95,129,205,214,236,306],"leveraging":[96],"crowd":[97],"knowledge":[98],"Stack":[100],"Overflow,":[101],"popular":[103],"technical":[104],"Question":[105],"Answer":[107],"(Q&A)":[108],"website":[109],"attracting":[110],"millions":[111],"developers.":[113],"Given":[114],"an":[115,257],"related":[117],"Q&A":[118],"pair,":[119],"sample":[122],"in":[123,179,193,219,248],"answer":[125],"is":[126,184,207],"extensively":[127],"evaluated":[128],"targeted":[132],"resolving":[134],"question":[136],"under":[137],"specified":[139],"scenario.":[141],"Hence,":[142],"can":[144,289],"obtain":[145],"map":[150],"them":[151],"address":[157],"above":[159],"challenges.":[160],"Extensive":[161],"experiments":[162],"on":[163,244,269],"Java":[165,251],"SE":[166,252],"Android":[168],"show":[171],"that":[172,192,210],"number":[174],"code-sample-illustrated":[176],"types":[178,265],"ADECK-enriched":[181,286],"3.35":[185],"5.76":[187],"times":[188],"as":[189,191],"many":[190],"raw":[195,279],"documentation.":[197,254],"Meanwhile,":[198],"obtained":[204,235],"better":[208],"than":[209],"baseline":[216],"eXoaDocs":[218,239],"terms":[220],"correctness,":[222],"conciseness,":[223],"usability,":[225],"e.g.,":[226],"average":[228,303],"correctness":[229],"values":[230],"representative":[232],"are":[240],"4.26":[241],"3.28":[243],"5-point":[246],"scale":[247],"enriched":[250],"addition,":[256],"empirical":[258],"study":[259],"investigating":[260],"impacts":[262],"different":[264],"productivity":[271],"shows":[274],"that,":[275],"compared":[276],"against":[277],"eXoaDocs-enriched":[282],"documentation,":[284],"help":[290],"complete":[292],"23.81":[293],"14.29":[295],"percent":[296],"more":[297],"tasks":[299],"reduce":[301],"completion":[304],"time":[305],"9.43":[307],"11.03":[309],"percent.":[310]},"counts_by_year":[{"year":2026,"cited_by_count":1},{"year":2025,"cited_by_count":2},{"year":2024,"cited_by_count":4},{"year":2023,"cited_by_count":5},{"year":2022,"cited_by_count":5},{"year":2021,"cited_by_count":9},{"year":2020,"cited_by_count":6}],"updated_date":"2026-01-28T23:14:49.684275","created_date":"2025-10-10T00:00:00"}