diff --git a/docs/operations/ci/upgrades/upgrade-jenkins.md b/docs/operations/ci/upgrades/upgrade-jenkins.md
new file mode 100644
index 0000000..ca64e0c
--- /dev/null
+++ b/docs/operations/ci/upgrades/upgrade-jenkins.md
@@ -0,0 +1,14 @@
+# Upgrading Jenkins in CI
+
+## 'legacy' setup for ci.centos.org
+
+We follow the Jenkins LTS branch for the version we run, and we so have to update jenkins itself, or some plugins, when some CVEs, security fixes are announced, and also to comply with some other internal rules for CI/CD platform.
+
+The process is easy for that part:
+
+ * announce the maintenance window to the ci-users list
+ * proceed with the `adhoc-upgrade-jenkins.yml` playbook
+ * verify that jenkins is back online and agents (re)connected
+ * announce on the ci-users list that maintenance is complete
+
+## Openshift setup
diff --git a/mkdocs.yml b/mkdocs.yml
index 07a15b7..f57daaa 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -47,7 +47,9 @@ nav:
          - Onboarding sysadmins: operations/ci/onboarding_sysadmin.md
          - Outage Preparation: operations/ci/outage_preparation.md
          - Replacing Certs: operations/ci/replacing_certs.md
-         - Upgrades: operations/ci/upgrades/upgrade-notification-template.md
+         - Upgrades: 
+           - operations/ci/upgrades/upgrade-notification-template.md
+           - operations/ci/upgrades/upgrade-jenkins.md
 
        - Spikes:
          - Configure default permissions for ACO users: operations/ci/configuring_default_aco_user_permissions.md