{"id":"https://openalex.org/W2118435948","doi":"https://doi.org/10.1109/icse.2009.5070532","title":"Improving API documentation usability with knowledge pushing","display_name":"Improving API documentation usability with knowledge pushing","publication_year":2009,"publication_date":"2009-01-01","ids":{"openalex":"https://openalex.org/W2118435948","doi":"https://doi.org/10.1109/icse.2009.5070532","mag":"2118435948"},"language":"en","primary_location":{"id":"doi:10.1109/icse.2009.5070532","is_oa":false,"landing_page_url":"https://doi.org/10.1109/icse.2009.5070532","pdf_url":null,"source":null,"license":null,"license_id":null,"version":"publishedVersion","is_accepted":true,"is_published":true,"raw_source_name":"2009 IEEE 31st International Conference on Software Engineering","raw_type":"proceedings-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/A5056811549","display_name":"Uri Dekel","orcid":null},"institutions":[{"id":"https://openalex.org/I74973139","display_name":"Carnegie Mellon University","ror":"https://ror.org/05x2bcf33","country_code":"US","type":"education","lineage":["https://openalex.org/I74973139"]}],"countries":["US"],"is_corresponding":true,"raw_author_name":"Uri Dekel","raw_affiliation_strings":["Institute of Software Research, School of Computer Science, Carnegie Mellon University, Pittsburgh, PA, USA","Institute for Software Research, School of Computer Science, Carnegie Mellon University, 5000 Forbes Avenue, Pittsburgh, PA 15213, USA"],"affiliations":[{"raw_affiliation_string":"Institute of Software Research, School of Computer Science, Carnegie Mellon University, Pittsburgh, PA, USA","institution_ids":["https://openalex.org/I74973139"]},{"raw_affiliation_string":"Institute for Software Research, School of Computer Science, Carnegie Mellon University, 5000 Forbes Avenue, Pittsburgh, PA 15213, USA","institution_ids":["https://openalex.org/I74973139"]}]},{"author_position":"last","author":{"id":"https://openalex.org/A5056032814","display_name":"James D. Herbsleb","orcid":"https://orcid.org/0000-0002-7159-7524"},"institutions":[{"id":"https://openalex.org/I74973139","display_name":"Carnegie Mellon University","ror":"https://ror.org/05x2bcf33","country_code":"US","type":"education","lineage":["https://openalex.org/I74973139"]}],"countries":["US"],"is_corresponding":false,"raw_author_name":"James D. Herbsleb","raw_affiliation_strings":["Institute of Software Research, School of Computer Science, Carnegie Mellon University, Pittsburgh, PA, USA","Institute for Software Research, School of Computer Science, Carnegie Mellon University, 5000 Forbes Avenue, Pittsburgh, PA 15213, USA"],"affiliations":[{"raw_affiliation_string":"Institute of Software Research, School of Computer Science, Carnegie Mellon University, Pittsburgh, PA, USA","institution_ids":["https://openalex.org/I74973139"]},{"raw_affiliation_string":"Institute for Software Research, School of Computer Science, Carnegie Mellon University, 5000 Forbes Avenue, Pittsburgh, PA 15213, USA","institution_ids":["https://openalex.org/I74973139"]}]}],"institutions":[],"countries_distinct_count":1,"institutions_distinct_count":2,"corresponding_author_ids":["https://openalex.org/A5056811549"],"corresponding_institution_ids":["https://openalex.org/I74973139"],"apc_list":null,"apc_paid":null,"fwci":28.7232,"has_fulltext":false,"cited_by_count":122,"citation_normalized_percentile":{"value":0.99504437,"is_in_top_1_percent":true,"is_in_top_10_percent":true},"cited_by_percentile_year":{"min":96,"max":100},"biblio":{"volume":null,"issue":null,"first_page":null,"last_page":null},"is_retracted":false,"is_paratext":false,"is_xpac":false,"primary_topic":{"id":"https://openalex.org/T10260","display_name":"Software Engineering Research","score":0.9997000098228455,"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.9997000098228455,"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/T10639","display_name":"Advanced Software Engineering Methodologies","score":0.9965999722480774,"subfield":{"id":"https://openalex.org/subfields/1702","display_name":"Artificial Intelligence"},"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/T10126","display_name":"Logic, programming, and type systems","score":0.9940999746322632,"subfield":{"id":"https://openalex.org/subfields/1702","display_name":"Artificial Intelligence"},"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.8895998597145081},{"id":"https://openalex.org/keywords/usability","display_name":"Usability","score":0.7748743295669556},{"id":"https://openalex.org/keywords/computer-science","display_name":"Computer science","score":0.7688823342323303},{"id":"https://openalex.org/keywords/directive","display_name":"Directive","score":0.5889958143234253},{"id":"https://openalex.org/keywords/java","display_name":"Java","score":0.49673205614089966},{"id":"https://openalex.org/keywords/world-wide-web","display_name":"World Wide Web","score":0.4784843325614929},{"id":"https://openalex.org/keywords/eclipse","display_name":"Eclipse","score":0.4451274275779724},{"id":"https://openalex.org/keywords/software-engineering","display_name":"Software engineering","score":0.3613676428794861},{"id":"https://openalex.org/keywords/human\u2013computer-interaction","display_name":"Human\u2013computer interaction","score":0.19617658853530884},{"id":"https://openalex.org/keywords/programming-language","display_name":"Programming language","score":0.16225537657737732}],"concepts":[{"id":"https://openalex.org/C56666940","wikidata":"https://www.wikidata.org/wiki/Q788790","display_name":"Documentation","level":2,"score":0.8895998597145081},{"id":"https://openalex.org/C170130773","wikidata":"https://www.wikidata.org/wiki/Q216378","display_name":"Usability","level":2,"score":0.7748743295669556},{"id":"https://openalex.org/C41008148","wikidata":"https://www.wikidata.org/wiki/Q21198","display_name":"Computer science","level":0,"score":0.7688823342323303},{"id":"https://openalex.org/C2779547435","wikidata":"https://www.wikidata.org/wiki/Q1121492","display_name":"Directive","level":2,"score":0.5889958143234253},{"id":"https://openalex.org/C548217200","wikidata":"https://www.wikidata.org/wiki/Q251","display_name":"Java","level":2,"score":0.49673205614089966},{"id":"https://openalex.org/C136764020","wikidata":"https://www.wikidata.org/wiki/Q466","display_name":"World Wide Web","level":1,"score":0.4784843325614929},{"id":"https://openalex.org/C2778505590","wikidata":"https://www.wikidata.org/wiki/Q141022","display_name":"Eclipse","level":2,"score":0.4451274275779724},{"id":"https://openalex.org/C115903868","wikidata":"https://www.wikidata.org/wiki/Q80993","display_name":"Software engineering","level":1,"score":0.3613676428794861},{"id":"https://openalex.org/C107457646","wikidata":"https://www.wikidata.org/wiki/Q207434","display_name":"Human\u2013computer interaction","level":1,"score":0.19617658853530884},{"id":"https://openalex.org/C199360897","wikidata":"https://www.wikidata.org/wiki/Q9143","display_name":"Programming language","level":1,"score":0.16225537657737732},{"id":"https://openalex.org/C1276947","wikidata":"https://www.wikidata.org/wiki/Q333","display_name":"Astronomy","level":1,"score":0.0},{"id":"https://openalex.org/C121332964","wikidata":"https://www.wikidata.org/wiki/Q413","display_name":"Physics","level":0,"score":0.0}],"mesh":[],"locations_count":3,"locations":[{"id":"doi:10.1109/icse.2009.5070532","is_oa":false,"landing_page_url":"https://doi.org/10.1109/icse.2009.5070532","pdf_url":null,"source":null,"license":null,"license_id":null,"version":"publishedVersion","is_accepted":true,"is_published":true,"raw_source_name":"2009 IEEE 31st International Conference on Software Engineering","raw_type":"proceedings-article"},{"id":"pmh:oai:CiteSeerX.psu:10.1.1.178.4291","is_oa":false,"landing_page_url":"http://citeseerx.ist.psu.edu/viewdoc/summary?doi=10.1.1.178.4291","pdf_url":null,"source":null,"license":null,"license_id":null,"version":"submittedVersion","is_accepted":false,"is_published":false,"raw_source_name":"http://www-2.cs.cmu.edu/%7Ejdh/web-pubs/pdfs/dekel-inproving-2009.pdf","raw_type":"text"},{"id":"pmh:oai:CiteSeerX.psu:10.1.1.499.6468","is_oa":false,"landing_page_url":"http://citeseerx.ist.psu.edu/viewdoc/summary?doi=10.1.1.499.6468","pdf_url":null,"source":null,"license":null,"license_id":null,"version":"submittedVersion","is_accepted":false,"is_published":false,"raw_source_name":"http://www.cs.cmu.edu/~udekel/papers/udekel_emoose_icse2009.pdf","raw_type":"text"}],"best_oa_location":null,"sustainable_development_goals":[{"id":"https://metadata.un.org/sdg/16","display_name":"Peace, Justice and strong institutions","score":0.46000000834465027}],"awards":[],"funders":[{"id":"https://openalex.org/F4320306076","display_name":"National Science Foundation","ror":"https://ror.org/021nxhr62"},{"id":"https://openalex.org/F4320306151","display_name":"Alfred P. Sloan Foundation","ror":"https://ror.org/052csg198"},{"id":"https://openalex.org/F4320310207","display_name":"Carnegie Mellon University","ror":"https://ror.org/05x2bcf33"}],"has_content":{"pdf":false,"grobid_xml":false},"content_urls":null,"referenced_works_count":13,"referenced_works":["https://openalex.org/W221670187","https://openalex.org/W1500946169","https://openalex.org/W1977634046","https://openalex.org/W1994683471","https://openalex.org/W2003205661","https://openalex.org/W2017061765","https://openalex.org/W2091712774","https://openalex.org/W2094160561","https://openalex.org/W2128465105","https://openalex.org/W2152874840","https://openalex.org/W2160938265","https://openalex.org/W2161825580","https://openalex.org/W4239049496"],"related_works":["https://openalex.org/W3033520411","https://openalex.org/W4389670110","https://openalex.org/W2618286804","https://openalex.org/W2429057255","https://openalex.org/W2187546663","https://openalex.org/W148745890","https://openalex.org/W137217271","https://openalex.org/W2611942503","https://openalex.org/W4315621326","https://openalex.org/W2322198081"],"abstract_inverted_index":{"The":[0],"documentation":[1,126],"of":[2,12,29,32,132],"API":[3],"functions":[4],"typically":[5],"conveys":[6],"detailed":[7],"specifications":[8],"for":[9,77],"the":[10,55,60,106,110,120,129],"benefit":[11],"interested":[13],"readers.":[14],"In":[15],"some":[16],"cases,":[17],"however,":[18],"it":[19],"also":[20],"contains":[21],"usage":[22],"directives,":[23],"such":[24],"as":[25],"rules":[26],"or":[27,58],"caveats,":[28],"which":[30,101],"authors":[31],"invoking":[33],"code":[34],"must":[35],"be":[36,52,64],"made":[37],"aware":[38],"to":[39,95,98],"prevent":[40],"errors":[41],"and":[42,128],"inefficiencies.":[43],"There":[44],"is":[45,94],"a":[46,115],"risk":[47],"that":[48,59,118],"these":[49,75],"directives":[50,108],"may":[51],"ldquolostrdquo":[53],"within":[54],"verbose":[56],"text,":[57],"text":[61],"would":[62],"not":[63],"read":[65],"because":[66],"there":[67],"are":[68],"so":[69],"many":[70],"invoked":[71],"functions.":[72],"To":[73],"address":[74],"concerns":[76],"Java,":[78],"an":[79],"Eclipse":[80],"plug-in":[81],"named":[82],"eMoose":[83],"decorates":[84],"method":[85],"invocations":[86],"whose":[87],"targets":[88],"have":[89],"associated":[90],"directives.":[91],"Our":[92],"goal":[93],"lead":[96],"readers":[97],"investigate":[99],"further,":[100],"we":[102],"aid":[103],"by":[104],"highlighting":[105],"tagged":[107],"in":[109,124],"JavaDoc":[111],"hover.":[112],"We":[113],"present":[114],"lab":[116],"study":[117],"demonstrates":[119],"directive":[121],"awareness":[122],"problem":[123],"traditional":[125],"use":[127],"potential":[130],"benefits":[131],"our":[133],"approach.":[134]},"counts_by_year":[{"year":2024,"cited_by_count":3},{"year":2023,"cited_by_count":5},{"year":2022,"cited_by_count":5},{"year":2021,"cited_by_count":8},{"year":2020,"cited_by_count":3},{"year":2019,"cited_by_count":8},{"year":2018,"cited_by_count":9},{"year":2017,"cited_by_count":8},{"year":2016,"cited_by_count":7},{"year":2015,"cited_by_count":10},{"year":2014,"cited_by_count":9},{"year":2013,"cited_by_count":10},{"year":2012,"cited_by_count":22}],"updated_date":"2026-04-05T17:49:38.594831","created_date":"2025-10-10T00:00:00"}
