Add docs-build-push github workflow (#765)

* Add docs-build-push github workflow

* Remove slash from docs_source_path

Author: jackbhickey

.github/workflows/docs-build-push.yml

@@ -0,0 +1,36 @@
+name: Build and deploy (docs)
+on:
+  workflow_dispatch:
+    inputs:
+      environment:
+        description: 'Environment to deploy to'
+        required: false
+        default: 'preview'
+        type: choice
+        options:
+        - preview
+        - dev
+        - staging
+        - prod
+  pull_request:
+    branches:
+      - "*"
+    paths:
+      - site/**
+
+jobs:
+  call-docs-build-push:
+    uses: nginxinc/docs-actions/.github/workflows/docs-build-push.yml@03a9a3808fcb77cd0c19d7fa5d59b25565dd1d6d # v1.0.2
+    permissions:
+      pull-requests: write # needed to write preview url comment to PR
+      contents: read
+    with:
+      production_url_path: "/nginx-agent"
+      preview_url_path: "/previews/nginx-agent"
+      docs_source_path: "public/nginx-agent"
+      docs_build_path: "./site"
+      doc_type: "hugo"
+      environment: ${{inputs.environment}}
+    secrets:
+      AZURE_CREDENTIALS: ${{secrets.AZURE_CREDENTIALS_DOCS}}
+      AZURE_KEY_VAULT: ${{secrets.AZURE_KEY_VAULT_DOCS}}

site/README.md

@@ -2,7 +2,7 @@
 
 This directory contains all of the user documentation for NGINX Agent, as well as the requirements for linting, building, and publishing the documentation.
 
-Docs are written in Markdown. We build the docs using [Hugo](https://gohugo.io) and host them on [Netlify](https://www.netlify.com/).
+Docs are written in Markdown. We build the docs using [Hugo](https://gohugo.io). Previews and deployments are handled by the [docs-actions](https://github.com/nginxinc/docs-actions?tab=readme-ov-file#docs-actions) workflow.
 
 ## Setup