Difference between revisions of "Major release notes"

From Archivematica
Jump to navigation Jump to search
Line 6: Line 6:
 
  [[Archivematica_1.6_release_notes|Archivematica 1.6 Release Notes]].
 
  [[Archivematica_1.6_release_notes|Archivematica 1.6 Release Notes]].
  
==ProjectName #.#==
+
==Supported environments==
  
Each section (Archivematica, Storage Service, FIDO) should follow the same pattern.
+
Link to installation instructions.
Indicate the date of the release and include a short description about the scope of
 
the release, especially if there are large changes.
 
  
Released MM DD, YYYY.
+
Specify supported environments.
  
Archivematica #.# includes two new features, which are amazing. There are also several bug fixes to improve all sorts of things.
+
Make special note of any changes to supported environment.
  
===New features===
+
==Added==
  
List new features as bullet points, indicating the name of the sponsor or
+
Describe new features.
contributor (if available), a short description of the work, and links to
 
the Redmine ticket and/or Github pull request.
 
  
* '''Sponsored''' (Name of sponsor) Short description of feature - (link to Redmine ticket, link to PR)
+
===New feature 1===
* '''Sponsored''' (GE Aviation) Bag ingest improvements - ([https://projects.artefactual.com/issues/8309| #8309])
 
  
===Bug fixes===
+
This is a description of this amazing feature! Here's why it's a net benefit to the project and the community. Also included are any special notes, like if it's a beta feature.
  
List bug fixes as bullet points and include links to the Redmine ticket and Github
+
This work was sponsored by some amazing institution. Thank you!
pull request.
 
  
* '''Sponsored''' (Name of sponsor) Short description of the bug fix - (link to Redmine ticket, link to PR)
+
* Documentation: link
* '''Contributor''' ([https://github.com/sevein| sevein]) MCPServer: delete watchedDirectories/ duplicate - [https://github.com/artefactual/archivematica/pull/633| PR633]
+
* Pull requests: link
* Improvements to metadata.csv handling - ([https://projects.artefactual.com/issues/7901| #7901], [https://projects.artefactual.com/issues/8007| #8007])
 
  
===New and upgraded tools===
+
===New feature 2===
  
List which tool has been updated/upgraded and to which version.
+
Here is a description of this amazing feature! Here's why it's a net benefit to the project and the community, and here is how it will impact your workflow. Also included are any special notes, like if it's a beta feature.
  
* Tool updated to version #.#
+
This work was sponsored by some amazing institution. Thank you!
* Elasticsearch updated to version 1.3
 
  
==ProjectName #.# - clean template==
+
* Documentation: link
 +
* Pull requests: link
 +
* Feature files: link
  
Released MM DD, YYYY.
+
==Changed==
  
ProjectName #.# has one big, new, exciting feature and several small bug fixes.
+
Describe enhancements or major fixes.
  
===New features===
+
===Enhancement 1===
  
* '''Sponsored''' (Name of sponsor) Short description of feature - (link to Redmine ticket, link to PR)
+
We fixed this issue. Here's why it's a net benefit to the project and the community, and here is how it will impact your workflow. Also included are any special notes, like if it's a beta feature.
* '''Contributor''' (Name of sponsor, link to Github profile) Short description of feature - (link to Redmine ticket, link to PR)
 
  
===Bug fixes===
+
This work was sponsored by some amazing institution. Thank you!
  
* Short description of the bug fix - (link to Redmine ticket, link to PR)
+
* Documentation: link
 +
* Pull requests: link
 +
* Feature files: link  
  
===New and upgraded tools===
+
==Fixed==
  
* Tool updated to version #.#
+
List bugfixes with a link to the Github issue.
 +
 
 +
* Bugfix 1: link
 +
* Bugfix 2: link. Sponsored by someone!
 +
* Bugfix 3: link
 +
 
 +
==Upgraded tools and dependencies==
 +
 
 +
List any tools and dependencies that have been upgraded.
 +
 
 +
* Tool has been updated to version X.
 +
 
 +
==End of life dependencies
 +
 
 +
List any dependencies that have reached end of life since the last release, as well as a note on the plan going forward.
 +
 
 +
Make note of any risks, and how users can mitigate them.

Revision as of 13:12, 3 May 2018

Home > Release Notes > Major release notes template

IMPORTANT: only link to Redmine tickets in the public Archivematica project. If no public ticket exists, create a new ticket in the public Archivematica project and link it to the corresponding private ticket.

In the header, include any general notes about the release. For an example, see the
Archivematica 1.6 Release Notes.

Supported environments

Link to installation instructions.

Specify supported environments.

Make special note of any changes to supported environment.

Added

Describe new features.

New feature 1

This is a description of this amazing feature! Here's why it's a net benefit to the project and the community. Also included are any special notes, like if it's a beta feature.

This work was sponsored by some amazing institution. Thank you!

  • Documentation: link
  • Pull requests: link

New feature 2

Here is a description of this amazing feature! Here's why it's a net benefit to the project and the community, and here is how it will impact your workflow. Also included are any special notes, like if it's a beta feature.

This work was sponsored by some amazing institution. Thank you!

  • Documentation: link
  • Pull requests: link
  • Feature files: link

Changed

Describe enhancements or major fixes.

Enhancement 1

We fixed this issue. Here's why it's a net benefit to the project and the community, and here is how it will impact your workflow. Also included are any special notes, like if it's a beta feature.

This work was sponsored by some amazing institution. Thank you!

  • Documentation: link
  • Pull requests: link
  • Feature files: link

Fixed

List bugfixes with a link to the Github issue.

  • Bugfix 1: link
  • Bugfix 2: link. Sponsored by someone!
  • Bugfix 3: link

Upgraded tools and dependencies

List any tools and dependencies that have been upgraded.

  • Tool has been updated to version X.

==End of life dependencies

List any dependencies that have reached end of life since the last release, as well as a note on the plan going forward.

Make note of any risks, and how users can mitigate them.