dotnet / dotnet/templating

Versioning for template.json schema

Open
#2,594 0 comments 0 reactions 0 assignees View on GitHub
area: authoring Priority:3 triage:transfer-to-sdk triaged
Dominant language
No language data
Stars
1.7k
Forks
399
Avg merge
3d 5h
Merged PRs (30d)
39

Description

Consider establishing the versioning schema for `template.json` schemas:
- all previous version to use current schema - `template`
- n+1 version: template.json should be versioned as `template-`, example: `template-9.0.200`
- in case there is no changes to schema in certain version, the version is skipped.

Subtasks:
- [ ] release new version of `template-` schema to schemastore.org
- [ ] document schema versioning
- [ ] Implement check for schema version when running the template (based on $schema) - in case template version is higher than dotnet version, raise a warning (can be done via validation https://github.com/dotnet/templating/issues/2623)

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.