{"id":"https://openalex.org/W2973871089","doi":"https://doi.org/10.1109/vlhcc.2019.8818816","title":"Active Documentation: Helping Developers Follow Design Decisions","display_name":"Active Documentation: Helping Developers Follow Design Decisions","publication_year":2019,"publication_date":"2019-09-19","ids":{"openalex":"https://openalex.org/W2973871089","doi":"https://doi.org/10.1109/vlhcc.2019.8818816","mag":"2973871089"},"language":"en","primary_location":{"id":"doi:10.1109/vlhcc.2019.8818816","is_oa":false,"landing_page_url":"https://doi.org/10.1109/vlhcc.2019.8818816","pdf_url":null,"source":null,"license":null,"license_id":null,"version":"publishedVersion","is_accepted":true,"is_published":true,"raw_source_name":"2019 IEEE Symposium on Visual Languages and Human-Centric Computing (VL/HCC)","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/A5059933932","display_name":"Sahar Mehrpour","orcid":"https://orcid.org/0000-0002-9263-3360"},"institutions":[{"id":"https://openalex.org/I162714631","display_name":"George Mason University","ror":"https://ror.org/02jqj7156","country_code":"US","type":"education","lineage":["https://openalex.org/I162714631"]}],"countries":["US"],"is_corresponding":true,"raw_author_name":"Sahar Mehrpour","raw_affiliation_strings":["Department of Computer Science, George Mason University, Fairfax, VA, USA"],"affiliations":[{"raw_affiliation_string":"Department of Computer Science, George Mason University, Fairfax, VA, USA","institution_ids":["https://openalex.org/I162714631"]}]},{"author_position":"middle","author":{"id":"https://openalex.org/A5059412025","display_name":"Thomas D. LaToza","orcid":"https://orcid.org/0000-0002-9564-3337"},"institutions":[{"id":"https://openalex.org/I162714631","display_name":"George Mason University","ror":"https://ror.org/02jqj7156","country_code":"US","type":"education","lineage":["https://openalex.org/I162714631"]}],"countries":["US"],"is_corresponding":false,"raw_author_name":"Thomas D. LaToza","raw_affiliation_strings":["Department of Computer Science, George Mason University, Fairfax, VA, USA"],"affiliations":[{"raw_affiliation_string":"Department of Computer Science, George Mason University, Fairfax, VA, USA","institution_ids":["https://openalex.org/I162714631"]}]},{"author_position":"last","author":{"id":"https://openalex.org/A5078566942","display_name":"Rahul K. Kindi","orcid":null},"institutions":[{"id":"https://openalex.org/I205783295","display_name":"Cornell University","ror":"https://ror.org/05bnh6r87","country_code":"US","type":"education","lineage":["https://openalex.org/I205783295"]}],"countries":["US"],"is_corresponding":false,"raw_author_name":"Rahul K. Kindi","raw_affiliation_strings":["Department of Computer Science, Cornell University, Ithaca, NY, USA"],"affiliations":[{"raw_affiliation_string":"Department of Computer Science, Cornell University, Ithaca, NY, USA","institution_ids":["https://openalex.org/I205783295"]}]}],"institutions":[],"countries_distinct_count":1,"institutions_distinct_count":3,"corresponding_author_ids":["https://openalex.org/A5059933932"],"corresponding_institution_ids":["https://openalex.org/I162714631"],"apc_list":null,"apc_paid":null,"fwci":1.6957,"has_fulltext":false,"cited_by_count":9,"citation_normalized_percentile":{"value":0.88446182,"is_in_top_1_percent":false,"is_in_top_10_percent":false},"cited_by_percentile_year":{"min":89,"max":97},"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":1.0,"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":1.0,"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.9986000061035156,"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/T10430","display_name":"Software Engineering Techniques and Practices","score":0.9976999759674072,"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/codebase","display_name":"Codebase","score":0.917029619216919},{"id":"https://openalex.org/keywords/documentation","display_name":"Documentation","score":0.909339427947998},{"id":"https://openalex.org/keywords/computer-science","display_name":"Computer science","score":0.7361981868743896},{"id":"https://openalex.org/keywords/code","display_name":"Code (set theory)","score":0.5795033574104309},{"id":"https://openalex.org/keywords/internal-documentation","display_name":"Internal documentation","score":0.5169321894645691},{"id":"https://openalex.org/keywords/key","display_name":"Key (lock)","score":0.5153304934501648},{"id":"https://openalex.org/keywords/software-engineering","display_name":"Software engineering","score":0.46306318044662476},{"id":"https://openalex.org/keywords/human\u2013computer-interaction","display_name":"Human\u2013computer interaction","score":0.3452910780906677},{"id":"https://openalex.org/keywords/source-code","display_name":"Source code","score":0.31989482045173645},{"id":"https://openalex.org/keywords/programming-language","display_name":"Programming language","score":0.2972625195980072},{"id":"https://openalex.org/keywords/set","display_name":"Set (abstract data type)","score":0.184906005859375},{"id":"https://openalex.org/keywords/software","display_name":"Software","score":0.1685943603515625},{"id":"https://openalex.org/keywords/computer-security","display_name":"Computer security","score":0.16707226634025574},{"id":"https://openalex.org/keywords/software-development","display_name":"Software development","score":0.143740713596344},{"id":"https://openalex.org/keywords/software-construction","display_name":"Software construction","score":0.08635708689689636}],"concepts":[{"id":"https://openalex.org/C51929080","wikidata":"https://www.wikidata.org/wiki/Q2425187","display_name":"Codebase","level":3,"score":0.917029619216919},{"id":"https://openalex.org/C56666940","wikidata":"https://www.wikidata.org/wiki/Q788790","display_name":"Documentation","level":2,"score":0.909339427947998},{"id":"https://openalex.org/C41008148","wikidata":"https://www.wikidata.org/wiki/Q21198","display_name":"Computer science","level":0,"score":0.7361981868743896},{"id":"https://openalex.org/C2776760102","wikidata":"https://www.wikidata.org/wiki/Q5139990","display_name":"Code (set theory)","level":3,"score":0.5795033574104309},{"id":"https://openalex.org/C140396857","wikidata":"https://www.wikidata.org/wiki/Q16934771","display_name":"Internal documentation","level":5,"score":0.5169321894645691},{"id":"https://openalex.org/C26517878","wikidata":"https://www.wikidata.org/wiki/Q228039","display_name":"Key (lock)","level":2,"score":0.5153304934501648},{"id":"https://openalex.org/C115903868","wikidata":"https://www.wikidata.org/wiki/Q80993","display_name":"Software engineering","level":1,"score":0.46306318044662476},{"id":"https://openalex.org/C107457646","wikidata":"https://www.wikidata.org/wiki/Q207434","display_name":"Human\u2013computer interaction","level":1,"score":0.3452910780906677},{"id":"https://openalex.org/C43126263","wikidata":"https://www.wikidata.org/wiki/Q128751","display_name":"Source code","level":2,"score":0.31989482045173645},{"id":"https://openalex.org/C199360897","wikidata":"https://www.wikidata.org/wiki/Q9143","display_name":"Programming language","level":1,"score":0.2972625195980072},{"id":"https://openalex.org/C177264268","wikidata":"https://www.wikidata.org/wiki/Q1514741","display_name":"Set (abstract data type)","level":2,"score":0.184906005859375},{"id":"https://openalex.org/C2777904410","wikidata":"https://www.wikidata.org/wiki/Q7397","display_name":"Software","level":2,"score":0.1685943603515625},{"id":"https://openalex.org/C38652104","wikidata":"https://www.wikidata.org/wiki/Q3510521","display_name":"Computer security","level":1,"score":0.16707226634025574},{"id":"https://openalex.org/C529173508","wikidata":"https://www.wikidata.org/wiki/Q638608","display_name":"Software development","level":3,"score":0.143740713596344},{"id":"https://openalex.org/C186846655","wikidata":"https://www.wikidata.org/wiki/Q3398377","display_name":"Software construction","level":4,"score":0.08635708689689636}],"mesh":[],"locations_count":1,"locations":[{"id":"doi:10.1109/vlhcc.2019.8818816","is_oa":false,"landing_page_url":"https://doi.org/10.1109/vlhcc.2019.8818816","pdf_url":null,"source":null,"license":null,"license_id":null,"version":"publishedVersion","is_accepted":true,"is_published":true,"raw_source_name":"2019 IEEE Symposium on Visual Languages and Human-Centric Computing (VL/HCC)","raw_type":"proceedings-article"}],"best_oa_location":null,"sustainable_development_goals":[{"display_name":"Peace, Justice and strong institutions","score":0.6700000166893005,"id":"https://metadata.un.org/sdg/16"}],"awards":[],"funders":[],"has_content":{"pdf":false,"grobid_xml":false},"content_urls":null,"referenced_works_count":55,"referenced_works":["https://openalex.org/W38042861","https://openalex.org/W91877992","https://openalex.org/W1491937825","https://openalex.org/W1540343830","https://openalex.org/W1663082288","https://openalex.org/W1884204318","https://openalex.org/W1980974366","https://openalex.org/W1986453394","https://openalex.org/W1987614102","https://openalex.org/W1989526951","https://openalex.org/W1993084949","https://openalex.org/W2002436748","https://openalex.org/W2018414565","https://openalex.org/W2020114747","https://openalex.org/W2032396198","https://openalex.org/W2034591763","https://openalex.org/W2038476425","https://openalex.org/W2052363833","https://openalex.org/W2072895015","https://openalex.org/W2087527532","https://openalex.org/W2096360482","https://openalex.org/W2100503493","https://openalex.org/W2104193835","https://openalex.org/W2112021024","https://openalex.org/W2112324578","https://openalex.org/W2116065992","https://openalex.org/W2119414210","https://openalex.org/W2127685229","https://openalex.org/W2134119432","https://openalex.org/W2147751596","https://openalex.org/W2148357053","https://openalex.org/W2148389674","https://openalex.org/W2148425758","https://openalex.org/W2160080320","https://openalex.org/W2160694571","https://openalex.org/W2160938265","https://openalex.org/W2169291221","https://openalex.org/W2197966456","https://openalex.org/W2202149597","https://openalex.org/W2216905672","https://openalex.org/W2294228504","https://openalex.org/W2431071320","https://openalex.org/W2767563557","https://openalex.org/W2783990487","https://openalex.org/W2784876765","https://openalex.org/W2794744449","https://openalex.org/W2796218495","https://openalex.org/W3151918736","https://openalex.org/W4233410239","https://openalex.org/W4235398043","https://openalex.org/W4239049496","https://openalex.org/W4248437024","https://openalex.org/W6658973607","https://openalex.org/W6685098240","https://openalex.org/W6747399107"],"related_works":["https://openalex.org/W2151917841","https://openalex.org/W29006708","https://openalex.org/W4213259913","https://openalex.org/W2764664989","https://openalex.org/W2018433144","https://openalex.org/W2344367508","https://openalex.org/W656101134","https://openalex.org/W2189387569","https://openalex.org/W3005789994","https://openalex.org/W20188161"],"abstract_inverted_index":{"Good":[0],"documentation":[1,123,131],"has":[2],"long":[3],"been":[4],"argued":[5],"to":[6,9,52,59,108,132,135],"be":[7],"key":[8],"helping":[10],"developers":[11,67,82,109,115],"write":[12],"code":[13],"more":[14,127],"quickly":[15],"and":[16,44,77,102,126,141],"consistently":[17],"with":[18,121],"design":[19,36,42,55,73,85,92,113,137],"decisions,":[20],"but":[21],"is":[22],"left":[23],"largely":[24],"disconnected":[25],"from":[26],"code.":[27,47],"We":[28,94],"propose":[29],"a":[30,54,99,104,111],"method":[31],"for":[32],"active":[33,122,130],"documentation,":[34],"where":[35],"decisions":[37,86,138],"are":[38,75,79],"made":[39],"explicit":[40],"as":[41],"rules":[43,74],"checked":[45],"against":[46],"Developers":[48],"can":[49],"discover":[50],"how":[51,134],"follow":[53,136],"rule":[56],"by":[57],"navigating":[58],"examples":[60,140],"in":[61,98,117],"their":[62,146],"codebase.":[63],"After":[64],"editing":[65],"code,":[66],"receive":[68,142],"immediate":[69,143],"feedback":[70,144],"about":[71,87],"which":[72,78],"satisfied":[76],"violated,":[80],"notifying":[81],"who":[83],"miss":[84],"the":[88],"existence":[89],"of":[90],"these":[91],"decisions.":[93],"implemented":[95],"our":[96],"approach":[97],"prototype":[100],"tool":[101],"conducted":[103],"user":[105],"study.":[106],"Compared":[107],"using":[110,129],"traditional":[112],"document,":[114],"working":[116],"an":[118],"unfamiliar":[119],"codebase":[120],"were":[124],"faster":[125],"successful,":[128],"learn":[133],"through":[139],"on":[145],"changes.":[147]},"counts_by_year":[{"year":2024,"cited_by_count":3},{"year":2023,"cited_by_count":1},{"year":2022,"cited_by_count":3},{"year":2020,"cited_by_count":2}],"updated_date":"2025-11-06T03:46:38.306776","created_date":"2025-10-10T00:00:00"}