{"id":"https://openalex.org/W2976695480","doi":"https://doi.org/10.1145/3328020.3353949","title":"Documentation as a cross-cutting concern of software","display_name":"Documentation as a cross-cutting concern of software","publication_year":2019,"publication_date":"2019-09-27","ids":{"openalex":"https://openalex.org/W2976695480","doi":"https://doi.org/10.1145/3328020.3353949","mag":"2976695480"},"language":"en","primary_location":{"id":"doi:10.1145/3328020.3353949","is_oa":false,"landing_page_url":"https://doi.org/10.1145/3328020.3353949","pdf_url":null,"source":null,"license":null,"license_id":null,"version":"publishedVersion","is_accepted":true,"is_published":true,"raw_source_name":"Proceedings of the 37th ACM International Conference on the Design of Communication","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/A5000966336","display_name":"James D. Palmer","orcid":null},"institutions":[{"id":"https://openalex.org/I203172682","display_name":"Northern Arizona University","ror":"https://ror.org/0272j5188","country_code":"US","type":"education","lineage":["https://openalex.org/I203172682"]}],"countries":["US"],"is_corresponding":true,"raw_author_name":"James D. Palmer","raw_affiliation_strings":["Northern Arizona University"],"affiliations":[{"raw_affiliation_string":"Northern Arizona University","institution_ids":["https://openalex.org/I203172682"]}]},{"author_position":"last","author":{"id":"https://openalex.org/A5091833151","display_name":"Nakai McAddis","orcid":null},"institutions":[{"id":"https://openalex.org/I203172682","display_name":"Northern Arizona University","ror":"https://ror.org/0272j5188","country_code":"US","type":"education","lineage":["https://openalex.org/I203172682"]}],"countries":["US"],"is_corresponding":false,"raw_author_name":"Nakai McAddis","raw_affiliation_strings":["Northern Arizona University"],"affiliations":[{"raw_affiliation_string":"Northern Arizona University","institution_ids":["https://openalex.org/I203172682"]}]}],"institutions":[],"countries_distinct_count":1,"institutions_distinct_count":2,"corresponding_author_ids":["https://openalex.org/A5000966336"],"corresponding_institution_ids":["https://openalex.org/I203172682"],"apc_list":null,"apc_paid":null,"fwci":0.3391,"has_fulltext":false,"cited_by_count":1,"citation_normalized_percentile":{"value":0.68745778,"is_in_top_1_percent":false,"is_in_top_10_percent":false},"cited_by_percentile_year":{"min":89,"max":94},"biblio":{"volume":null,"issue":null,"first_page":"1","last_page":"7"},"is_retracted":false,"is_paratext":false,"is_xpac":false,"primary_topic":{"id":"https://openalex.org/T10260","display_name":"Software Engineering Research","score":0.9998999834060669,"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.9998999834060669,"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.9966999888420105,"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/T10743","display_name":"Software Testing and Debugging Techniques","score":0.9950000047683716,"subfield":{"id":"https://openalex.org/subfields/1712","display_name":"Software"},"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.922753095626831},{"id":"https://openalex.org/keywords/internal-documentation","display_name":"Internal documentation","score":0.8269380331039429},{"id":"https://openalex.org/keywords/software-documentation","display_name":"Software documentation","score":0.7413753271102905},{"id":"https://openalex.org/keywords/computer-science","display_name":"Computer science","score":0.678621768951416},{"id":"https://openalex.org/keywords/software-engineering","display_name":"Software engineering","score":0.5897802710533142},{"id":"https://openalex.org/keywords/workflow","display_name":"Workflow","score":0.5522089004516602},{"id":"https://openalex.org/keywords/source-code","display_name":"Source code","score":0.47333982586860657},{"id":"https://openalex.org/keywords/software","display_name":"Software","score":0.4696228802204132},{"id":"https://openalex.org/keywords/software-development","display_name":"Software development","score":0.41689470410346985},{"id":"https://openalex.org/keywords/programming-language","display_name":"Programming language","score":0.3598506450653076},{"id":"https://openalex.org/keywords/software-construction","display_name":"Software construction","score":0.3381885588169098},{"id":"https://openalex.org/keywords/database","display_name":"Database","score":0.21046966314315796}],"concepts":[{"id":"https://openalex.org/C56666940","wikidata":"https://www.wikidata.org/wiki/Q788790","display_name":"Documentation","level":2,"score":0.922753095626831},{"id":"https://openalex.org/C140396857","wikidata":"https://www.wikidata.org/wiki/Q16934771","display_name":"Internal documentation","level":5,"score":0.8269380331039429},{"id":"https://openalex.org/C81587897","wikidata":"https://www.wikidata.org/wiki/Q181702","display_name":"Software documentation","level":5,"score":0.7413753271102905},{"id":"https://openalex.org/C41008148","wikidata":"https://www.wikidata.org/wiki/Q21198","display_name":"Computer science","level":0,"score":0.678621768951416},{"id":"https://openalex.org/C115903868","wikidata":"https://www.wikidata.org/wiki/Q80993","display_name":"Software engineering","level":1,"score":0.5897802710533142},{"id":"https://openalex.org/C177212765","wikidata":"https://www.wikidata.org/wiki/Q627335","display_name":"Workflow","level":2,"score":0.5522089004516602},{"id":"https://openalex.org/C43126263","wikidata":"https://www.wikidata.org/wiki/Q128751","display_name":"Source code","level":2,"score":0.47333982586860657},{"id":"https://openalex.org/C2777904410","wikidata":"https://www.wikidata.org/wiki/Q7397","display_name":"Software","level":2,"score":0.4696228802204132},{"id":"https://openalex.org/C529173508","wikidata":"https://www.wikidata.org/wiki/Q638608","display_name":"Software development","level":3,"score":0.41689470410346985},{"id":"https://openalex.org/C199360897","wikidata":"https://www.wikidata.org/wiki/Q9143","display_name":"Programming language","level":1,"score":0.3598506450653076},{"id":"https://openalex.org/C186846655","wikidata":"https://www.wikidata.org/wiki/Q3398377","display_name":"Software construction","level":4,"score":0.3381885588169098},{"id":"https://openalex.org/C77088390","wikidata":"https://www.wikidata.org/wiki/Q8513","display_name":"Database","level":1,"score":0.21046966314315796}],"mesh":[],"locations_count":1,"locations":[{"id":"doi:10.1145/3328020.3353949","is_oa":false,"landing_page_url":"https://doi.org/10.1145/3328020.3353949","pdf_url":null,"source":null,"license":null,"license_id":null,"version":"publishedVersion","is_accepted":true,"is_published":true,"raw_source_name":"Proceedings of the 37th ACM International Conference on the Design of Communication","raw_type":"proceedings-article"}],"best_oa_location":null,"sustainable_development_goals":[{"id":"https://metadata.un.org/sdg/4","score":0.7099999785423279,"display_name":"Quality Education"}],"awards":[],"funders":[],"has_content":{"pdf":false,"grobid_xml":false},"content_urls":null,"referenced_works_count":20,"referenced_works":["https://openalex.org/W1507039213","https://openalex.org/W1519288005","https://openalex.org/W1583037893","https://openalex.org/W1989526951","https://openalex.org/W1994683471","https://openalex.org/W2006372749","https://openalex.org/W2028810660","https://openalex.org/W2062177958","https://openalex.org/W2075917380","https://openalex.org/W2078438060","https://openalex.org/W2108337646","https://openalex.org/W2109125971","https://openalex.org/W2122824813","https://openalex.org/W2130550876","https://openalex.org/W2133890582","https://openalex.org/W2724937337","https://openalex.org/W2752885492","https://openalex.org/W2983995785","https://openalex.org/W3112759701","https://openalex.org/W4242395378"],"related_works":["https://openalex.org/W2602989241","https://openalex.org/W2112489737","https://openalex.org/W2108337646","https://openalex.org/W2404091770","https://openalex.org/W2764664989","https://openalex.org/W2646159910","https://openalex.org/W2035042871","https://openalex.org/W72470040","https://openalex.org/W2767775279","https://openalex.org/W3118244000"],"abstract_inverted_index":{"Traditionally,":[0],"software":[1,39,52,64,83],"documentation":[2,40,90,97,118,132],"is":[3,67],"either":[4],"embedded":[5,54],"directly":[6],"into":[7],"the":[8,26,51,71,78,109,135,141],"source":[9,56,72,79,103],"code":[10,73,80],"as":[11,98],"comments":[12],"and":[13,22,37,86,156],"therefore":[14],"tightly":[15],"coupled":[16],"to":[17,63,107,120],"it":[18],"or":[19,88],"maintained":[20],"separately":[21,69],"completely":[23],"divorced":[24],"from":[25,45,70,77],"code.":[27,57],"This":[28],"work":[29],"explores":[30],"an":[31],"alternative":[32],"mechanism":[33],"for":[34,140],"writing,":[35],"storing,":[36],"maintaining":[38],"where":[41],"comment":[42,59],"points":[43,60],"derived":[44],"revision":[46],"control":[47],"artifacts":[48],"associated":[49,133],"with":[50,134],"are":[53],"in":[55,114],"These":[58],"abstractly":[61],"link":[62],"documentation,":[65,151,155],"which":[66],"stored":[68],"but":[74],"remains":[75],"maintainable":[76],"using":[81,89],"traditional":[82],"development":[84],"tools":[85,92],"workflows,":[87],"focused":[91],"like":[93],"wikis.":[94],"By":[95],"treating":[96],"a":[99,143],"cross-cutting":[100],"concern":[101],"of":[102,111,128,146,153],"code,":[104],"we":[105],"intend":[106],"increase":[108],"modularity":[110],"documentation.":[112],"This,":[113],"turn,":[115],"allows":[116],"different":[117],"concerns":[119,130],"be":[121],"supported":[122],"without":[123],"mixing":[124],"those":[125],"concerns.":[126],"Examples":[127],"such":[129],"include":[131],"architectural":[136],"design,":[137],"articulated":[138],"requirements":[139],"software,":[142],"literate":[144],"description":[145],"algorithms,":[147],"external":[148],"developer":[149],"API":[150],"accessibility":[152],"international":[154],"pedagogical":[157],"exposition.":[158]},"counts_by_year":[{"year":2022,"cited_by_count":1}],"updated_date":"2025-11-06T03:46:38.306776","created_date":"2025-10-10T00:00:00"}
