Форум FAIR

Яка роль changelog-файлів у проєктах Horizon Europe, якщо вимагається DMP?

• DMP = стратегія: політики, стандарти, ролі, де зберігаємо дані, як поширюємо.
• Changelog = хронологія фактів: що саме додано/змінено/вилучено у конкретних версіях (дані, код, метадані).
• Разом вони дають відтворюваність: DMP описує “як ми будемо це робити”, changelog фіксує “що ми реально зробили”.

• Дані: нові партії/записи, перерахунки, зміну одиниць або структури колонок.
• Код/конвеєри: версії інструментів, параметри, зміни в pipeline.
• Метадані: додані/оновлені словники змінних, пов’язані ресурси (RelatedIdentifier).
• Якість/перевірки: які аномалії виправлено, які QC-тести пройдено.
• Версія та дата: SemVer (MAJOR.MINOR.PATCH), ISO-дата релізу.

## [1.2.0] – 2025-08-15
### Added
- Додано вимірювання 2025-08-10..15 (3240 записів)
### Changed
- Перераховано daily_aggregates (kPa→MPa); оновлено словник змінних
### Fixed
- Виправлено 12 хибних timestamp (UTC)

• Data description & provenance → в changelog фіксуємо походження/перерахунки (і посилання в metadata/relationships.csv).
• Standards & metadata → описуємо, що версіюємо (дані/метадані/код) і як (SemVer); у changelog – фактичні зміни.
• Data sharing & reuse → changelog містить нотатку про нові/вилучені файли та ліцензії.
• Responsibilities → в DMP вказуємо ролі (дослідник/стюард/ІТ); у changelog ставимо контакт релізу.
• Preservation → в DMP політика версій/DOI; у changelog — позначки Deprecated/Removed.

У DMP опишіть політику: MAJOR (несумісні зміни) → новий DOI; MINOR/PATCH → та ж “concept” сутність, але нова версія. У changelog показуйте, чому саме підвищили версію.

• Zenodo: цитуйте Version DOI; “Concept DOI” веде на всі версії.
• Figshare/Dryad: кожна версія має власний DOI (або суфікс .vX); цитуйте конкретну.
• Dataverse: DOI для набору + в цитаті Version X.Y; changelog додавайте як файл “Documentation” і коротку анотацію в описі версії.

• У репозиторії проєкту: metadata/CHANGELOG.md (джерело правди).
• При релізі: короткий “Release notes vX.Y (YYYY-MM-DD)” вставити в опис чернетки набору; повний CHANGELOG завантажити як файл.
• Для автоматизації: CI (GitHub Actions) може копіювати summary з `CHANGELOG.md` у опис версії перед публікацією.

Versioning & change log policy:
- We maintain a machine-readable changelog (metadata/CHANGELOG.md) using SemVer (MAJOR.MINOR.PATCH).
- MAJOR changes (schema/unit-breaking) will receive a new DOI and will be linked via RelatedIdentifier.
- MINOR/PATCH releases will be updated under the same concept record; release notes are copied to the dataset version
  description in the repository; the full CHANGELOG.md is deposited as Documentation.
- Roles: Researcher (author), Data Steward (review/approval), IT (automation, tokens, backups).

• Як ви узгоджуєте changelog із розділами свого DMP?
• Чи створюєте новий DOI для кожного MAJOR? Як оформлюєте посилання на попередні версії?
• Які інструменти автоматизують оновлення опису версії у сховищі (скрипти/CI)?