{"id":"https://openalex.org/W2794744449","doi":"https://doi.org/10.1145/3180155.3180176","title":"When not to comment","display_name":"When not to comment","publication_year":2018,"publication_date":"2018-05-27","ids":{"openalex":"https://openalex.org/W2794744449","doi":"https://doi.org/10.1145/3180155.3180176","mag":"2794744449"},"language":"en","primary_location":{"id":"doi:10.1145/3180155.3180176","is_oa":true,"landing_page_url":"https://doi.org/10.1145/3180155.3180176","pdf_url":"https://dl.acm.org/doi/pdf/10.1145/3180155.3180176","source":null,"license":null,"license_id":null,"version":"publishedVersion","is_accepted":true,"is_published":true,"raw_source_name":"Proceedings of the 40th International Conference on Software Engineering","raw_type":"proceedings-article"},"type":"article","indexed_in":["crossref"],"open_access":{"is_oa":true,"oa_status":"gold","oa_url":"https://dl.acm.org/doi/pdf/10.1145/3180155.3180176","any_repository_has_fulltext":null},"authorships":[{"author_position":"first","author":{"id":"https://openalex.org/A5003473641","display_name":"Andrew Head","orcid":"https://orcid.org/0000-0002-1523-3347"},"institutions":[{"id":"https://openalex.org/I134446601","display_name":"Berkeley College","ror":"https://ror.org/02xewxa75","country_code":"US","type":"education","lineage":["https://openalex.org/I134446601"]},{"id":"https://openalex.org/I95457486","display_name":"University of California, Berkeley","ror":"https://ror.org/01an7q238","country_code":"US","type":"education","lineage":["https://openalex.org/I95457486"]}],"countries":["US"],"is_corresponding":true,"raw_author_name":"Andrew Head","raw_affiliation_strings":["UC Berkeley"],"affiliations":[{"raw_affiliation_string":"UC Berkeley","institution_ids":["https://openalex.org/I134446601","https://openalex.org/I95457486"]}]},{"author_position":"middle","author":{"id":"https://openalex.org/A5013989748","display_name":"Caitlin Sadowski","orcid":"https://orcid.org/0000-0002-7742-2784"},"institutions":[{"id":"https://openalex.org/I1291425158","display_name":"Google (United States)","ror":"https://ror.org/00njsd438","country_code":"US","type":"company","lineage":["https://openalex.org/I1291425158","https://openalex.org/I4210128969"]}],"countries":["US"],"is_corresponding":false,"raw_author_name":"Caitlin Sadowski","raw_affiliation_strings":["Google, Inc"],"affiliations":[{"raw_affiliation_string":"Google, Inc","institution_ids":["https://openalex.org/I1291425158"]}]},{"author_position":"middle","author":{"id":"https://openalex.org/A5052426710","display_name":"Emerson Murphy-Hill","orcid":"https://orcid.org/0000-0003-3921-9416"},"institutions":[{"id":"https://openalex.org/I137902535","display_name":"North Carolina State University","ror":"https://ror.org/04tj63d06","country_code":"US","type":"education","lineage":["https://openalex.org/I137902535"]},{"id":"https://openalex.org/I2801313472","display_name":"North Central State College","ror":"https://ror.org/04b6b6f76","country_code":"US","type":"education","lineage":["https://openalex.org/I2801313472"]}],"countries":["US"],"is_corresponding":false,"raw_author_name":"Emerson Murphy-Hill","raw_affiliation_strings":["NC State University"],"affiliations":[{"raw_affiliation_string":"NC State University","institution_ids":["https://openalex.org/I137902535","https://openalex.org/I2801313472"]}]},{"author_position":"last","author":{"id":"https://openalex.org/A5064650036","display_name":"Andrea Knight","orcid":null},"institutions":[{"id":"https://openalex.org/I1291425158","display_name":"Google (United States)","ror":"https://ror.org/00njsd438","country_code":"US","type":"company","lineage":["https://openalex.org/I1291425158","https://openalex.org/I4210128969"]}],"countries":["US"],"is_corresponding":false,"raw_author_name":"Andrea Knight","raw_affiliation_strings":["Google, Inc"],"affiliations":[{"raw_affiliation_string":"Google, Inc","institution_ids":["https://openalex.org/I1291425158"]}]}],"institutions":[],"countries_distinct_count":1,"institutions_distinct_count":4,"corresponding_author_ids":["https://openalex.org/A5003473641"],"corresponding_institution_ids":["https://openalex.org/I134446601","https://openalex.org/I95457486"],"apc_list":null,"apc_paid":null,"fwci":3.9269,"has_fulltext":true,"cited_by_count":22,"citation_normalized_percentile":{"value":0.94448252,"is_in_top_1_percent":false,"is_in_top_10_percent":true},"cited_by_percentile_year":{"min":91,"max":98},"biblio":{"volume":null,"issue":null,"first_page":"643","last_page":"653"},"is_retracted":false,"is_paratext":false,"is_xpac":false,"primary_topic":{"id":"https://openalex.org/T10260","display_name":"Software Engineering Research","score":0.9993000030517578,"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.9993000030517578,"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/T11675","display_name":"Open Source Software Innovations","score":0.9825999736785889,"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/T10799","display_name":"Data Visualization and Analytics","score":0.9549000263214111,"subfield":{"id":"https://openalex.org/subfields/1707","display_name":"Computer Vision and Pattern Recognition"},"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/documentation","display_name":"Documentation","score":0.9335653781890869},{"id":"https://openalex.org/keywords/computer-science","display_name":"Computer science","score":0.7378207445144653},{"id":"https://openalex.org/keywords/usable","display_name":"USable","score":0.6792225241661072},{"id":"https://openalex.org/keywords/reuse","display_name":"Reuse","score":0.6673392653465271},{"id":"https://openalex.org/keywords/header","display_name":"Header","score":0.6493144035339355},{"id":"https://openalex.org/keywords/code","display_name":"Code (set theory)","score":0.5465927720069885},{"id":"https://openalex.org/keywords/internal-documentation","display_name":"Internal documentation","score":0.5295539498329163},{"id":"https://openalex.org/keywords/set","display_name":"Set (abstract data type)","score":0.4721149206161499},{"id":"https://openalex.org/keywords/software-documentation","display_name":"Software documentation","score":0.4698081612586975},{"id":"https://openalex.org/keywords/software-engineering","display_name":"Software engineering","score":0.4511517584323883},{"id":"https://openalex.org/keywords/software-bug","display_name":"Software bug","score":0.41825202107429504},{"id":"https://openalex.org/keywords/world-wide-web","display_name":"World Wide Web","score":0.40765461325645447},{"id":"https://openalex.org/keywords/programming-language","display_name":"Programming language","score":0.27625083923339844},{"id":"https://openalex.org/keywords/software","display_name":"Software","score":0.19682124257087708},{"id":"https://openalex.org/keywords/engineering","display_name":"Engineering","score":0.14114126563072205},{"id":"https://openalex.org/keywords/software-development","display_name":"Software development","score":0.13941580057144165},{"id":"https://openalex.org/keywords/software-development-process","display_name":"Software development process","score":0.11040517687797546},{"id":"https://openalex.org/keywords/software-construction","display_name":"Software construction","score":0.07232493162155151}],"concepts":[{"id":"https://openalex.org/C56666940","wikidata":"https://www.wikidata.org/wiki/Q788790","display_name":"Documentation","level":2,"score":0.9335653781890869},{"id":"https://openalex.org/C41008148","wikidata":"https://www.wikidata.org/wiki/Q21198","display_name":"Computer science","level":0,"score":0.7378207445144653},{"id":"https://openalex.org/C2780615836","wikidata":"https://www.wikidata.org/wiki/Q2471869","display_name":"USable","level":2,"score":0.6792225241661072},{"id":"https://openalex.org/C206588197","wikidata":"https://www.wikidata.org/wiki/Q846574","display_name":"Reuse","level":2,"score":0.6673392653465271},{"id":"https://openalex.org/C48105269","wikidata":"https://www.wikidata.org/wiki/Q1141160","display_name":"Header","level":2,"score":0.6493144035339355},{"id":"https://openalex.org/C2776760102","wikidata":"https://www.wikidata.org/wiki/Q5139990","display_name":"Code (set theory)","level":3,"score":0.5465927720069885},{"id":"https://openalex.org/C140396857","wikidata":"https://www.wikidata.org/wiki/Q16934771","display_name":"Internal documentation","level":5,"score":0.5295539498329163},{"id":"https://openalex.org/C177264268","wikidata":"https://www.wikidata.org/wiki/Q1514741","display_name":"Set (abstract data type)","level":2,"score":0.4721149206161499},{"id":"https://openalex.org/C81587897","wikidata":"https://www.wikidata.org/wiki/Q181702","display_name":"Software documentation","level":5,"score":0.4698081612586975},{"id":"https://openalex.org/C115903868","wikidata":"https://www.wikidata.org/wiki/Q80993","display_name":"Software engineering","level":1,"score":0.4511517584323883},{"id":"https://openalex.org/C1009929","wikidata":"https://www.wikidata.org/wiki/Q179550","display_name":"Software bug","level":3,"score":0.41825202107429504},{"id":"https://openalex.org/C136764020","wikidata":"https://www.wikidata.org/wiki/Q466","display_name":"World Wide Web","level":1,"score":0.40765461325645447},{"id":"https://openalex.org/C199360897","wikidata":"https://www.wikidata.org/wiki/Q9143","display_name":"Programming language","level":1,"score":0.27625083923339844},{"id":"https://openalex.org/C2777904410","wikidata":"https://www.wikidata.org/wiki/Q7397","display_name":"Software","level":2,"score":0.19682124257087708},{"id":"https://openalex.org/C127413603","wikidata":"https://www.wikidata.org/wiki/Q11023","display_name":"Engineering","level":0,"score":0.14114126563072205},{"id":"https://openalex.org/C529173508","wikidata":"https://www.wikidata.org/wiki/Q638608","display_name":"Software development","level":3,"score":0.13941580057144165},{"id":"https://openalex.org/C180152950","wikidata":"https://www.wikidata.org/wiki/Q2904257","display_name":"Software development process","level":4,"score":0.11040517687797546},{"id":"https://openalex.org/C186846655","wikidata":"https://www.wikidata.org/wiki/Q3398377","display_name":"Software construction","level":4,"score":0.07232493162155151},{"id":"https://openalex.org/C31258907","wikidata":"https://www.wikidata.org/wiki/Q1301371","display_name":"Computer network","level":1,"score":0.0},{"id":"https://openalex.org/C548081761","wikidata":"https://www.wikidata.org/wiki/Q180388","display_name":"Waste management","level":1,"score":0.0}],"mesh":[],"locations_count":1,"locations":[{"id":"doi:10.1145/3180155.3180176","is_oa":true,"landing_page_url":"https://doi.org/10.1145/3180155.3180176","pdf_url":"https://dl.acm.org/doi/pdf/10.1145/3180155.3180176","source":null,"license":null,"license_id":null,"version":"publishedVersion","is_accepted":true,"is_published":true,"raw_source_name":"Proceedings of the 40th International Conference on Software Engineering","raw_type":"proceedings-article"}],"best_oa_location":{"id":"doi:10.1145/3180155.3180176","is_oa":true,"landing_page_url":"https://doi.org/10.1145/3180155.3180176","pdf_url":"https://dl.acm.org/doi/pdf/10.1145/3180155.3180176","source":null,"license":null,"license_id":null,"version":"publishedVersion","is_accepted":true,"is_published":true,"raw_source_name":"Proceedings of the 40th International Conference on Software Engineering","raw_type":"proceedings-article"},"sustainable_development_goals":[{"id":"https://metadata.un.org/sdg/9","display_name":"Industry, innovation and infrastructure","score":0.4699999988079071}],"awards":[],"funders":[],"has_content":{"pdf":true,"grobid_xml":true},"content_urls":{"pdf":"https://content.openalex.org/works/W2794744449.pdf","grobid_xml":"https://content.openalex.org/works/W2794744449.grobid-xml"},"referenced_works_count":39,"referenced_works":["https://openalex.org/W90447038","https://openalex.org/W1884204318","https://openalex.org/W1970407057","https://openalex.org/W1989206341","https://openalex.org/W1989526951","https://openalex.org/W1991613282","https://openalex.org/W1995650922","https://openalex.org/W1998753103","https://openalex.org/W2001640574","https://openalex.org/W2006291142","https://openalex.org/W2008107570","https://openalex.org/W2016681195","https://openalex.org/W2039536418","https://openalex.org/W2044049174","https://openalex.org/W2046461983","https://openalex.org/W2052657693","https://openalex.org/W2066182606","https://openalex.org/W2080534028","https://openalex.org/W2082160726","https://openalex.org/W2112351052","https://openalex.org/W2114315419","https://openalex.org/W2117228548","https://openalex.org/W2118435948","https://openalex.org/W2122401044","https://openalex.org/W2123333323","https://openalex.org/W2134829794","https://openalex.org/W2148357053","https://openalex.org/W2151996389","https://openalex.org/W2166069603","https://openalex.org/W2166271660","https://openalex.org/W2168382229","https://openalex.org/W2177002043","https://openalex.org/W2297781517","https://openalex.org/W2366532918","https://openalex.org/W2469513535","https://openalex.org/W2478911292","https://openalex.org/W2546851909","https://openalex.org/W2617604339","https://openalex.org/W2991062394"],"related_works":["https://openalex.org/W2017728669","https://openalex.org/W2605062884","https://openalex.org/W2302620416","https://openalex.org/W1982847704","https://openalex.org/W4255826246","https://openalex.org/W1791687657","https://openalex.org/W4376606818","https://openalex.org/W2344757762","https://openalex.org/W2068591475","https://openalex.org/W2794744449"],"abstract_inverted_index":{"Without":[0],"usable":[1],"and":[2,53,89,122],"accurate":[3],"documentation":[4,27,52,99],"of":[5,74,86,119],"how":[6],"to":[7,113],"use":[8],"an":[9],"API,":[10],"developers":[11,24,75,124],"can":[12,25],"find":[13,26],"themselves":[14],"deterred":[15],"from":[16,49],"reusing":[17],"relevant":[18],"code.":[19,44],"In":[20,95],"C++,":[21],"one":[22],"place":[23],"is":[28,35],"in":[29],"a":[30,64,117],"header":[31],"file.":[32],"When":[33],"information":[34],"missing,":[36],"they":[37,79],"may":[38,100],"look":[39],"at":[40,76],"the":[41,54,77],"corresponding":[42],"implementation":[43,81],"To":[45],"understand":[46],"what's":[47],"missing":[48],"C++":[50],"API":[51,93],"factors":[55],"influencing":[56],"whether":[57],"it":[58],"will":[59],"be":[60],"fixed,":[61],"we":[62],"conducted":[63],"mixed-methods":[65],"study":[66],"involving":[67],"two":[68],"experience":[69],"sampling":[70],"surveys":[71],"with":[72,84,91],"hundreds":[73],"moment":[78],"visited":[80],"code,":[82],"interviews":[83,90],"18":[85],"those":[87],"developers,":[88,106],"8":[92],"maintainers.":[94],"many":[96],"cases,":[97],"updating":[98],"provide":[101],"only":[102],"limited":[103],"value":[104],"for":[105],"while":[107],"requiring":[108],"effort":[109],"maintainers":[110,121],"don't":[111],"want":[112],"invest.":[114],"We":[115],"identify":[116],"set":[118],"questions":[120],"tool":[123],"should":[125],"consider":[126],"when":[127],"improving":[128],"API-level":[129],"documentation.":[130]},"counts_by_year":[{"year":2025,"cited_by_count":1},{"year":2024,"cited_by_count":3},{"year":2023,"cited_by_count":5},{"year":2022,"cited_by_count":3},{"year":2021,"cited_by_count":4},{"year":2020,"cited_by_count":4},{"year":2019,"cited_by_count":2}],"updated_date":"2025-11-06T03:46:38.306776","created_date":"2025-10-10T00:00:00"}