ci: add docs generation into the release github action (#75)

Author: ns-vasilev

.github/workflows/docs.yml

@@ -67,7 +67,15 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           echo "RELEASE_NOTES<<EOF" >> "$GITHUB_OUTPUT"
-          git cliff --config ./cliff.toml --latest >> "$GITHUB_OUTPUT"
+
+          echo "All notable changes to this project will be documented in this file." >> "$GITHUB_OUTPUT"
+          echo "" >> "$GITHUB_OUTPUT"
+          echo "The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)," >> "$GITHUB_OUTPUT"
+          echo "and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html)." >> "$GITHUB_OUTPUT"
+          echo "" >> "$GITHUB_OUTPUT"
+
+          git cliff --config ./cliff.toml --latest --strip header | awk 'NF{p=1} p' | tail -n +2 >> "$GITHUB_OUTPUT"
+
           echo "EOF" >> "$GITHUB_OUTPUT"
       - name: Commit changes
         id: auto-commit-action
@@ -87,4 +95,39 @@ jobs:
           name: ${{ steps.next-version.outputs.NEXT_VERSION }}
           tag_name: ${{ steps.next-version.outputs.NEXT_VERSION }}
           body: ${{ steps.release-notes.outputs.RELEASE_NOTES }}
-          target_commitish: ${{ steps.auto-commit-action.outputs.commit_hash }}
+          target_commitish: ${{ steps.auto-commit-action.outputs.commit_hash }}
+      - name: Build DocC
+        id: build
+        uses: space-code/build-docc@main
+        if: steps.check-changes.outputs.has-changes == 'true'
+        with:
+          schemes: '["ValidatorCore", "ValidatorUI"]'
+          version: ${{ steps.next-version.outputs.NEXT_VERSION }}
+      - name: Generate Index Page
+        uses: space-code/generate-index@v1.0.0
+        if: steps.check-changes.outputs.has-changes == 'true'
+        with:
+          version: ${{ steps.next-version.outputs.NEXT_VERSION }}
+          project-name: 'Validator'
+          project-description: 'Validator is a modern, lightweight Swift framework that provides elegant and type-safe input validation.'
+          modules: |
+            [
+              {
+                "name": "ValidatorCore",
+                "path": "validatorcore",
+                "description": "Core validation functionality and rules for Swift applications. Contains base types, protocols, and validator implementations.",
+                "badge": "Core Module"
+              },
+              {
+                "name": "ValidatorUI",
+                "path": "validatorui",
+                "description": "UI components and helpers for building validation interfaces. Ready-to-use solutions for SwiftUI and UIKit.",
+                "badge": "UI Module"
+              }
+            ]
+      - name: Deploy
+        uses: peaceiris/actions-gh-pages@v4
+        if: steps.check-changes.outputs.has-changes == 'true'
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./docs