Add docs generation and deploy workflow

Introduced a new workflow for generating and deploying API documentation to GitHub Pages. Integrated Postgres service setup in the build job to ensure the database is available for testing. This streamlines documentation deployment and enhances build reliability by ensuring dependencies are correctly configured.

.github/workflows/crystal.yml

@@ -7,22 +7,55 @@ on:
     branches: [master]
 
 jobs:
+  docs:
+    runs-on: ubuntu-latest
+    container:
+      image: crystallang/crystal
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Generate Azu API Docs
+        run: crystal docs
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: "./docs"
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
   build:
     runs-on: ubuntu-latest
     container:
       image: crystallang/crystal
+    services:
+      postgres:
+        image: postgres
+        env:
+          POSTGRES_PASSWORD: example
+          POSTGRES_USER: example
+          POSTGRES_DB: example
+        # Set health checks to wait until postgres has started
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          # Maps tcp port 5432 on service container to the host
+          - 5432:5432
     steps:
       - uses: actions/checkout@v2
-
       - name: Install dependencies
         run: shards install
-
       - name: Build binary to test
         run: shards build example_app
-
-      - name: Check code style
+      - name: Check code styl2e
         run: crystal tool format --check
-
       - name: Run tests
         run: crystal spec
         env:
@@ -33,8 +66,6 @@ jobs:
           PORT_REUSE: false
           HOST: 0.0.0.0
 
-      - name: Generate Azu API Docs
-        run: crystal docs
   release:
     runs-on: ubuntu-latest
     needs: