diff --git a/.drone.yml b/.drone.yml
index 15201e5..623114f 100644
--- a/.drone.yml
+++ b/.drone.yml
@@ -19,6 +19,7 @@ steps:
     commands:
       - mix_lock_hash=$(sha256sum mix.lock | cut -d ' ' -f 1)
       - echo "$DRONE_REPO_OWNER/$DRONE_REPO_NAME/$mix_lock_hash" >> .cache_key
+      # Print cache key for debugging
       - cat .cache_key
 
   - name: restore-cache
@@ -36,18 +37,27 @@ steps:
   - name: lint
     image: docker.io/library/elixir:1.18.3-otp-27
     commands:
+      # Install hex package manager
       - mix local.hex --force
+      # Fetch dependencies
       - mix deps.get
+      # Check for compilation errors & warnings
       - mix compile --warnings-as-errors
+      # Check formatting
       - mix format --check-formatted
+      # Security checks
       - mix sobelow --config
+      # Check dependencies for known vulnerabilities
       - mix deps.audit
+      # Check for dependencies that are not maintained anymore
       - mix hex.audit
+      # Provide hints for improving code quality
       - mix credo
 
   - name: wait_for_postgres
     image: docker.io/library/postgres:17.6
     commands:
+      # Wait for postgres to become available
       - |
         for i in {1..20}; do
           if pg_isready -h postgres -U postgres; then
@@ -67,8 +77,11 @@ steps:
       TEST_POSTGRES_HOST: postgres
       TEST_POSTGRES_PORT: 5432
     commands:
+      # Install hex package manager
       - mix local.hex --force
+      # Fetch dependencies
       - mix deps.get
+      # Run tests
       - mix test
 
   - name: rebuild-cache