# [Dataset / Research Data Package Title]

<!--
README template v1.0
Scope: general-purpose / domain-neutral
Replace all text in square brackets and delete guidance comments that are not needed.
UA: Замініть текст у квадратних дужках та видаліть непотрібні коментарі-підказки.
-->

## 1. Overview

**Dataset / package title:** [Full title]

**Short description:**  
[In 2-5 sentences, explain what the dataset or package contains, why it was created, and its intended use.]

**Version:** [e.g., 1.0]

**Date:** [YYYY-MM-DD]

**Primary contact:** [Name, institution, email]

<!-- UA: Коротко опишіть зміст, мету та можливе повторне використання набору даних. -->

## 2. Package contents

Describe the main folders and files included in the package.

```text
[package-root]/
├── [folder-or-file]
├── [folder-or-file]
└── [folder-or-file]
```

If a separate manifest is provided, reference it here:

**File manifest:** [path or filename, e.g. fair_package_manifest.csv]

<!-- UA: Наведіть структуру пакета та посилання на маніфест файлів, якщо він є. -->

## 3. Data description

**Data type(s):** [tabular data / images / simulation output / observations / code / model / other]

**Main variables, entities, samples, or objects:**  
[Describe what is represented in the data.]

**Units and conventions:**  
[List important units, coordinate systems, naming conventions, encodings, or domain conventions.]

**Missing or special values:**  
[Explain missing-value codes, flags, sentinel values, or other special representations, if applicable.]

<!-- UA: Опишіть типи даних, основні змінні/об'єкти, одиниці та спеціальні значення. -->

## 4. Data generation or collection

**Source / acquisition method:**  
[Explain how the data were generated, measured, collected, simulated, or obtained.]

**Dates or period:** [YYYY-MM-DD or interval]

**Instruments / facilities / services:**  
[List relevant instruments, facilities, platforms, repositories, or external services.]

**Key parameters or settings:**  
[List parameters needed to understand the generation or collection process.]

<!-- UA: Опишіть походження даних, метод збирання/генерування, обладнання та ключові параметри. -->

## 5. Processing and quality control

**Processing steps:**  
[Describe cleaning, transformation, filtering, calibration, annotation, aggregation, or other processing.]

**Quality checks:**  
[Describe validation, error checking, uncertainty assessment, convergence tests, review, or other quality-control steps.]

**Known limitations:**  
[State known limitations, biases, uncertainties, incomplete coverage, or conditions affecting reuse.]

<!-- UA: Опишіть оброблення, перевірки якості та відомі обмеження. -->

## 6. Software and computational environment

[Complete this section when software is required to inspect, process, or reproduce the data.]

**Software / tools:** [name and version]

**Operating system / environment:** [if relevant]

**Dependencies:** [packages, libraries, containers, environment files]

**Configuration files:** [path or filename]

<!-- UA: Заповнюйте, якщо для роботи з даними потрібне ПЗ або обчислювальне середовище. -->

## 7. How to use or reproduce

Provide the minimum steps needed to open, inspect, analyse, or reproduce the data.

1. [Step 1]
2. [Step 2]
3. [Step 3]

**Expected outputs:**  
[Describe what the user should obtain if the procedure is completed successfully.]

<!-- UA: Наведіть мінімальні кроки для відкриття, аналізу або відтворення результатів. -->

## 8. Provenance and versioning

**Origin of the data:**  
[Identify the source data, prior dataset, experiment, workflow, software, or other origin.]

**Derived from:** [persistent identifier, URL, or local reference, if applicable]

**Versioning approach:**  
[Explain how versions are identified and what changes trigger a new version.]

**Detailed provenance file:** [path or filename, if available]

<!-- UA: Вкажіть походження даних, зв'язки з вихідними об'єктами та правила версіювання. -->

## 9. Access, licence, and reuse

**Access rights:** [open / restricted / embargoed / closed]

**Licence:** [e.g., CC BY 4.0, CC0 1.0, software licence, or other terms]

**Access restrictions or conditions:**  
[Describe restrictions, embargo dates, authentication requirements, sensitive-data conditions, or other limitations.]

**Recommended reuse conditions:**  
[State any attribution, citation, acknowledgement, or domain-specific reuse expectations.]

<!-- UA: Вкажіть режим доступу, ліцензію та умови повторного використання. -->

## 10. Citation

Please cite this dataset / package as:

> [Creator(s). (Year). Title. Version. Publisher/Repository. Persistent identifier.]

**Persistent identifier:** [DOI / Handle / ARK / URI / other]

<!-- UA: Наведіть рекомендований формат цитування та сталий ідентифікатор. -->

## 11. Related resources

- **Related publication(s):** [citation / DOI / URL]
- **Related dataset(s):** [identifier / URL]
- **Related software / code:** [repository / identifier / URL]
- **Related workflow / protocol:** [identifier / URL]
- **Project / grant:** [project name, grant number, URL]

<!-- UA: Вкажіть пов'язані публікації, набори даних, ПЗ, робочі процеси та проєкти. -->

## 12. Contact and support

**Contact person:** [Name]

**Institution / organisation:** [Name]

**Email:** [Email]

**Project or group:** [Optional]

<!-- UA: Вкажіть контакт для запитань щодо змісту, доступу або повторного використання даних. -->

## 13. Version history

| Version | Date | Changes | Responsible person / group |
|---|---|---|---|
| [1.0] | [YYYY-MM-DD] | [Initial release] | [Name / group] |

<!-- UA: Фіксуйте суттєві зміни між версіями пакета. -->