From dee4da99fdf36f1a3c2bee9d674b39d3552116cb Mon Sep 17 00:00:00 2001 From: Pete Davison Date: Thu, 28 Dec 2023 16:52:00 +0000 Subject: [PATCH] docs: update v2 schema docs --- docs/docs/deprecations/version_2_schema.md | 25 ++++++++++++---------- docs/docs/taskfile_versions.md | 18 ++++++++-------- 2 files changed, 23 insertions(+), 20 deletions(-) diff --git a/docs/docs/deprecations/version_2_schema.md b/docs/docs/deprecations/version_2_schema.md index 7de6d8e285..9b665f1f77 100644 --- a/docs/docs/deprecations/version_2_schema.md +++ b/docs/docs/deprecations/version_2_schema.md @@ -9,18 +9,21 @@ slug: /deprecations/version-2-schema/ - Any Taskfiles that use the version 2 schema - `Taskvar.yml` files -The Taskfile v2 schema was introduced in March 2018 and replaced by version 3 in -August the following year. Users have had a long time to update and so we feel -that it is time to tidy up the codebase and focus on new functionality instead. +The Taskfile version 2 schema was introduced in March 2018 and replaced by +version 3 in August 2019. In May 2023 [we published a deprecation +notice][deprecation-notice] for the version 2 schema on the basis that the vast +majority of users had already upgraded to version 3 and removing support for +version 2 would allow us to tidy up the codebase and focus on new functionality +instead. -This notice does not mean that we are immediately removing support for version 2 -schemas. However, support will not be extended to future major releases and we -_strongly recommend_ that anybody still using a version 2 schema upgrades to -version 3 as soon as possible. - -A list of changes between version 2 and version 3 are available in the [Task v3 -Release Notes][version-3-release-notes]. +In December 2023, the final version of Task that supports the version 2 schema +([v3.33.0][v3.33.0]) was published and all legacy code was removed from Task's +main branch. To use a more recent version of Task, you will need to ensure that +your Taskfile uses the version 3 schema instead. A list of changes between +version 2 and version 3 are available in the [Task v3 Release Notes][v3.0.0]. -[version-3-release-notes]: https://github.com/go-task/task/releases/tag/v3.0.0 +[v3.0.0]: https://github.com/go-task/task/releases/tag/v3.0.0 +[v3.33.0]: https://github.com/go-task/task/releases/tag/v3.33.0 +[deprecation-notice]: https://github.com/go-task/task/issues/1197 diff --git a/docs/docs/taskfile_versions.md b/docs/docs/taskfile_versions.md index 0391d8929a..989e17c278 100644 --- a/docs/docs/taskfile_versions.md +++ b/docs/docs/taskfile_versions.md @@ -82,8 +82,8 @@ tasks: :::caution -v2 schema support is [deprecated][deprecate-version-2-schema] and will be -removed in a future release. +v2 schemas are [no longer supported by the latest version of +Task][deprecate-version-2-schema]. ::: @@ -106,8 +106,8 @@ Please check the [documentation][includes] :::caution -v2 schema support is [deprecated][deprecate-version-2-schema] and will be -removed in a future release. +v2 schemas are [no longer supported by the latest version of +Task][deprecate-version-2-schema]. ::: @@ -125,8 +125,8 @@ includes: :::caution -v2 schema support is [deprecated][deprecate-version-2-schema] and will be -removed in a future release. +v2 schemas are [no longer supported by the latest version of +Task][deprecate-version-2-schema]. ::: @@ -170,8 +170,8 @@ tasks: :::caution -v2 schema support is [deprecated][deprecate-version-2-schema] and will be -removed in a future release. +v2 schemas are [no longer supported by the latest version of +Task][deprecate-version-2-schema]. ::: @@ -256,7 +256,7 @@ The variable priority order was also different: 4. `Taskvars.yml` variables -[deprecate-version-2-schema]: https://github.com/go-task/task/issues/1197 +[deprecate-version-2-schema]: /deprecations/version-2-schema/ [output]: /usage#output-syntax [ignore_errors]: /usage#ignore-errors [includes]: /usage#including-other-taskfiles