Difference between revisions of "Major release notes"

From Archivematica
Jump to navigation Jump to search
m
 
(13 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
[[Main_Page|Home]] > [[Release_Notes|Release Notes]] > Major release notes template
 
[[Main_Page|Home]] > [[Release_Notes|Release Notes]] > Major release notes template
  
'''IMPORTANT''': only link to Redmine tickets in the public [https://projects.artefactual.com/projects/archivematica?jump=welcome| Archivematica project]. If no public ticket exists, create a new ticket in the public Archivematica project and link it to the corresponding private ticket.
+
'''Release date'''
  
In the header, include any general notes about the release. For an example, see the
+
In the header, include any general notes about the release. For an example, see the [[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], [https://github.com/artefactual/archivematica/pull/191| PR191])
 
* '''Contributor''' ([https://github.com/sevein| sevein]) MCPServer: delete watchedDirectories/ duplicate - [https://github.com/artefactual/archivematica/pull/633| PR633]
 
  
===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.
 
  
* Short description of the bug fix (link to Redmine ticket, link to PR)
+
* Documentation: link
* Improvements to metadata.csv handling ([https://projects.artefactual.com/issues/7901| #7901], [https://projects.artefactual.com/issues/8007| #8007], [https://github.com/artefactual/archivematica/pull/210| PR210])
+
* Pull requests: link
  
===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
 
  
 +
* Documentation: link
 +
* Pull requests: link
 +
* Feature files: link
  
==ProjectName #.# - clean formatting==
+
==Changed==
  
Released MM DD, YYYY.
+
Describe enhancements or major fixes.
  
ProjectName #.# has one big, new, exciting feature and several small bug fixes.
+
===Enhancement 1===
  
===New features===
+
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.
  
* '''Sponsored''' (Name of sponsor) Short description of feature (link to Redmine ticket, link to PR)
+
This work was sponsored by some amazing institution. Thank you!
  
===Bug fixes===
+
* Documentation: link
 +
* Pull requests: link
 +
* Feature files: link
  
* Short description of the bug fix (link to Redmine ticket, link to PR)
+
==Fixed==
  
===New and upgraded tools===
+
List bugfixes with a link to the Github issue.
  
* Tool updated to version #.#
+
* 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.

Latest revision as of 16:37, 21 January 2019

Home > Release Notes > Major release notes template

Release date

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

Supported environments[edit]

Link to installation instructions.

Specify supported environments.

Make special note of any changes to supported environment.

Added[edit]

Describe new features.

New feature 1[edit]

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[edit]

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[edit]

Describe enhancements or major fixes.

Enhancement 1[edit]

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[edit]

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[edit]

List any tools and dependencies that have been upgraded.

  • Tool has been updated to version X.

End of life dependencies[edit]

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.