publish to clouddocs

Author: chen23

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

@@ -0,0 +1,36 @@
+name: Build the Docs
+on:
+  push:
+    branches:
+      - develop
+      - master
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    env:
+      S3_DIR: genai
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - run: ./containthedocs-build.sh
+
+    - name: Configure AWS credentials
+      uses: aws-actions/configure-aws-credentials@v4
+      with:
+        aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
+        aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+        aws-region: us-east-1
+
+    - name: Copy files to s3 (Staging Clouddocs)
+      if:
+        github.ref == 'refs/heads/develop'
+      run: |
+        aws s3 sync --delete $PWD/docs/_build/html/ s3://clouddocs.f5networks.net/training/community/$S3_DIR/html/
+
+    - name: Copy files to s3 (Production Clouddocs)
+      if:
+        github.ref == 'refs/heads/main'
+      run: |
+        aws s3 sync --delete $PWD/docs/_build/html/ s3://clouddocs.f5.com/training/community/$S3_DIR/html/
+        aws cloudfront create-invalidation --distribution-id ${{ secrets.AWS_DIST_ID }} --paths /training/community/$S3_DIR

.github/workflows/check-the-docs.yml

@@ -0,0 +1,51 @@
+name: Check the Docs
+on:
+  pull_request: {}
+  push:
+    branches:
+      - develop
+      - master
+  workflow_dispatch: {}
+
+jobs:
+  grammer:
+    name: Check Grammer
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+
+    - name: Log the node version
+      run: |
+        node -v
+    - name: Install write-good
+      run: |
+        npm install --no-fund --location=global write-good
+    - name: Run write-good to check grammer
+      run: |
+        write-good `find ./docs -name '*.rst'` --so
+
+  spelling:
+    name: Check Spelling
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v3
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.9'
+        cache: 'pip'
+    - name: Install dependencies
+      run: |
+        sudo apt update && sudo apt install -y enchant
+        pip install -r requirements.txt
+        pip install sphinxcontrib-spelling
+    - name: Run spell checker
+      run: |
+        sphinx-build -b spelling -d docs/_build docs/ docs/_build/spelling
+        if [[ -s "docs/_build/spelling/index.spelling" ]]; then cat "docs/_build/spelling/index.spelling"; fi
+    - name: Spelling errors fail the build
+      # fail the build in case of any misspelled words
+      run: |
+        if [[ -s "docs/_build/spelling/index.spelling" ]]; then cat "docs/_build/spelling/index.spelling"; fi
+        if [[ -s "docs/_build/spelling/index.spelling" ]]; then false; fi