diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 0796240..b448271 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -24,12 +24,29 @@ jobs:
       run: luarocks install ldoc
     - name: Build docs
       run: |
+        echo "Current directory contents:"
+        ls -la
+        
+        echo "Creating output directory..."
         mkdir -p out
-        ldoc -c config.ld src
+        
+        echo "Running LDoc..."
+        ldoc -c $(pwd)/config.ld $(pwd)/src --verbose --ext md
+        
+        echo "Output directory contents:"
         ls -la out/
+        
+        # Fail if no files were generated
+        if [ -z "$(ls -A out/)" ]; then
+          echo "Error: No documentation files were generated!"
+          exit 1
+        fi
+
     - name: Deploy
       if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}
       uses: peaceiris/actions-gh-pages@v3
       with:
         github_token: ${{ secrets.GITHUB_TOKEN }}
-        publish_dir: ./out
\ No newline at end of file
+        publish_dir: ./out
+        force_orphan: true  # Start with a fresh branch each time
+        commit_message: "docs: update documentation [skip ci]"
\ No newline at end of file