release-tools/etc/notes.tt

# RELEASE NOTES FOR KOHA [% version.human %]
[% date %]

Koha is the first free and open source software library automation
package (ILS). Development is sponsored by libraries of varying types
and sizes, volunteers, and support companies from around the world. The
website for the Koha project is:

- [Koha Community](http://koha-community.org)

Koha [% version.human %] can be downloaded from:

- [Download]([% IF version.ismajor %]http://download.koha-community.org/koha-[% version.next_version_human %]-latest.tar.gz[% ELSE %]http://download.koha-community.org/koha-[% version.human %].tar.gz[% END %])

Installation instructions can be found at:

- [Koha Wiki](http://wiki.koha-community.org/wiki/Installation_Documentation)
- OR in the INSTALL files that come in the tarball

Koha [% version.human %] is [% IF version.ismajor %]a major release, that comes with many new features[% ELSE %]a bugfix/maintenance release[% IF bugscount.secu %] with security fixes[% END %][% END %].

It includes
[%- IF bugscount.secu -%]
 [% bugscount.secu %] security fixes,
[%- END -%]
[%- IF bugscount.feature -%]
 [% bugscount.feature %] new features,
[%- END -%]
[%- IF bugscount.enh -%]
 [% bugscount.enh %] enhancements,
[%- END -%]
 [% bugscount.normal %] bugfixes.

### System requirements

You can learn about the system components (like OS and database) needed for running Koha here: https://wiki.koha-community.org/wiki/System_requirements_and_recommendations

[% INCLUDE buglist
     bug = bugs.secu
     title = 'Security bugs'
%]

[%- INCLUDE buglist
     bug = bugs.feature
     title = 'New features'
-%]

[% INCLUDE buglist
     bug = bugs.enh
     title = 'Enhancements'
%]

[% INCLUDE buglist
     bug = bugs.high
     title = 'Critical bugs fixed'
     bugfix = 1
%]

[% INCLUDE buglist
     bug = bugs.normal
     title = 'Other bugs fixed'
     bugfix = 1
%]

[%- IF sysprefs.added.size %]
## New system preferences
[% FOREACH syspref IN sysprefs.added -%]
- [% syspref %]
[% END %][% END %]

[%- IF sysprefs.deleted.size %]
## Deleted system preferences
[% FOREACH syspref IN sysprefs.deleted -%]
- [% syspref %]
[% END %][% END %]

## Documentation

The Koha manual is maintained in Sphinx. The home page for Koha 
documentation is 

- [Koha Documentation](http://koha-community.org/documentation/)

As of the date of these release notes, only the English version of the
Koha manual is available:

- [Koha Manual](http://koha-community.org/manual/[% version.next_version_human %]/en/html/)


The Git repository for the Koha manual can be found at

- [Koha Git Repository](https://gitlab.com/koha-community/koha-manual)


[%- IF translations -%]
## Translations

Complete or near-complete translations of the OPAC and staff
interface are available in this release for the following languages:
[% FOREACH translation IN translations %]
- [% translation.language %][% IF translation.pcent %] ([% translation.pcent %]%)[% END %][% END %][% END %]

Partial translations are available for various other languages.

The Koha team welcomes additional translations; please see

- [Koha Translation Info](http://wiki.koha-community.org/wiki/Translating_Koha)

For information about translating Koha, and join the koha-translate 
list to volunteer:

- [Koha Translate List](http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-translate)

The most up-to-date translations can be found at:

- [Koha Translation](http://translate.koha-community.org/)

## Release Team

The release team for Koha [% version.human %] is


- Release Manager: [% INCLUDE person p=team.manager %]
[%- IF team.manager_assistant %]

- Release Manager assistant: [% INCLUDE person p=team.manager_assistant %]
[% END -%]
[%- IF team.manager_assistants %]

- Release Manager assistants:
[%- FOREACH pp IN team.manager_assistants %]
  - [% INCLUDE person p=pp %][% END -%]
[% END -%]
[%- IF team.mm %]

- Module Maintainers:[% FOREACH maint IN team.mm %]
  - [% maint.module %] -- [% INCLUDE person p=maint %][% END -%]
[% END -%]
[%- IF team.qa_manager %]

- QA Manager: [% INCLUDE person p=team.qa_manager %]
[%- END -%]
[%- IF team.qa %]

- QA Team:[% FOREACH qa IN team.qa %]
  - [% INCLUDE person p=qa %][% END -%]
[% END -%]
[%- IF team.te %]

- Topic Experts:[% FOREACH maint IN team.te %]
  - [% maint.area %] -- [% INCLUDE person p=maint %][% END -%]
[% END -%]
[%- IF team.bugwrangler %]

- Bug Wranglers:[% FOREACH wrangler IN team.bugwrangler %]
  - [% INCLUDE person p=wrangler %][% END -%]
[% END -%]
[%- IF team.packaging %]
[%- IF team.packaging.list.size == 1 %]

- Packaging Manager: [% INCLUDE person p=team.packaging %]
[% ELSE %]

- Packaging Managers:[% FOREACH pp IN team.packaging %]
  - [% INCLUDE person p=pp %][% END -%]
[% END -%]
[% END -%]
[%- IF team.documentation %]
[%- IF team.documentation.list.size == 1 %]

- Documentation Manager: [% INCLUDE person p=team.documentation %]
[% ELSE %]

- Documentation Managers:[% FOREACH pp IN team.documentation %]
  - [% INCLUDE person p=pp %][% END -%]
[% END -%]
[% END -%]
[%- IF team.documentation_team %]

- Documentation Team:[% FOREACH pp IN team.documentation_team %]
  - [% INCLUDE person p=pp %][% END -%]
[% END -%]
[%- IF team.translation %]

- Translation Manager: [% INCLUDE person p=team.translation %]
[% END -%]
[%- IF team.translations %]

- Translation Managers: [% FOREACH t IN team.translations %]
  - [% INCLUDE person p=t %][% END -%]
[% END -%]
[%- IF team.wiki %]

- Wiki curators: [% FOREACH wiki IN team.wiki %]
  - [% INCLUDE person p=wiki %][% END -%]
[% END -%]
[%- IF team.maintainer %]

- Release Maintainers:[% FOREACH maint IN team.maintainer %]
  - [% maint.version %] -- [% INCLUDE person p=maint %][% END -%]
[% END -%]
[%- IF team.maintainer_assistants %]

- Release Maintainer assistants:[% FOREACH pp IN team.maintainer_assistants %]
  - [% pp.version %] -- [% INCLUDE person p=pp -%][% END -%]
[% END -%]
[%- IF team.maintainer_mentors %]

- Release Maintainer mentors:[% FOREACH pp IN team.maintainer_mentors %]
  - [% pp.version %] -- [% INCLUDE person p=pp -%][% END -%]
[% END -%]


## Credits

[%- IF sponsors.size -%]
We thank the following libraries who are known to have sponsored
new features in Koha [% version.human %]:
[% FOREACH sponsor IN sponsors %]
- [%- IF sponsor.value -%][[% sponsor.key %]]([% sponsor.value %])[%- ELSE -%][% sponsor.key %][%- END -%][% END %]
[% END %]

[%- IF contributors -%]
We thank the following individuals who contributed patches to Koha [% version.human %].
[% FOREACH contributor IN contributors %]
- [% contributor.name %] ([% contributor.commits %])[% END %]
[% END %]

[%- IF companies -%]
We thank the following libraries, companies, and other institutions who contributed
patches to Koha [% version.human %]
[% FOREACH company IN companies %]
- [% company.name %] ([% company.commits %])[% END %]
[% END %]

[%- IF signers -%]
We also especially thank the following individuals who tested patches
for Koha.
[% FOREACH signer IN signers %]
- [% signer.name %] ([% signer.signoffs %])[%- END -%]
[% END %]

[%- IF version.ismajor AND manual_contributors %]
And people who contributed to the Koha manual during the release cycle of Koha [% version.human %].
[% FOREACH contributor IN manual_contributors %]
  * [% contributor.name %] ([% contributor.commits %])[%- END -%][% END %]

[%- IF mentors.size -%]
We thank the following individuals who mentored new contributors to the Koha project.
[% FOREACH mentor IN mentors %]
- [% mentor.name %][% END %]
[% END %]

We regret any omissions.  If a contributor has been inadvertently missed,
please send a patch against these release notes to 
koha-patches@lists.koha-community.org.

## Revision control notes

The Koha project uses Git for version control.  The current development 
version of Koha can be retrieved by checking out the master branch of:

- [Koha Git Repository](https://git.koha-community.org/koha-community/koha)

The branch for this version of Koha and future bugfixes in this release
line is [% branch %].

## Bugs and feature requests

Bug reports and feature requests can be filed at the Koha bug
tracker at:

- [Koha Bugzilla](http://bugs.koha-community.org)

He rau ringa e oti ai.
(Many hands finish the work)

Autogenerated release notes updated last on [% timestamp %].

[%- BLOCK person -%]
[% IF p.email %][[% p.name %]](mailto:[% p.email %])[% ELSE %][% p.name %][% END %]
[%- END -%]

[%- BLOCK buglist -%]
[%- IF bug -%]

## [% title %]
[%- IF bugfix && version.ismajor -%]


(This list includes all bugfixes since the previous major version. Most of them
have already been fixed in maintainance releases)[%- END -%]
[% FOREACH component IN bug %]

### [% component.key %]
[% FOREACH b IN component.value %]
- [[[% b.id %]]](http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=[% b.id %]) [% b.desc %]
[%- IF b.sponsors -%]


  **Sponsored by** [%- FOREACH s IN b.sponsors -%][% IF !loop.first && !loop.last -%], [%- END -%][%- IF loop.count > 1 && loop.last -%] and [%- END -%]*[%- s.key -%]*[%- END -%]
[%- END -%]
[%- IF b.notes -%]


[%- FOREACH n IN b.notes %]
  >[% n %]
[%- END -%]
[%- END -%]
[%- END -%]
[%- END -%]
[%- END -%]
[%- END -%]