{"id":"https://openalex.org/W1989526951","doi":"https://doi.org/10.1109/ms.2003.1241364","title":"How software engineers use documentation: the state of the practice","display_name":"How software engineers use documentation: the state of the practice","publication_year":2003,"publication_date":"2003-11-01","ids":{"openalex":"https://openalex.org/W1989526951","doi":"https://doi.org/10.1109/ms.2003.1241364","mag":"1989526951"},"language":"en","primary_location":{"id":"doi:10.1109/ms.2003.1241364","is_oa":false,"landing_page_url":"https://doi.org/10.1109/ms.2003.1241364","pdf_url":null,"source":{"id":"https://openalex.org/S6725529","display_name":"IEEE Software","issn_l":"0740-7459","issn":["0740-7459","1937-4194"],"is_oa":false,"is_in_doaj":false,"is_core":true,"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 Software","raw_type":"journal-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/A5014342398","display_name":"Timothy C. Lethbridge","orcid":"https://orcid.org/0000-0001-9410-2056"},"institutions":[{"id":"https://openalex.org/I153718931","display_name":"University of Ottawa","ror":"https://ror.org/03c4mmv16","country_code":"CA","type":"education","lineage":["https://openalex.org/I153718931"]}],"countries":["CA"],"is_corresponding":true,"raw_author_name":"T.C. Lethbridge","raw_affiliation_strings":["University of Ottawa, Canada","[Ottawa Univ., Ont., Canada]"],"affiliations":[{"raw_affiliation_string":"University of Ottawa, Canada","institution_ids":["https://openalex.org/I153718931"]},{"raw_affiliation_string":"[Ottawa Univ., Ont., Canada]","institution_ids":["https://openalex.org/I153718931"]}]},{"author_position":"middle","author":{"id":"https://openalex.org/A5111890864","display_name":"Janice Singer","orcid":null},"institutions":[{"id":"https://openalex.org/I4210159778","display_name":"National Research Council Canada","ror":"https://ror.org/04mte1k06","country_code":"CA","type":"government","lineage":["https://openalex.org/I4210159778"]}],"countries":["CA"],"is_corresponding":false,"raw_author_name":"J. Singer","raw_affiliation_strings":["National Research Council, Canada"],"affiliations":[{"raw_affiliation_string":"National Research Council, Canada","institution_ids":["https://openalex.org/I4210159778"]}]},{"author_position":"last","author":{"id":"https://openalex.org/A5036590757","display_name":"Andrew Forward","orcid":"https://orcid.org/0000-0003-1642-0985"},"institutions":[{"id":"https://openalex.org/I145325580","display_name":"Deloitte (United States)","ror":"https://ror.org/03xkm6e60","country_code":"US","type":"company","lineage":["https://openalex.org/I145325580","https://openalex.org/I4210139068"]}],"countries":["US"],"is_corresponding":false,"raw_author_name":"A. Forward","raw_affiliation_strings":["Deloitte Consulting LLP","[Deloitte Consulting LLP]"],"affiliations":[{"raw_affiliation_string":"Deloitte Consulting LLP","institution_ids":["https://openalex.org/I145325580"]},{"raw_affiliation_string":"[Deloitte Consulting LLP]","institution_ids":["https://openalex.org/I145325580"]}]}],"institutions":[],"countries_distinct_count":2,"institutions_distinct_count":3,"corresponding_author_ids":["https://openalex.org/A5014342398"],"corresponding_institution_ids":["https://openalex.org/I153718931"],"apc_list":null,"apc_paid":null,"fwci":12.783,"has_fulltext":false,"cited_by_count":338,"citation_normalized_percentile":{"value":0.98191903,"is_in_top_1_percent":false,"is_in_top_10_percent":true},"cited_by_percentile_year":{"min":99,"max":100},"biblio":{"volume":"20","issue":"6","first_page":"35","last_page":"39"},"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/T10430","display_name":"Software Engineering Techniques and Practices","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/T10703","display_name":"Business Process Modeling and Analysis","score":0.9966999888420105,"subfield":{"id":"https://openalex.org/subfields/1404","display_name":"Management Information Systems"},"field":{"id":"https://openalex.org/fields/14","display_name":"Business, Management and Accounting"},"domain":{"id":"https://openalex.org/domains/2","display_name":"Social Sciences"}}],"keywords":[{"id":"https://openalex.org/keywords/documentation","display_name":"Documentation","score":0.8620026111602783},{"id":"https://openalex.org/keywords/software-engineering","display_name":"Software engineering","score":0.7150650024414062},{"id":"https://openalex.org/keywords/software-documentation","display_name":"Software documentation","score":0.6747132539749146},{"id":"https://openalex.org/keywords/personal-software-process","display_name":"Personal software process","score":0.6131412982940674},{"id":"https://openalex.org/keywords/software-engineering-process-group","display_name":"Software Engineering Process Group","score":0.5846524238586426},{"id":"https://openalex.org/keywords/software-development","display_name":"Software development","score":0.545916736125946},{"id":"https://openalex.org/keywords/social-software-engineering","display_name":"Social software engineering","score":0.5427160859107971},{"id":"https://openalex.org/keywords/computer-science","display_name":"Computer science","score":0.5277087092399597},{"id":"https://openalex.org/keywords/software-peer-review","display_name":"Software peer review","score":0.5182704329490662},{"id":"https://openalex.org/keywords/software-construction","display_name":"Software construction","score":0.4763876795768738},{"id":"https://openalex.org/keywords/software-requirements","display_name":"Software requirements","score":0.4448925852775574},{"id":"https://openalex.org/keywords/software-project-management","display_name":"Software project management","score":0.4430141746997833},{"id":"https://openalex.org/keywords/software","display_name":"Software","score":0.428399920463562},{"id":"https://openalex.org/keywords/engineering-management","display_name":"Engineering management","score":0.3718569874763489},{"id":"https://openalex.org/keywords/engineering","display_name":"Engineering","score":0.3078145980834961},{"id":"https://openalex.org/keywords/programming-language","display_name":"Programming language","score":0.06508001685142517}],"concepts":[{"id":"https://openalex.org/C56666940","wikidata":"https://www.wikidata.org/wiki/Q788790","display_name":"Documentation","level":2,"score":0.8620026111602783},{"id":"https://openalex.org/C115903868","wikidata":"https://www.wikidata.org/wiki/Q80993","display_name":"Software engineering","level":1,"score":0.7150650024414062},{"id":"https://openalex.org/C81587897","wikidata":"https://www.wikidata.org/wiki/Q181702","display_name":"Software documentation","level":5,"score":0.6747132539749146},{"id":"https://openalex.org/C39890963","wikidata":"https://www.wikidata.org/wiki/Q1702721","display_name":"Personal software process","level":5,"score":0.6131412982940674},{"id":"https://openalex.org/C44416564","wikidata":"https://www.wikidata.org/wiki/Q7554199","display_name":"Software Engineering Process Group","level":5,"score":0.5846524238586426},{"id":"https://openalex.org/C529173508","wikidata":"https://www.wikidata.org/wiki/Q638608","display_name":"Software development","level":3,"score":0.545916736125946},{"id":"https://openalex.org/C182500959","wikidata":"https://www.wikidata.org/wiki/Q7551380","display_name":"Social software engineering","level":5,"score":0.5427160859107971},{"id":"https://openalex.org/C41008148","wikidata":"https://www.wikidata.org/wiki/Q21198","display_name":"Computer science","level":0,"score":0.5277087092399597},{"id":"https://openalex.org/C74579156","wikidata":"https://www.wikidata.org/wiki/Q7554342","display_name":"Software peer review","level":5,"score":0.5182704329490662},{"id":"https://openalex.org/C186846655","wikidata":"https://www.wikidata.org/wiki/Q3398377","display_name":"Software construction","level":4,"score":0.4763876795768738},{"id":"https://openalex.org/C54534927","wikidata":"https://www.wikidata.org/wiki/Q4462275","display_name":"Software requirements","level":5,"score":0.4448925852775574},{"id":"https://openalex.org/C40919944","wikidata":"https://www.wikidata.org/wiki/Q947779","display_name":"Software project management","level":5,"score":0.4430141746997833},{"id":"https://openalex.org/C2777904410","wikidata":"https://www.wikidata.org/wiki/Q7397","display_name":"Software","level":2,"score":0.428399920463562},{"id":"https://openalex.org/C110354214","wikidata":"https://www.wikidata.org/wiki/Q6314146","display_name":"Engineering management","level":1,"score":0.3718569874763489},{"id":"https://openalex.org/C127413603","wikidata":"https://www.wikidata.org/wiki/Q11023","display_name":"Engineering","level":0,"score":0.3078145980834961},{"id":"https://openalex.org/C199360897","wikidata":"https://www.wikidata.org/wiki/Q9143","display_name":"Programming language","level":1,"score":0.06508001685142517}],"mesh":[],"locations_count":2,"locations":[{"id":"doi:10.1109/ms.2003.1241364","is_oa":false,"landing_page_url":"https://doi.org/10.1109/ms.2003.1241364","pdf_url":null,"source":{"id":"https://openalex.org/S6725529","display_name":"IEEE Software","issn_l":"0740-7459","issn":["0740-7459","1937-4194"],"is_oa":false,"is_in_doaj":false,"is_core":true,"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 Software","raw_type":"journal-article"},{"id":"pmh:oai:cisti-icist.nrc-cnrc.ca:cistinparc:8913091","is_oa":false,"landing_page_url":"https://nrc-publications.canada.ca/eng/view/object/?id=5a51de7b-6ad9-48dc-80fc-ea8dc70d21a0","pdf_url":null,"source":{"id":"https://openalex.org/S7407055245","display_name":"NPARC","issn_l":null,"issn":null,"is_oa":false,"is_in_doaj":false,"is_core":false,"host_organization":null,"host_organization_name":null,"host_organization_lineage":[],"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":"article"}],"best_oa_location":null,"sustainable_development_goals":[{"id":"https://metadata.un.org/sdg/16","display_name":"Peace, Justice and strong institutions","score":0.6100000143051147}],"awards":[],"funders":[],"has_content":{"pdf":false,"grobid_xml":false},"content_urls":null,"referenced_works_count":5,"referenced_works":["https://openalex.org/W1606279605","https://openalex.org/W1849300141","https://openalex.org/W1957789923","https://openalex.org/W2109125971","https://openalex.org/W2180107243"],"related_works":["https://openalex.org/W4383428648","https://openalex.org/W1892703945","https://openalex.org/W2581854602","https://openalex.org/W2120376006","https://openalex.org/W2052544251","https://openalex.org/W2368620653","https://openalex.org/W2088814939","https://openalex.org/W1871001366","https://openalex.org/W63204633","https://openalex.org/W3132715913"],"abstract_inverted_index":{"Software":[0],"engineering":[1,24,37],"is":[2,25,62],"a":[3],"human":[4],"task,":[5],"and":[6,16,57,67,72,79,84,109],"as":[7,101,105],"such":[8],"we":[9],"must":[10],"study":[11],"what":[12],"software":[13,23,53,106,119],"engineers":[14,54],"do":[15,97],"think.":[17],"Understanding":[18],"the":[19,26,36,49,90,113],"normative":[20],"practice":[21],"of":[22],"first":[27],"step":[28],"toward":[29],"developing":[30],"realistic":[31],"solutions":[32],"to":[33,47,63],"better":[34,76],"facilitate":[35],"process.":[38],"We":[39],"conducted":[40],"three":[41],"studies":[42],"using":[43],"several":[44],"data-gathering":[45],"approaches":[46],"elucidate":[48],"patterns":[50],"by":[51,82],"which":[52],"(SEs)":[55],"use":[56],"update":[58,99],"documentation.":[59],"Our":[60,87],"objective":[61],"more":[64],"accurately":[65],"comprehend":[66],"model":[68],"documentation":[69,100,120],"use,":[70],"usefulness,":[71],"maintenance,":[73],"thus":[74],"enabling":[75],"decision":[77],"making":[78],"tool":[80],"design":[81],"developers":[83],"project":[85],"managers.":[86],"results":[88,114],"confirm":[89],"widely":[91],"held":[92],"belief":[93],"that":[94,117],"SEs":[95],"typically":[96],"not":[98],"timely":[102],"or":[103],"completely":[104],"process":[107],"personnel":[108],"managers":[110],"advocate.":[111],"However,":[112],"also":[115],"reveal":[116],"out-of-date":[118],"remains":[121],"useful":[122],"in":[123],"many":[124],"circumstances.":[125]},"counts_by_year":[{"year":2026,"cited_by_count":4},{"year":2025,"cited_by_count":7},{"year":2024,"cited_by_count":12},{"year":2023,"cited_by_count":16},{"year":2022,"cited_by_count":14},{"year":2021,"cited_by_count":20},{"year":2020,"cited_by_count":10},{"year":2019,"cited_by_count":15},{"year":2018,"cited_by_count":25},{"year":2017,"cited_by_count":22},{"year":2016,"cited_by_count":13},{"year":2015,"cited_by_count":21},{"year":2014,"cited_by_count":27},{"year":2013,"cited_by_count":24},{"year":2012,"cited_by_count":26}],"updated_date":"2026-04-04T16:13:02.066488","created_date":"2025-10-10T00:00:00"}