diff --git a/doc/Releasing.md b/doc/Releasing.md
index e3aa755..7b8bf3c 100644
--- a/doc/Releasing.md
+++ b/doc/Releasing.md
@@ -1,14 +1,43 @@
-# stable release (should be done from master)
+# Release process
 
+## ... for testing (snapshots)
+
+Make sure your clojars.org credentials are correctly set in your ~/.lein/profiles.clj file.
+
+``` bash
+git add .
+git commit
 ```
-#adjust [version]
-vi package.json
 
+``` bash
+lein deploy # or lein deploy clojars
+```
+
+## ... for stable release
+
+Make sure tags are protected in gitlab:
+Repository Settings -> Protected Tags -> set \*.\*.\* as tag and save.
+
+``` bash
+git checkout main # for old projects replace main with master
+git add .
+git commit 
+```
+
+Open package.json, find ":version" keyword and remove "-SNAPSHOT" from version number.
+
+``` bash
+git add .
+git commit -m "Release [version]"
 lein release
 git push --follow-tags
+```
 
-# bump version - increase version and add -SNAPSHOT
-vi package.json
+Open package.json again, increase version increment by one and add "-SNAPSHOT".
+
+``` bash
 git commit -am "version bump"
 git push
-```
\ No newline at end of file
+```
+
+Done.
diff --git a/doc/Upgrading.md b/doc/Upgrading.md
new file mode 100644
index 0000000..7483c6e
--- /dev/null
+++ b/doc/Upgrading.md
@@ -0,0 +1,22 @@
+# Release process
+
+## adhoc (on kubernetes cluster)
+
+Make sure you've got your gitea admin credentials.
+
+``` bash
+kubectl edit deployments [website-pod-deployment-name]
+# search for your current gitea version, e.g. 1.17.0
+# replace with new version
+# save and exit
+kubectl scale deployment meissa-io-deployment --replicas=0
+kubectl scale deployment meissa-io-deployment --replicas=1
+```
+
+Visit your gitea url.  
+The inital installation screen should be visible.  
+Enter your admin credentials.
+
+You now should be logged into the admin account with all repos visible.
+
+You may want to update your c4k-gitea resources to reflect the changes made on the cluster.