{"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":{"id":"doi:10.1109/tse.2020.3047088","doi":"https://doi.org/10.1109/tse.2020.3047088","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,"listed_in":["anvur-scientific","ccf-a","cwts-core","dongbi-a","fnege-3","jufo-3","norway-2","poland-140","russia-white-list-1"],"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"},"volume":null,"type":"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","observed_orcids":["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"],"raw_orcid":"https://orcid.org/0000-0001-7878-6283","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","observed_orcids":["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"],"raw_orcid":"https://orcid.org/0000-0003-4805-1467","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","observed_orcids":["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"],"raw_orcid":"https://orcid.org/0000-0003-4928-7076","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","observed_orcids":["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"],"raw_orcid":"https://orcid.org/0000-0003-3812-9785","affiliations":[{"raw_affiliation_string":"School of Information Technology, Deakin University, Geelong, VIC, Australia","institution_ids":["https://openalex.org/I149704539"]}]}],"institutions":[],"countries_distinct_count":1,"institutions_distinct_count":2,"corresponding_author_ids":[],"corresponding_institution_ids":[],"apc_list":{"value":2045,"currency":"USD","value_usd":2045},"apc_paid":null,"fwci":0.9237,"has_fulltext":false,"cited_by_count":9,"citation_normalized_percentile":{"value":0.83934869,"is_in_top_1_percent":false,"is_in_top_10_percent":false},"cited_by_percentile_year":{"min":88,"max":96},"biblio":{"volume":"48","issue":"6","first_page":"2010","last_page":"2027"},"is_retracted":false,"is_paratext":false,"is_xpac":false,"primary_topic":{"id":"https://openalex.org/T10260","display_name":"Software Engineering Research","score":0.9848999977111816,"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.9848999977111816,"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/T10430","display_name":"Software Engineering Techniques and Practices","score":0.013100000098347664,"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/T10679","display_name":"Service-Oriented Architecture and Web Services","score":0.00039999998989515007,"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/api-documentation","display_name":"API documentation","score":0.9959999918937683},{"id":"https://openalex.org/keywords/documentation-requirements","display_name":"documentation requirements","score":0.7160000205039978},{"id":"https://openalex.org/keywords/rest-api","display_name":"REST API","score":0.9620000123977661},{"id":"https://openalex.org/keywords/developer-survey","display_name":"developer survey","score":0.6010000109672546},{"id":"https://openalex.org/keywords/api-evolution","display_name":"API evolution","score":0.625},{"id":"https://openalex.org/keywords/intelligent-software-systems","display_name":"intelligent software","score":0.6150000095367432}],"concepts":[{"id":"https://openalex.org/C56666940","wikidata":"https://www.wikidata.org/wiki/Q788790","display_name":"Documentation","level":2,"score":0.9081932306289673},{"id":"https://openalex.org/C41008148","wikidata":"https://www.wikidata.org/wiki/Q21198","display_name":"Computer science","level":0,"score":0.7577551603317261},{"id":"https://openalex.org/C99613125","wikidata":"https://www.wikidata.org/wiki/Q165194","display_name":"Application programming interface","level":2,"score":0.624401330947876},{"id":"https://openalex.org/C136764020","wikidata":"https://www.wikidata.org/wiki/Q466","display_name":"World Wide Web","level":1,"score":0.5496091842651367},{"id":"https://openalex.org/C115903868","wikidata":"https://www.wikidata.org/wiki/Q80993","display_name":"Software engineering","level":1,"score":0.5019524097442627},{"id":"https://openalex.org/C2777904410","wikidata":"https://www.wikidata.org/wiki/Q7397","display_name":"Software","level":2,"score":0.4971640408039093},{"id":"https://openalex.org/C81587897","wikidata":"https://www.wikidata.org/wiki/Q181702","display_name":"Software documentation","level":5,"score":0.4872254431247711},{"id":"https://openalex.org/C79974875","wikidata":"https://www.wikidata.org/wiki/Q483639","display_name":"Cloud computing","level":2,"score":0.46440860629081726},{"id":"https://openalex.org/C529173508","wikidata":"https://www.wikidata.org/wiki/Q638608","display_name":"Software development","level":3,"score":0.33740735054016113},{"id":"https://openalex.org/C180152950","wikidata":"https://www.wikidata.org/wiki/Q2904257","display_name":"Software development process","level":4,"score":0.2316093146800995},{"id":"https://openalex.org/C111919701","wikidata":"https://www.wikidata.org/wiki/Q9135","display_name":"Operating system","level":1,"score":0.08299770951271057}],"mesh":[],"locations_count":4,"locations":[{"id":"doi:10.1109/tse.2020.3047088","doi":"https://doi.org/10.1109/tse.2020.3047088","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,"listed_in":["anvur-scientific","ccf-a","cwts-core","dongbi-a","fnege-3","jufo-3","norway-2","poland-140","russia-white-list-1"],"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"},{"id":"pmh:oai:arXiv.org:2012.13728","doi":null,"is_oa":true,"landing_page_url":"http://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":"2331-8422","issn":["2331-8422"],"is_oa":true,"is_in_doaj":false,"is_core":false,"listed_in":[],"host_organization":"https://openalex.org/I205783295","host_organization_name":"Cornell University","host_organization_lineage":["https://openalex.org/I205783295"],"host_organization_lineage_names":[],"type":"repository"},"license":null,"license_id":null,"version":"submittedVersion","is_accepted":false,"is_published":false,"raw_source_name":null,"raw_type":"text"},{"id":"pmh:oai:figshare.com:article/20678627","doi":null,"is_oa":true,"landing_page_url":"https://figshare.com/articles/journal_contribution/Requirements_of_API_Documentation_A_Case_Study_into_Computer_Vision_Services/20678627","pdf_url":null,"source":{"id":"https://openalex.org/S4377196282","display_name":"Figshare","issn_l":null,"issn":null,"is_oa":false,"is_in_doaj":false,"is_core":false,"listed_in":[],"host_organization":"https://openalex.org/I4210132348","host_organization_name":"Figshare (United Kingdom)","host_organization_lineage":["https://openalex.org/I4210132348"],"host_organization_lineage_names":[],"type":"repository"},"license":"cc-by","license_id":"https://openalex.org/licenses/cc-by","version":"submittedVersion","is_accepted":false,"is_published":false,"raw_source_name":null,"raw_type":"Text"},{"id":"doi:10.48550/arxiv.2012.13728","doi":"https://doi.org/10.48550/arxiv.2012.13728","is_oa":true,"landing_page_url":"https://doi.org/10.48550/arxiv.2012.13728","pdf_url":null,"source":{"id":"https://openalex.org/S4306400194","display_name":"arXiv (Cornell University)","issn_l":"2331-8422","issn":["2331-8422"],"is_oa":true,"is_in_doaj":false,"is_core":false,"listed_in":[],"host_organization":"https://openalex.org/I205783295","host_organization_name":"Cornell University","host_organization_lineage":["https://openalex.org/I205783295"],"host_organization_lineage_names":[],"type":"repository"},"license":"cc-by","license_id":"https://openalex.org/licenses/cc-by","version":null,"is_accepted":false,"is_published":null,"raw_source_name":null,"raw_type":"article-journal"}],"best_oa_location":{"id":"pmh:oai:arXiv.org:2012.13728","doi":null,"is_oa":true,"landing_page_url":"http://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":"2331-8422","issn":["2331-8422"],"is_oa":true,"is_in_doaj":false,"is_core":false,"listed_in":[],"host_organization":"https://openalex.org/I205783295","host_organization_name":"Cornell University","host_organization_lineage":["https://openalex.org/I205783295"],"host_organization_lineage_names":[],"type":"repository"},"license":null,"license_id":null,"version":"submittedVersion","is_accepted":false,"is_published":false,"raw_source_name":null,"raw_type":"text"},"sustainable_development_goals":[],"sustainable_development_goals_aurora":[{"id":"https://metadata.un.org/sdg/9","score":0.6100000143051147,"display_name":"Industry, innovation and infrastructure"}],"study_designs":[],"awards":[],"funders":[{"id":"https://openalex.org/F4320315885","display_name":"Australian Government","ror":"https://ror.org/0314h5y94"},{"id":"https://openalex.org/F4320334704","display_name":"Australian Research Council","ror":"https://ror.org/05mmh0f86"}],"has_content":{"pdf":false,"grobid_xml":false},"content_urls":null,"referenced_works_count":62,"referenced_works":["https://openalex.org/W4214443","https://openalex.org/W19399978","https://openalex.org/W154166809","https://openalex.org/W171406816","https://openalex.org/W1493852950","https://openalex.org/W1566585837","https://openalex.org/W1602028541","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/W2950581917","https://openalex.org/W2955439455","https://openalex.org/W2965143859","https://openalex.org/W3003561622","https://openalex.org/W3013745307","https://openalex.org/W3091048166","https://openalex.org/W3123186970","https://openalex.org/W4213388807","https://openalex.org/W4229496713","https://openalex.org/W4244946961","https://openalex.org/W4244994171","https://openalex.org/W4245013494","https://openalex.org/W4246085474","https://openalex.org/W4289219086","https://openalex.org/W4399547459"],"related_works":["https://openalex.org/W1975647310","https://openalex.org/W2033083755","https://openalex.org/W2884925033","https://openalex.org/W2070076995","https://openalex.org/W2764664989","https://openalex.org/W2955439455","https://openalex.org/W2411980894","https://openalex.org/W4244946961","https://openalex.org/W2915114672","https://openalex.org/W2073875337"],"abstract_inverted_index":{"Using":[0],"cloud-based":[1],"computer":[2,135],"vision":[3,136],"services":[4],"is":[5,42,54],"gaining":[6],"traction,":[7],"where":[8,149,161],"developers":[9,102],"access":[10],"AI-powered":[11],"components":[12],"through":[13,128],"familiar":[14],"RESTful":[15],"APIs,":[16],"not":[17,43,126,156],"needing":[18],"to":[19,34,46,86,106,168,179],"orchestrate":[20],"large":[21],"training":[22,28],"and":[23,40,159,187],"inference":[24],"infrastructures":[25],"or":[26,124],"curate/label":[27],"datasets.":[29],"However,":[30],"while":[31],"these":[32,50,120],"APIsseemfamiliar":[33],"use,":[35],"their":[36,171],"non-deterministic":[37],"run-time":[38],"behaviour":[39],"evolution":[41],"adequately":[44],"communicated":[45],"developers.":[47],"Therefore,":[48],"improving":[49],"services\u2019":[51],"API":[52,72,89,109,152],"documentation":[53,57,73,110,153,183],"paramount\u2014more":[55],"extensive":[56],"facilitates":[58],"the":[59,133,145,188],"development":[60],"process":[61],"of":[62,82,103,119,151,177],"intelligent":[63,181],"software.":[64],"In":[65],"a":[66,80,129,175],"prior":[67],"study,":[68],"we":[69],"extracted":[70],"34":[71],"artefacts":[74,111,122,167],"from":[75],"21":[76],"seminal":[77],"works,":[78],"devising":[79],"taxonomy":[81],"five":[83],"key":[84],"requirements":[85],"produce":[87],"quality":[88],"documentation.":[90],"We":[91,139,173],"extend":[92],"this":[93],"study":[94,131],"in":[95,132,144],"two":[96],"ways.":[97],"First,":[98],"by":[99],"surveying":[100],"104":[101],"varying":[104],"experience":[105],"understand":[107],"what":[108],"are":[112,123,125],"ofmost":[113],"valueto":[114],"practitioners.":[115],"Second,":[116],"identifying":[117],"which":[118],"highly-valued":[121],"well-documented":[127],"case":[130],"emerging":[134],"service":[137],"domain.":[138],"identify:":[140],"(i)":[141],"several":[142],"gaps":[143],"software":[146,182],"engineering":[147],"literature,":[148],"aspects":[150],"understanding":[154],"is/is":[155],"extensively":[157],"investigated;":[158],"(ii)":[160],"industry":[162],"vendors":[163,186],"(in":[164],"contrast)":[165],"document":[166],"better":[169],"serve":[170],"end-developers.":[172],"provide":[174],"set":[176],"recommendations":[178],"enhance":[180],"for":[184],"both":[185],"wider":[189],"research":[190],"community.":[191]},"counts_by_year":[{"year":2026,"cited_by_count":1},{"year":2025,"cited_by_count":2},{"year":2024,"cited_by_count":2},{"year":2022,"cited_by_count":3},{"year":2021,"cited_by_count":1}],"updated_date":"2026-10-16T09:59:22.235173","created_date":"2025-10-10T00:00:00"}