Release Notes are documents that are shared with end users, customers and clients of an organization. The definition of the terms 'End Users', 'Clients' and 'Customers' are very relative in nature and might have various interpretations based on the specific context. For instance, the Quality Assurance group within a software development organization can be interpreted as an internal customer.6
Release notes detail the corrections, changes or enhancements (functional or non-functional) made to the service or product the company provides.789
They might also be provided as an artifact accompanying the deliverables for System Testing and System Integration Testing and other managed environments especially with reference to an information technology organization.
Release notes can also contain test results and information about the test procedure. This kind of information gives readers of the release note more confidence in the fix/change done; this information also enables implementer of the change to conduct rudimentary acceptance tests.
They differ from End-user license agreement, since they do not (should not) contain any legal terms of the software product or service. The focus should be on the software release itself, not for example legal conditions.10
Release notes can also be interpreted as describing how to install or build the software, instead of highlighting new features or resolved bugs.11 Another term often used in this context is System Requirements, meaning the required hardware and software for installing or building the software.
There is no standard format for release notes that is followed throughout different organizations. Organizations normally adopt their own formatting styles based on the requirement and type of the information to be circulated. The content of release notes also vary according to the release type. For products that are at testing stage and that are newly released, the content is usually more descriptive compared to release notes for bug fixes and feature enhancements, which are usually brief.
Release notes may include the following sections:
A release note is usually a terse summary of recent changes, enhancements and bug fixes in a particular software release. It is not a substitute for user guides. Release notes are frequently written in the present tense and provide information that is clear, correct, and complete.
A proposal for an open-specification exists and is called Release Notes Schema Specification.12
"Change Log Concepts (GNU Coding Standards)". www.gnu.org. Retrieved 2021-04-05. https://www.gnu.org/prep/standards/html_node/Change-Log-Concepts.html#Change-Log-Concepts ↩
Scott, James (2020-04-24). "The art of writing great release notes". Medium. Retrieved 2021-04-05. https://uxdesign.cc/the-art-of-writing-great-release-notes-6607e22efae1 ↩
"Releases (GNU Coding Standards)". www.gnu.org. Retrieved 2021-04-05. https://www.gnu.org/prep/standards/html_node/Releases.html#index-README-file ↩
"Version History - English - Knowledge Base". kb.i-doit.com. Retrieved 2021-10-10. https://kb.i-doit.com/display/en/Version+History ↩
"56508 - Zynq-7000 SoC, 14.6 FSBL - Is there a changelog?". Xilinx Support Keyword Search. https://support.xilinx.com/s/article/56508?language=en_US ↩
Hobbs, Brian; Besner, Claude (2016-05-01). "Projects with internal vs. external customers: An empirical investigation of variation in practice". International Journal of Project Management. 34 (4): 675–687. doi:10.1016/j.ijproman.2016.02.010. ISSN 0263-7863. https://doi.org/10.1016%2Fj.ijproman.2016.02.010 ↩
"Change Logs (GNU Coding Standards)". www.gnu.org. Retrieved 2021-04-05. https://www.gnu.org/prep/standards/html_node/Change-Logs.html#Change-Logs ↩
Wang, C.; Li, J.; Liang, P.; Daneva, M.; Sinderen, M. (September 2019). "Developers' Eyes on the Changes of Apps: An Exploratory Study on App Changelogs". 2019 IEEE 27th International Requirements Engineering Conference Workshops (REW). pp. 207–212. doi:10.1109/REW.2019.00042. ISBN 978-1-7281-5165-6. S2CID 209460408. 978-1-7281-5165-6 ↩
Bourne, Kelly C. (2014-01-01), Bourne, Kelly C. (ed.), "Chapter 10 - Updates and Patches", Application Administrators Handbook, Boston: Morgan Kaufmann, pp. 150–165, doi:10.1016/b978-0-12-398545-3.00010-8, ISBN 978-0-12-398545-3, retrieved 2021-03-25 978-0-12-398545-3 ↩
release-notes/release-notes-spec, Release Notes, 2021-03-25, retrieved 2021-03-25 https://github.com/release-notes/release-notes-spec ↩
"Linux kernel release 5.x — The Linux Kernel documentation". www.kernel.org. Retrieved 2021-03-25. https://www.kernel.org/doc/html/latest/admin-guide/README.html ↩
Moreno, L.; Bavota, G.; Penta, M. D.; Oliveto, R.; Marcus, A.; Canfora, G. (February 2017). "ARENA: An Approach for the Automated Generation of Release Notes". IEEE Transactions on Software Engineering. 43 (2): 106–127. doi:10.1109/TSE.2016.2591536. ISSN 1939-3520. https://doi.org/10.1109%2FTSE.2016.2591536 ↩