Выпуск

В рамках данного проекта присутствуют несколько отдельных подпроектов: определение данных, файлы данных, pkgship, отслеживание патчей, инструмент advisor. Данные и различные инструменты являются относительно независимыми, поэтому выпуск осуществляется отдельно для каждого подпроекта, а не для всего проекта в целом.

Версионирование подпроектов

Все отдельно выпускаемые подпроекты используют версионирование в соответствии с Semver 2.0, используя формат major.minor.patch, где:

• поле major увеличивается при изменении обратной совместимости, например, если API стало некомпактным со старой версией;
• поле minor увеличивается при добавлении новых возможностей;
• поле patch увеличивается при исправлении ошибок, багфиксов или обновлении документации без добавления новых возможностей.

Нумерация тегов подпроектов

Для различия между подпроектами используется префикс, например:

• Префикс для определения данных: data-api-v. Например, data-api-v1.0.0
• Префикс для отслеживания патчей: patch-tracking-v. Например, patch-tracking-v1.1.0
• Префикс для pkgship: pkgship-v. Например, pkgship-v1.2.0

Управление ветками

Проект openEuler-Advisor находится в активной стадии развития, поэтому LTS поддержка не предоставляется. Текущий режим управления ветками — это одна основная ветка main.``` Q: Что делать, если потребуется поддержка LTS для открытых релизов (например, для openEuler)? A: Поддержка будет осуществляться через патчи в openEuler src-repo. Если проблема существует в ветке master, вы можете отправить PR.

Q: Есть ли планы по предоставлению LTS версий? A: На данный момент такие планы отсутствуют.

  - Ответственные за каждый подпроект могут запросить выпуск новой версии, создав PR. В этом случае требуется добавить информацию о выпуске в файл ChangeLog.md каждого подпроекта, следуя примеру ниже:

Выпуск pkgship v1.2.0: - Добавлена XXX функциональность - Исправлена XXX проблема

- После согласования maintainer'ом и слияния коммита, немедленно создаётся выпуск [release](https://gitee.com/openeuler/openEuler-Advisor/releases/new), содержащий информацию, строго соответствующую ChangeLog.md. Пример:
  - **Тег версии:** `pkgship-v1.2.0`
    Примечание: рекомендованное имя для rpm spec должно быть `pkgship`, а номер версии — `1.2.0`.
  - **Название выпуска:** `Выпуск pkgship v1.2.0`
  - **Описание выпуска:**

 - Добавлена XXX функциональность
 - Исправлена XXX проблема

    Примечание: рекомендованное описание для rpm spec должно содержать соответствующие изменения.
  - **Приложения**
    - Рекомендуется добавить Makefile для каждого подпроекта (особенно для инструментальных), чтобы обеспечить возможность создания пакетов с помощью команды `make dist`. Это позволит создать файлы pkgship-v1.2.0.tar.gz и pkgship-v1.2.0.sha256.

  - В случае отсутствия, Maintainer генерирует соответствующий выпуск
  Примечание: ссылка на приложение включается в раздел SOURCE каждого rpm spec

Качество выпуска (необходимо дополнять)