diff --git a/README.md b/README.md index b6cd020a7f5..e5c15a1e15d 100644 --- a/README.md +++ b/README.md @@ -68,6 +68,9 @@ a cluster with **Kubernetes version 1.15 or later***. _See [our API compatibility policy](api_compatibility_policy.md) for info on the stability level of the API._ +_See [our Deprecations table](docs/deprecations.md) for features that have been +deprecated and the earliest date they'll be removed._ + ## Migrating ### v1alpha1 to v1beta1 diff --git a/docs/deprecations.md b/docs/deprecations.md new file mode 100644 index 00000000000..926329a3eda --- /dev/null +++ b/docs/deprecations.md @@ -0,0 +1,25 @@ + + + +# Deprecations + +- [Introduction](#introduction) +- [Deprecation Table](#deprecation-table) + +## Introduction + +This doc provides a list of features in Tekton Pipelines that are +being deprecated. + +## Deprecation Table + +| Feature Being Deprecated | Deprecation Announcement | [API Compatibility Policy](https://github.com/tektoncd/pipeline/tree/master/api_compatibility_policy.md) | Earliest Date of Removal | +| ------------------------ | ------------------------ | -------------------------------------------------------------------------------------------------------- | ------------------------ | +| [`tekton.dev/task` label on ClusterTasks](https://github.com/tektoncd/pipeline/issues/2533) | [v0.12.0](https://github.com/tektoncd/pipeline/releases/tag/v0.12.0) | Beta | January 30 2021 | +| [Step `$HOME` env var defaults to `/tekton/home`](https://github.com/tektoncd/pipeline/issues/2013) | [v0.11.0-rc1](https://github.com/tektoncd/pipeline/releases/tag/v0.11.0-rc1) | Beta | December 4 2020 | +| [Step `workingDir` defaults to `/workspace`](https://github.com/tektoncd/pipeline/issues/1836) | [v0.11.0-rc1](https://github.com/tektoncd/pipeline/releases/tag/v0.11.0-rc1) | Beta | December 4 2020 |