{"id":"https://openalex.org/W3117828107","doi":"https://doi.org/10.1109/tse.2020.3047088","title":"Requirements of API Documentation: A Case Study into Computer Vision Services","display_name":"Requirements of API Documentation: A Case Study into Computer Vision Services","publication_year":2020,"publication_date":"2020-12-24","ids":{"openalex":"https://openalex.org/W3117828107","doi":"https://doi.org/10.1109/tse.2020.3047088","mag":"3117828107"},"language":"en","primary_location":{"is_oa":false,"landing_page_url":"https://doi.org/10.1109/tse.2020.3047088","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":null,"is_accepted":false,"is_published":false},"type":"article","type_crossref":"journal-article","indexed_in":["arxiv","crossref","datacite"],"open_access":{"is_oa":true,"oa_status":"green","oa_url":"https://arxiv.org/pdf/2012.13728","any_repository_has_fulltext":true},"authorships":[{"author_position":"first","author":{"id":"https://openalex.org/A5075031745","display_name":"Alex Cummaudo","orcid":"https://orcid.org/0000-0001-7878-6283"},"institutions":[{"id":"https://openalex.org/I149704539","display_name":"Deakin University","ror":"https://ror.org/02czsnj07","country_code":"AU","type":"education","lineage":["https://openalex.org/I149704539"]}],"countries":["AU"],"is_corresponding":false,"raw_author_name":"Alex Cummaudo","raw_affiliation_strings":["Applied Artificial Intelligence Institute, Deakin University, Geelong, VIC, Australia"],"affiliations":[{"raw_affiliation_string":"Applied Artificial Intelligence Institute, Deakin University, Geelong, VIC, Australia","institution_ids":["https://openalex.org/I149704539"]}]},{"author_position":"middle","author":{"id":"https://openalex.org/A5030486012","display_name":"Rajesh Vasa","orcid":"https://orcid.org/0000-0003-4805-1467"},"institutions":[{"id":"https://openalex.org/I149704539","display_name":"Deakin University","ror":"https://ror.org/02czsnj07","country_code":"AU","type":"education","lineage":["https://openalex.org/I149704539"]}],"countries":["AU"],"is_corresponding":false,"raw_author_name":"Rajesh Vasa","raw_affiliation_strings":["Applied Artificial Intelligence Institute, Deakin University, Geelong, VIC, Australia"],"affiliations":[{"raw_affiliation_string":"Applied Artificial Intelligence Institute, Deakin University, Geelong, VIC, Australia","institution_ids":["https://openalex.org/I149704539"]}]},{"author_position":"middle","author":{"id":"https://openalex.org/A5082913979","display_name":"John Grundy","orcid":"https://orcid.org/0000-0003-4928-7076"},"institutions":[{"id":"https://openalex.org/I56590836","display_name":"Monash University","ror":"https://ror.org/02bfwt286","country_code":"AU","type":"education","lineage":["https://openalex.org/I56590836"]}],"countries":["AU"],"is_corresponding":false,"raw_author_name":"John Grundy","raw_affiliation_strings":["Faculty of Information Technology, Monash University, Clayton, VIC, Australia"],"affiliations":[{"raw_affiliation_string":"Faculty of Information Technology, Monash University, Clayton, VIC, Australia","institution_ids":["https://openalex.org/I56590836"]}]},{"author_position":"last","author":{"id":"https://openalex.org/A5068173669","display_name":"Mohamed Abdelrazek","orcid":"https://orcid.org/0000-0003-3812-9785"},"institutions":[{"id":"https://openalex.org/I149704539","display_name":"Deakin University","ror":"https://ror.org/02czsnj07","country_code":"AU","type":"education","lineage":["https://openalex.org/I149704539"]}],"countries":["AU"],"is_corresponding":false,"raw_author_name":"Mohamed Abdelrazek","raw_affiliation_strings":["School of Information Technology, Deakin University, Geelong, VIC, Australia"],"affiliations":[{"raw_affiliation_string":"School of Information Technology, Deakin University, Geelong, VIC, Australia","institution_ids":["https://openalex.org/I149704539"]}]}],"institution_assertions":[],"countries_distinct_count":1,"institutions_distinct_count":2,"corresponding_author_ids":[],"corresponding_institution_ids":[],"apc_list":null,"apc_paid":null,"fwci":1.065,"has_fulltext":true,"fulltext_origin":"pdf","cited_by_count":6,"citation_normalized_percentile":{"value":0.853588,"is_in_top_1_percent":false,"is_in_top_10_percent":false},"cited_by_percentile_year":{"min":81,"max":82},"biblio":{"volume":"48","issue":"6","first_page":"2010","last_page":"2027"},"is_retracted":false,"is_paratext":false,"primary_topic":{"id":"https://openalex.org/T10260","display_name":"Software Engineering Research","score":0.9994,"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.9994,"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/T12127","display_name":"Software System Performance and Reliability","score":0.9986,"subfield":{"id":"https://openalex.org/subfields/1705","display_name":"Computer Networks and Communications"},"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/T10430","display_name":"Software Engineering Techniques and Practices","score":0.9813,"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"}}],"keywords":[{"id":"https://openalex.org/keywords/application-programming-interface","display_name":"Application programming interface","score":0.62440133},{"id":"https://openalex.org/keywords/software-documentation","display_name":"Software documentation","score":0.48722544}],"concepts":[{"id":"https://openalex.org/C56666940","wikidata":"https://www.wikidata.org/wiki/Q788790","display_name":"Documentation","level":2,"score":0.90819323},{"id":"https://openalex.org/C41008148","wikidata":"https://www.wikidata.org/wiki/Q21198","display_name":"Computer science","level":0,"score":0.75775516},{"id":"https://openalex.org/C99613125","wikidata":"https://www.wikidata.org/wiki/Q165194","display_name":"Application programming interface","level":2,"score":0.62440133},{"id":"https://openalex.org/C136764020","wikidata":"https://www.wikidata.org/wiki/Q466","display_name":"World Wide Web","level":1,"score":0.5496092},{"id":"https://openalex.org/C115903868","wikidata":"https://www.wikidata.org/wiki/Q80993","display_name":"Software engineering","level":1,"score":0.5019524},{"id":"https://openalex.org/C2777904410","wikidata":"https://www.wikidata.org/wiki/Q7397","display_name":"Software","level":2,"score":0.49716404},{"id":"https://openalex.org/C81587897","wikidata":"https://www.wikidata.org/wiki/Q181702","display_name":"Software documentation","level":5,"score":0.48722544},{"id":"https://openalex.org/C79974875","wikidata":"https://www.wikidata.org/wiki/Q483639","display_name":"Cloud computing","level":2,"score":0.4644086},{"id":"https://openalex.org/C529173508","wikidata":"https://www.wikidata.org/wiki/Q638608","display_name":"Software development","level":3,"score":0.33740735},{"id":"https://openalex.org/C180152950","wikidata":"https://www.wikidata.org/wiki/Q2904257","display_name":"Software development process","level":4,"score":0.23160931},{"id":"https://openalex.org/C111919701","wikidata":"https://www.wikidata.org/wiki/Q9135","display_name":"Operating system","level":1,"score":0.08299771}],"mesh":[],"locations_count":3,"locations":[{"is_oa":false,"landing_page_url":"https://doi.org/10.1109/tse.2020.3047088","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":null,"is_accepted":false,"is_published":false},{"is_oa":true,"landing_page_url":"https://arxiv.org/abs/2012.13728","pdf_url":"https://arxiv.org/pdf/2012.13728","source":{"id":"https://openalex.org/S4306400194","display_name":"arXiv (Cornell University)","issn_l":null,"issn":null,"is_oa":true,"is_in_doaj":false,"is_core":false,"host_organization":"https://openalex.org/I205783295","host_organization_name":"Cornell University","host_organization_lineage":["https://openalex.org/I205783295"],"host_organization_lineage_names":["Cornell University"],"type":"repository"},"license":null,"license_id":null,"version":"submittedVersion","is_accepted":false,"is_published":false},{"is_oa":false,"landing_page_url":"https://api.datacite.org/dois/10.48550/arxiv.2012.13728","pdf_url":null,"source":{"id":"https://openalex.org/S4393179698","display_name":"DataCite API","issn_l":null,"issn":null,"is_oa":true,"is_in_doaj":false,"is_core":false,"host_organization":"https://openalex.org/I4210145204","host_organization_name":"DataCite","host_organization_lineage":["https://openalex.org/I4210145204"],"host_organization_lineage_names":["DataCite"],"type":"metadata"},"license":null,"license_id":null,"version":null}],"best_oa_location":{"is_oa":true,"landing_page_url":"https://arxiv.org/abs/2012.13728","pdf_url":"https://arxiv.org/pdf/2012.13728","source":{"id":"https://openalex.org/S4306400194","display_name":"arXiv (Cornell University)","issn_l":null,"issn":null,"is_oa":true,"is_in_doaj":false,"is_core":false,"host_organization":"https://openalex.org/I205783295","host_organization_name":"Cornell University","host_organization_lineage":["https://openalex.org/I205783295"],"host_organization_lineage_names":["Cornell University"],"type":"repository"},"license":null,"license_id":null,"version":"submittedVersion","is_accepted":false,"is_published":false},"sustainable_development_goals":[{"display_name":"Industry, innovation and infrastructure","score":0.61,"id":"https://metadata.un.org/sdg/9"}],"grants":[],"datasets":[],"versions":["https://openalex.org/W3117828107"],"referenced_works_count":64,"referenced_works":["https://openalex.org/W1493852950","https://openalex.org/W154166809","https://openalex.org/W1566585837","https://openalex.org/W1602028541","https://openalex.org/W171406816","https://openalex.org/W19399978","https://openalex.org/W1969429349","https://openalex.org/W1988264842","https://openalex.org/W1990693033","https://openalex.org/W1991613282","https://openalex.org/W2006580360","https://openalex.org/W2008107570","https://openalex.org/W2014817805","https://openalex.org/W2016650943","https://openalex.org/W2034628356","https://openalex.org/W2035042871","https://openalex.org/W2052281826","https://openalex.org/W2063085086","https://openalex.org/W2063086899","https://openalex.org/W2065818484","https://openalex.org/W2073875337","https://openalex.org/W2103177132","https://openalex.org/W2112198760","https://openalex.org/W2118328848","https://openalex.org/W2123333323","https://openalex.org/W2128961774","https://openalex.org/W2143445997","https://openalex.org/W2155243985","https://openalex.org/W2162300032","https://openalex.org/W2164777277","https://openalex.org/W2252211299","https://openalex.org/W2395092677","https://openalex.org/W2470712504","https://openalex.org/W2513125375","https://openalex.org/W2574271863","https://openalex.org/W2582743722","https://openalex.org/W2608583225","https://openalex.org/W2613159689","https://openalex.org/W2735864825","https://openalex.org/W2739693438","https://openalex.org/W2767563557","https://openalex.org/W2773763890","https://openalex.org/W2794744449","https://openalex.org/W2888940765","https://openalex.org/W2896566650","https://openalex.org/W2908265642","https://openalex.org/W2955439455","https://openalex.org/W2980990204","https://openalex.org/W2992625786","https://openalex.org/W3013745307","https://openalex.org/W3091048166","https://openalex.org/W3123164564","https://openalex.org/W3123186970","https://openalex.org/W4213388807","https://openalex.org/W4214443","https://openalex.org/W4229496713","https://openalex.org/W4244946961","https://openalex.org/W4244994171","https://openalex.org/W4245013494","https://openalex.org/W4246085474","https://openalex.org/W4247280291","https://openalex.org/W4289219086","https://openalex.org/W4297802021","https://openalex.org/W4399547459"],"related_works":["https://openalex.org/W4244946961","https://openalex.org/W2955439455","https://openalex.org/W2915114672","https://openalex.org/W2884925033","https://openalex.org/W2764664989","https://openalex.org/W2411980894","https://openalex.org/W2073875337","https://openalex.org/W2070076995","https://openalex.org/W2033083755","https://openalex.org/W1975647310"],"abstract_inverted_index":{"Using":[0],"cloud-based":[1],"computer":[2,139],"vision":[3,140],"services":[4],"is":[5,44,56],"gaining":[6],"traction,":[7],"where":[8,153,165],"developers":[9,104],"access":[10],"AI-powered":[11],"components":[12],"through":[13,132],"familiar":[14,35],"RESTful":[15],"APIs,":[16],"not":[17,45,130,160],"needing":[18],"to":[19,36,48,88,108,118,172,183],"orchestrate":[20],"large":[21],"training":[22,28],"and":[23,42,163,191],"inference":[24],"infrastructures":[25],"or":[26,128],"curate/label":[27],"datasets.":[29],"However,":[30],"while":[31],"these":[32,52,124],"APIs":[33],"seem":[34],"use,":[37],"their":[38,175],"non-deterministic":[39],"run-time":[40],"behaviour":[41],"evolution":[43],"adequately":[46],"communicated":[47],"developers.":[49],"Therefore,":[50],"improving":[51],"services'":[53],"API":[54,74,91,111,156],"documentation":[55,59,75,112,157,187],"paramount-more":[57],"extensive":[58],"facilitates":[60],"the":[61,137,149,192],"development":[62],"process":[63],"of":[64,84,105,115,123,155,181],"intelligent":[65,185],"software.":[66],"In":[67],"a":[68,82,133,179],"prior":[69],"study,":[70],"we":[71],"extracted":[72],"34":[73],"artefacts":[76,113,126,171],"from":[77],"21":[78],"seminal":[79],"works,":[80],"devising":[81],"taxonomy":[83],"five":[85],"key":[86],"requirements":[87],"produce":[89],"quality":[90],"documentation.":[92],"We":[93,143,177],"extend":[94],"this":[95],"study":[96,135],"in":[97,136,148],"two":[98],"ways.":[99],"Firstly,":[100],"by":[101],"surveying":[102],"104":[103],"varying":[106],"experience":[107],"understand":[109],"what":[110],"are":[114,127,129],"most":[116],"value":[117],"practitioners.":[119],"Secondly,":[120],"identifying":[121],"which":[122],"highly-valued":[125],"well-documented":[131],"case":[134],"emerging":[138],"service":[141],"domain.":[142],"identify:":[144],"(i)":[145],"several":[146],"gaps":[147],"software":[150,186],"engineering":[151],"literature,":[152],"aspects":[154],"understanding":[158],"is/is":[159],"extensively":[161],"investigated;":[162],"(ii)":[164],"industry":[166],"vendors":[167,190],"(in":[168],"contrast)":[169],"document":[170],"better":[173],"serve":[174],"end-developers.":[176],"provide":[178],"set":[180],"recommendations":[182],"enhance":[184],"for":[188],"both":[189],"wider":[193],"research":[194],"community.":[195]},"cited_by_api_url":"https://api.openalex.org/works?filter=cites:W3117828107","counts_by_year":[{"year":2024,"cited_by_count":2},{"year":2022,"cited_by_count":3},{"year":2021,"cited_by_count":1}],"updated_date":"2024-12-12T12:20:45.522336","created_date":"2021-01-05"}