diff --git a/.github/workflows/abuseipdb-blocklist-download.yml b/.github/workflows/db-blocklist-download.yml
similarity index 73%
rename from .github/workflows/abuseipdb-blocklist-download.yml
rename to .github/workflows/db-blocklist-download.yml
index 3a8224c95..0fa2adf2c 100644
--- a/.github/workflows/abuseipdb-blocklist-download.yml
+++ b/.github/workflows/db-blocklist-download.yml
@@ -1,8 +1,20 @@
 # #
+#   @usage              https://github.com/Aetherinox/csf-firewall
 #   @type               github workflow
-#   @desc               download AbuseIPDB ip list
-#   @author             Aetherinox
-#   @url                https://github.com/Aetherinox
+#   
+#   used in combination with .github/scripts/db-blocklist-download.sh
+#
+#   download AbuseIPDB ip list after list of ips are downloaded, merges them with a static list
+#   that is not updated as often which contains a list of long-term abusive ip addresses
+#   
+#   local test requires the same structure as the github workflow
+#       📁 .github
+#           📁 blocks
+#               📄 1.txt
+#           📁 scripts
+#               📄 db-blocklist-download.sh
+#           📁 workflows
+#               📄 db-blocklist-download.yml
 # #
 
 name: "🧱 Blocklist › Generate"
@@ -75,8 +87,8 @@ jobs:
               run: |
                 # set permissions and run
                 echo ${GITHUB_WORKSPACE}
-                chmod +x ".github/scripts/abuseipdb-blocklist-download.sh"
-                command=".github/scripts/abuseipdb-blocklist-download.sh ${{ secrets.BLOCKLIST_URL1 }} ${{ secrets.BLOCKLIST_FILE }}"
+                chmod +x ".github/scripts/db-blocklist-download.sh"
+                command=".github/scripts/db-blocklist-download.sh ${{ secrets.BLOCKLIST_URL1 }} ${{ secrets.BLOCKLIST_FILE }}"
                 eval "./$command"
 
                 # cat csf.deny