diff --git a/README.md b/README.md
index bdbf3d51a0984a50434f7174460f2ded5a58fc18..d9701117c1c132a93518ae968d182b8b87bf1e86 100644
--- a/README.md
+++ b/README.md
@@ -5,3 +5,15 @@ The [Auto-DevOps](https://docs.gitlab.com/ee/topics/autodevops/) [deploy stage](
 ## Contributing and Code of Conduct
 
 Please see [CONTRIBUTING.md](CONTRIBUTING.md)
+
+## Upgrading
+
+### v0.1.0
+
+Starting from GitLab 12.2, the [`Jobs/Deploy.gitlab-ci.yml`](https://gitlab.com/gitlab-org/gitlab-ce/blob/master/lib/gitlab/ci/templates/Jobs/Deploy.gitlab-ci.yml)
+template will use the Docker image generated from this project. Changes from previous version of `Jobs/Deploy.gitlab-ci.yml` include:
+
+* Switch from using `sh` to `bash`.
+* `install_dependencies` is removed as it is now part of the Docker image.
+*  All the other commands should be prepended with `auto-deploy`.
+   For example, `check_kube_domain` now becomes `auto-deploy check_kube_domain`.
\ No newline at end of file