Skip to content

Commit ce8d081

Browse files
docs(curation): document version tag generation in curation guide
- Explain how rebuild script creates tags only for changed datasets - Cross-link to user-facing documentation in nextclade repo
1 parent b95d811 commit ce8d081

1 file changed

Lines changed: 8 additions & 0 deletions

File tree

docs/dataset-curation-guide.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -214,6 +214,14 @@ This will tell Nextclade to fetch your modified datasets right from GitHub (GitH
214214
215215
If you don't want to submit your datasets to this repository, or prefer to deploy your datasets to your own GitHub repository or to your own web server, then follow [Dataset server maintenance guide](dataset-server-maintenance.md) for how to set it up.
216216
217+
## Version tags and releases
218+
219+
When the rebuild script processes datasets for a release, it creates a new version tag only for datasets whose files have changed since the previous release. The script compares each dataset directory against its last known tag using `git diff` and skips version creation for unchanged datasets. This means that a given release timestamp (e.g. `2026-04-14--11-55-23Z`) exists as a version tag only for the datasets that were modified in that release.
220+
221+
Unchanged datasets retain their previous version tag and continue to be served under it. The `version` field in `index.json` always points to the latest available tag for each dataset, regardless of which release produced it.
222+
223+
For user-facing documentation on how this affects workflows and how to query the latest tag for a dataset, see [Version tags are per-dataset](https://docs.nextstrain.org/projects/nextclade/en/stable/user/datasets.html#version-tags-are-per-dataset).
224+
217225
## Questions, ideas, bug reports
218226
219227
For all questions, ideas, bug reports relevant to datasets, please open [a GitHub issue](https://github.com/nextstrain/nextclade_data/issues) in this repository or join our [discussion forum](https://discussion.nextstrain.org/).

0 commit comments

Comments
 (0)