User Tools

Site Tools


contributing:release_notes

Writing Release Notes and Documentation for New Features

Release Notes

Every new feature (or otherwise significant change to Evergreen) should have a short description of what it does differently than before, and how to get it working. In particular, it should list any new settings or permissions included with the feature, and any existing settings or permissions that are required to use the feature. Also, if the feature influences the upgrade process (e.g. by adding required steps, increasing the ingest time, etc.), you should include this information in an “Upgrade Notes” section. Otherwise, Release Notes should be kept short and should usually not include screenshots or step-by-step instructions.

Files can be added to the source directory “RELEASE_NOTES_NEXT” in the appropriate subdirectory. Upgrade notes can be included in an “Upgrade Notes” section of your release notes or added as a separate file to an “upgrade” subdirectory within your appropriate subdirectory.

Bug fix release notes that don't require a longer explanation can make use of the Release-Notes: tag in git commit message. This automatically generates a release notes entry with a link to the bug report. See original bug report for details.

Normal Documentation

This should contain everything an Evergreen user or administrator needs to know about the new feature (or otherwise significant change to Evergreen). Screenshots and step-by-step instructions are generally very helpful. Files can be added to the source directory “DOCS_NEXT”. If you know where this information would fit best in the existing Evergreen documentation, please mention that on the DIG email list or add your files to the appropriate subdirectory under the “docs/” source directory.

contributing/release_notes.txt · Last modified: 2024/02/12 15:18 by stompro

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki

© 2008-2022 GPLS and others. Evergreen is open source software, freely licensed under GNU GPLv2 or later.
The Evergreen Project is a U.S. 501(c)3 non-profit organization.