diff --git a/.backup-git-pre-push-hook b/.backup-git-pre-push-hook
index 835f24f..36881a5 100755
--- a/.backup-git-pre-push-hook
+++ b/.backup-git-pre-push-hook
@@ -6,6 +6,11 @@ if ! [ -f ~/.cloudflarerc ] ; then
 fi
 
 . ~/.cloudflarerc
+# this file contains only two lines in which we declare
+# $apikey and $id
+# like
+# apikey=J9pq1v...
+# id=16e255e...
 
 echo -n "Clearing cloudflare cache..."
 
diff --git a/.git-post-receive-hook b/.git-post-receive-hook
index 90982a6..75d6ead 100644
--- a/.git-post-receive-hook
+++ b/.git-post-receive-hook
@@ -1,4 +1,7 @@
 #!/usr/bin/env bash
+# this file was used on my server when I selfhosted my personal
+# Gitea instance. I've put this as post-receive-hook on the
+# servers local Gitea repository.
 
 GIT_REPO=/var/lib/gitea/data/gitea-repositories/dominic/oe7drt-website.git
 WORKING_DIR=${HOME}/oe7drt-website-working