There is currently no fixed release schedule. A release is made when there are (important) enough new improvements or bug fixes to justify one, or when we get special requests from users.
There are three kinds of releases:
In general, smaller releases like bugfix releases can only be installed with the updater tool. Upon special request they can also be made available via download. Major releases with significant changes to the runtime can not be installed with the updater, for technical reasons.
Different versioning rules apply for different parts of the Pipeline. (For an overview of the various components see the page about source code.)
The version number of pipeline-assembly determines the main version of the Pipeline. Smaller changes are marked by updates of the patch segment, bigger changes are marker by updates of the minor segment.
The version numbers of “bom”, “parent” and “aggregator” POMs of framework and modules are aligned with the version of pipeline-assembly. Their major and minor segments should always match the latest version of pipeline-assembly, their patch segments may vary. The “bom” (bill of material) POMs are the places where the “current” versions of all bundles are listed. The boms are imported by the assembly, and every POM that has a dependency that is declared in a bom should import that bom. This way the version declarations are nicely centralized and reduced to a minimum.
Version numbering of bundles should be done according to the versioning rules of OSGi a.k.a. semantic versioning. Note that the “API” of a bundle is not always strictly defined (e.g. in case of public XSLT, XProc or CSS code) so there is a bit of room for interpretation. As an exception to this rule, the version numbers of forks of third-party libraries should match those of the corresponding original versions, possibly with some segments added to the number to distinguish versions.
For pipeline-clientlib-java, pipeline-webui, pipeline-cli-go and pipeline-updater, semantic versioning applies as well.
pipeline-clientlib-go is not versioned.
When updating version numbers, care must be taken to keep versions
numbers in project declarations and dependency declaractions
aligned. If both are snapshots, they must match. The super-build will
error if this is not the case. In addition, if a release has been made
of a certain component, or if significant changes have been made to it
since the last release, all dependent components should ideally be
updated as soon as possible to compile and test against the latest
version. This allows you to see the consequences of a change
immediately so that bugs are spotted sooner, and by running the test
suite you can ensure that all the latest components are compatible. It
can be enforced with the command make check-versions in the
super-project.
The assumption is made that at the time a release is made, a number of things have already been done beforehand, during development:
To initiate a release, run the following command in the super-project:
make release
This will generate instructions for releasing the assembly and all its components. The instructions are mostly just shell commands that can be executed without much thinking.
The release script covers the following:
The things the script does not cover are listed in the following checklist:
git subrepo-status --fetch.make release (see above).git push --tags in each of the sub repos).Edit the Github release pages of pipeline-mod-braille and pipeline-assembly. The pipeline-mod-braille release should contain only a link to the NEWS file:
The pipeline-assembly release should contain the full release notes from the NEWS file (see below). Save the pipeline-assembly release page as a draft.
make dist-exe
make dist-dmg
make dist-zip-linux
make dist-deb
make dist-rpm (must be built on a Red Hat machine)src/_data/versions.yml and src/_data/downloads.yml.git subrepo-rebase release/v1.10.0 master.Ideally the release notes should already be made prior to making the release, and milestones should have been set, however because life is not perfect, it is best to search the Github issues (use the link at https://github.com/daisy/pipeline#issues) for mistakes or things that were forgotten:
closed:>yyyy-mm-dd.no:milestone
milestone:v1.10.0
(only works for the “pipeline”, “pipeline-tasks”,
“pipeline-assembly”, “pipeline-framework” and the various module
repositories)Finalize the release notes by adding a link to the pipeline-mod-braille release notes as well as a list of links to closed issues (skip the empty ones):
### Details - [Closed issues in pipeline-tasks](https://github.com/issues?q=repo%3Adaisy%2Fpipeline-tasks+milestone%3Av1.10.0) - [Closed issues in pipeline](https://github.com/issues?q=repo%3Adaisy%2Fpipeline+milestone%3Av1.10.0) - [Closed issues in pipeline-assembly](https://github.com/issues?q=repo%3Adaisy%2Fpipeline-assembly+milestone%3Av1.10.0) - [Closed issues in pipeline-cli-go](https://github.com/issues?q=repo%3Adaisy%2Fpipeline-cli-go+milestone%3Av1.10.0) - [Closed issues in pipeline-framework](https://github.com/issues?q=repo%3Adaisy%2Fpipeline-framework+milestone%3Av1.10.0) - [Closed issues in pipeline-gui](https://github.com/issues?q=repo%3Adaisy%2Fpipeline-gui+milestone%3Av1.10.0) - [Closed issues in pipeline-mod-audio](https://github.com/issues?q=repo%3Adaisy%2Fpipeline-mod-audio+milestone%3Av1.10.0) - [Closed issues in pipeline-mod-braille](https://github.com/issues?q=repo%3Adaisy%2Fpipeline-mod-braille+milestone%3Av1.10.0) - [Closed issues in pipeline-mod-nlp](https://github.com/issues?q=repo%3Adaisy%2Fpipeline-mod-nlp+milestone%3Av1.10.0) - [Closed issues in pipeline-mod-tts](https://github.com/issues?q=repo%3Adaisy%2Fpipeline-mod-tts+milestone%3Av1.10.0) - [Closed issues in pipeline-modules-common](https://github.com/issues?q=repo%3Adaisy%2Fpipeline-modules-common+milestone%3Av1.10.0) - [Closed issues in pipeline-scripts](https://github.com/issues?q=repo%3Adaisy%2Fpipeline-scripts+milestone%3Av1.10.0) - [Closed issues in pipeline-scripts-utils](https://github.com/issues?q=repo%3Adaisy%2Fpipeline-scripts-utils+milestone%3Av1.10.0) - [Closed issues in pipeline-updater](https://github.com/issues?q=repo%3Adaisy%2Fpipeline-updater+milestone%3Av1.10.0) - [Closed issues in pipeline-updater-gui](https://github.com/issues?q=repo%3Adaisy%2Fpipeline-updater-gui+milestone%3Av1.10.0)
The “Release notes” section of the distribution README file in pipeline-assembly can be taken from the NEWS file. The details should be replaced with a link to the Github release page which has a full copy of the release notes.
An email announcement should be sent to the following lists:
The announcement can be based on the following template:
Subject: Pipeline 2 vXYZ released
Dear all,
Version XYZ of the DAISY Pipeline 2 project is now available for download. The following alternative packages are proposed:
- for Windows users (exe file, XX MB): https://github.com/daisy/pipeline-assembly/releases/download/vXYZ/pipeline2-XYZ_windows.exe
- for Mac OS X users (dmg file, XX MB): https://github.com/daisy/pipeline-assembly/releases/download/vXYZ/pipeline2-XYZ_mac.dmg
- for Linux users (zip file, XX MB): https://github.com/daisy/pipeline-assembly/releases/download/vXYZ/pipeline2-XYZ_linux.zip
- for Linux users (debian package, XX MB): https://github.com/daisy/pipeline-assembly/releases/download/vXYZ/pipeline2-XYZ_debian.deb
All distributions include the graphical user interface (GUI), all the conversion scripts, and a native command line tool (CLI).
This release features notably:
- XXX insert highlights of the release
For details, please refer to the full release notes: https://github.com/daisy/pipeline-assembly/releases/tag/vXYZ
User documentation is available on the project’s web site: http://daisy.github.io/pipeline/
If you have any problems or identify some bugs, please report them to the Pipeline team using our issue tracker on GitHub: https://github.com/daisy/pipeline/issues
As usual, feedback is warmly welcome!
Bert and Romain, for the Pipeline team
pipeline-webui and other components that are not included in pipeline-assembly are released separately.
For each release of the Pipeline 2, the steps below should be followed to test the release binaries:
TBD