From b5267068e429d1eb03014f0f17fe9322711b90da Mon Sep 17 00:00:00 2001 From: jo Date: Wed, 20 Jul 2022 12:47:15 +0200 Subject: [PATCH] docs: add releases distributions support --- README.md | 17 ------------ docs/admin-manual/setup/install.md | 9 ++++--- docs/developer-manual/development/releases.md | 27 +++++++++++++++++++ 3 files changed, 32 insertions(+), 21 deletions(-) create mode 100644 docs/developer-manual/development/releases.md diff --git a/README.md b/README.md index 5768bb294..4ed6bb7c0 100644 --- a/README.md +++ b/README.md @@ -37,23 +37,6 @@ provided here. The full text of the contract is licensed under the GPL and available at the above link courtesy of the [ZeroMQ community](https://zeromq.org/). -## Releasing - -The LibreTime maintainers release new versions of LibreTime at regular -intervals. We follow the [Semantic Versioning](https://semver.org/spec/v2.0.0.html) -standards. - -In a nutshell, given a version number MAJOR.MINOR.PATCH we increment the: - -1. MAJOR version when we make incompatible API changes, -2. MINOR version when we add functionality in a backwards-compatible manner, and -3. PATCH version when we make backwards-compatible bug fixes. - -Given the history of the project we will be starting with version 3.0.0. - -Stay tuned for early alphas and lots of betas as we get development -up and running. - ## Support To get support for any questions or problems you might have using the software diff --git a/docs/admin-manual/setup/install.md b/docs/admin-manual/setup/install.md index 5a496a781..c574416a3 100644 --- a/docs/admin-manual/setup/install.md +++ b/docs/admin-manual/setup/install.md @@ -23,14 +23,15 @@ You can install LibreTime using the one of the following methods: #### Minimum system requirements -- One of the following Linux distributions - - Ubuntu [current LTS](https://wiki.ubuntu.com/Releases). - [Note Ubuntu 22.04 LTS is not yet supported](https://github.com/libretime/libretime/issues/1845) - - Debian [current stable](https://www.debian.org/releases/) - 1 Ghz Processor - 2 GB RAM recommended (1 GB required) - A static external IP address ([How to setup a static ip using Netplan](../tutorials/setup-a-static-ip-using-netplan.md)) +One of the [supported distribution releases](../../developer-manual/development/releases.md#distributions-releases-support): + +- [Debian 11](https://www.debian.org/releases/) +- [Ubuntu 20.04 LTS](https://wiki.ubuntu.com/Releases) + :::warning Make sure that you have configured a **firewall** and it's not blocking connection to the desired ports. diff --git a/docs/developer-manual/development/releases.md b/docs/developer-manual/development/releases.md new file mode 100644 index 000000000..edbfb177a --- /dev/null +++ b/docs/developer-manual/development/releases.md @@ -0,0 +1,27 @@ +--- +title: Releases +--- + +## Distributions releases support + +New releases target the current stable distributions release, and development should prepare for future stable distributions releases. + +- We recommend installing LibreTime on the current stable distributions. +- Maintenance only releases will provide bug and security fixes for stable and old stable distributions. + +| | Ubuntu 18.04 | Debian 10 | Ubuntu 20.04 | Debian 11 | +| ------------ | :----------: | :---------: | :----------: | :---------: | +| Release date | 2018-04-26 | 2019-07-06 | 2020-04-23 | 2021-08-14 | +| End of life | 2023-04 | 2024-06 | 2025-04 | 2026-06 | +| Versions | | | | | +| 3.0.x | maintenance | maintenance | recommended | recommended | + +## Versioning schema + +We follow the [Semantic Versioning](https://semver.org/spec/v2.0.0.html) standards. + +In a nutshell, given a version number `MAJOR.MINOR.PATCH` we increment the: + +1. `MAJOR` version when we make incompatible API changes, +2. `MINOR` version when we add functionality in a backwards-compatible manner, and +3. `PATCH` version when we make backwards-compatible bug fixes.