<?xml version="1.0" encoding="UTF-8"?>
<modsCollection xmlns="http://www.loc.gov/mods/v3">
<mods ID="Nath-2022-Exploring">
    <titleInfo>
        <title>Exploring Relevant Artifacts of Release Notes: The Practitioners’ Perspective</title>
    </titleInfo>
    <name type="personal">
        <namePart type="given">Sristy</namePart>
        <namePart type="given">Sumana</namePart>
        <namePart type="family">Nath</namePart>
        <role>
            <roleTerm authority="marcrelator" type="text">author</roleTerm>
        </role>
    </name>
    <name type="personal">
        <namePart type="given">Banani</namePart>
        <namePart type="family">Roy</namePart>
        <role>
            <roleTerm authority="marcrelator" type="text">author</roleTerm>
        </role>
    </name>
    <originInfo>
        <dateIssued>2022</dateIssued>
    </originInfo>
    <typeOfResource>text</typeOfResource>
    <genre authority="bibutilsgt">journal article</genre>
    <relatedItem type="host">
        <titleInfo>
            <title>2022 IEEE International Conference on Software Analysis, Evolution and Reengineering (SANER)</title>
        </titleInfo>
        <originInfo>
            <issuance>continuing</issuance>
            <publisher>IEEE</publisher>
        </originInfo>
        <genre authority="marcgt">periodical</genre>
        <genre authority="bibutilsgt">academic journal</genre>
    </relatedItem>
    <abstract>A software release note is one of the essential documents in the software development life cycle. The software release contains a set of information, e.g., bug fixes and security fixes. Release notes are used in different phases, e.g., requirement engineering, software testing and release management. Different types of practitioners (e.g., project managers and clients) get benefited from the release notes to understand the overview of the latest release. As a result, several studies have been done about release notes production and usage in practice. However, two significant problems (e.g., duplication and inconsistency in release notes contents) exist in producing well-written &amp; well-structured release notes and organizing appropriate information regarding different targeted users’ needs. For that reason, practitioners face difficulties in writing and reading the release notes using existing tools. To mitigate these problems, we execute two different studies in our paper. First, we execute an exploratory study by analyzing 3,347 release notes of 21 GitHub repositories to understand the documented contents of the release notes. As a result, we find relevant key artifacts, e.g., issues (29%), pull-requests (32%), commits (19%), and common vulnerabilities and exposures (CVE) issues (6%) in the release note contents. Second, we conduct a survey study with 32 professionals to understand the key information that is included in release notes regarding users’ roles. For example, project managers are more interested in learning about new features than less critical bug fixes. Our study can guide future research directions to help practitioners produce the release notes with relevant content and improve the documentation quality.</abstract>
    <identifier type="citekey">Nath-2022-Exploring</identifier>
    <identifier type="doi">10.1109/saner53432.2022.00152</identifier>
    <location>
        <url>https://gwf-uwaterloo.github.io/gwf-publications/G22-10001</url>
    </location>
    <part>
        <date>2022</date>
    </part>
</mods>
</modsCollection>

%0 Journal Article
%T Exploring Relevant Artifacts of Release Notes: The Practitioners’ Perspective
%A Nath, Sristy Sumana
%A Roy, Banani
%J 2022 IEEE International Conference on Software Analysis, Evolution and Reengineering (SANER)
%D 2022
%I IEEE
%F Nath-2022-Exploring
%X A software release note is one of the essential documents in the software development life cycle. The software release contains a set of information, e.g., bug fixes and security fixes. Release notes are used in different phases, e.g., requirement engineering, software testing and release management. Different types of practitioners (e.g., project managers and clients) get benefited from the release notes to understand the overview of the latest release. As a result, several studies have been done about release notes production and usage in practice. However, two significant problems (e.g., duplication and inconsistency in release notes contents) exist in producing well-written & well-structured release notes and organizing appropriate information regarding different targeted users’ needs. For that reason, practitioners face difficulties in writing and reading the release notes using existing tools. To mitigate these problems, we execute two different studies in our paper. First, we execute an exploratory study by analyzing 3,347 release notes of 21 GitHub repositories to understand the documented contents of the release notes. As a result, we find relevant key artifacts, e.g., issues (29%), pull-requests (32%), commits (19%), and common vulnerabilities and exposures (CVE) issues (6%) in the release note contents. Second, we conduct a survey study with 32 professionals to understand the key information that is included in release notes regarding users’ roles. For example, project managers are more interested in learning about new features than less critical bug fixes. Our study can guide future research directions to help practitioners produce the release notes with relevant content and improve the documentation quality.
%R 10.1109/saner53432.2022.00152
%U https://gwf-uwaterloo.github.io/gwf-publications/G22-10001
%U https://doi.org/10.1109/saner53432.2022.00152

Markdown (Informal)

[Exploring Relevant Artifacts of Release Notes: The Practitioners' Perspective](https://gwf-uwaterloo.github.io/gwf-publications/G22-10001) (Nath & Roy, GWF 2022)

• Exploring Relevant Artifacts of Release Notes: The Practitioners’ Perspective (Nath & Roy, GWF 2022)

ACL

• Sristy Sumana Nath and Banani Roy. 2022. Exploring Relevant Artifacts of Release Notes: The Practitioners' Perspective. 2022 IEEE International Conference on Software Analysis, Evolution and Reengineering (SANER).