chore: Use tf plugin docs

Signed-off-by: Steve Hipwell <[email protected]>

Author: stevehipwell

.github/pull_request_template.md

@@ -7,12 +7,12 @@ Resolves #ISSUE_NUMBER
 ### Before the change?
 <!-- Please describe the current behavior that you are modifying. -->
 
-- 
+-
 
 ### After the change?
 <!-- Please describe the behavior or changes that are being added by this PR. -->
 
-- 
+-
 
 ### Pull request checklist
 

.github/workflows/ci.yaml

@@ -36,3 +36,53 @@ jobs:
       - run: make tools
       - run: make build
       - run: make test
+
+  docs:
+    name: Documentation
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    defaults:
+      run:
+        shell: bash
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - name: Set-up Go
+        uses: actions/setup-go@7a3fe6cf4cb3a834922a1244abfce67bcef6a0c5 # v6.2.0
+        with:
+          go-version-file: go.mod
+          cache: true
+      - name: Set-up Terraform
+        uses: hashicorp/setup-terraform@5e8dbf3c6d9deaf4193ca7a8fb23f2ac83bb6c85 # v4.0.0
+        with:
+          terraform_version: latest
+          terraform_wrapper: false
+      - run: make checkdocs
+      - run: make lintdocs RUMDL_ARGS="--output-format github"
+      - uses: rvben/rumdl@f3ca9f4962234c3d2b73ac2ce15c0b6ca654d510 # v0.1.84
+        with:
+          path: ./docs
+          report-type: annotations
+
+  check:
+    name: Check
+    needs:
+      - ci
+      - docs
+    if: always()
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        shell: bash
+    steps:
+      - name: Check
+        run: |
+          set -euo pipefail
+          results=( ${{ join(needs.*.result, ' ') }} )
+          for result in "${results[@]}"; do
+            if [[ "${result}" == "failure" ]] || [[ "${result}" == "cancelled" ]]; then
+              echo "::error::Workflow failed!"
+              exit 1
+            fi
+          done

.markdownlint.yaml

@@ -0,0 +1,18 @@
+[global]
+disable = ["MD013", "MD028"]
+
+[per-file-ignores]
+".github/pull_request_template.md" = ["MD041"]
+"docs/**/*.md" = ["MD059"]
+
+[MD004]
+style = "dash"
+
+[MD024]
+siblings-only = true
+
+[MD033]
+allowed-elements = ["a", "br", "details", "img", "summary", "sub", "sup"]
+
+[MD052]
+shortcut-syntax = true