From 6f46b65da8d19a59c3c565d6e2918d64a0b62e3c Mon Sep 17 00:00:00 2001
From: hshah-mitre <hshah@mitre.org>
Date: Mon, 29 Dec 2025 11:34:54 -0500
Subject: [PATCH 1/3] Add MkDocs conversion job to deploy workflow

Added a new job to convert Markdown files to HTML using MkDocs in the GitHub Actions workflow.
---
 .github/workflows/deploy.yml | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
index 62ba382..62164c9 100644
--- a/.github/workflows/deploy.yml
+++ b/.github/workflows/deploy.yml
@@ -109,6 +109,31 @@ jobs:
             -d "{\"team_reviewers\":[\"ai4sdlc-approval\"]}" \
             https://api.github.com/repos/${{ github.repository }}/pulls/$PR_NUMBER/requested_reviewers -v
 
+
+###
+  # Build stage - converting md file to html using MkDocs
+  convert_md_to_html_gh :
+    runs-on: ubuntu-latest
+    if: github.ref != 'refs/heads/main' # Run for non-main branches
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3.9
+
+      - name: Install MkDocs and dependencies
+        run: |
+          pip install mkdocs mkdocs-material
+
+      - name: Build project with MkDocs
+        run: |
+          echo "Building your project..."
+          mkdocs build
+          echo "pwd in build project with MKDocs"
+###
             
   # Build stage - converting md file to html using MkDocs
   convert_md_to_html:

From 533553dd38311809b41d17e402138c10ecebbfe4 Mon Sep 17 00:00:00 2001
From: hshah-mitre <hshah@mitre.org>
Date: Mon, 29 Dec 2025 11:41:32 -0500
Subject: [PATCH 2/3] Update deploy.yml

---
 .github/workflows/deploy.yml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
index 62164c9..4385a2d 100644
--- a/.github/workflows/deploy.yml
+++ b/.github/workflows/deploy.yml
@@ -133,6 +133,14 @@ jobs:
           echo "Building your project..."
           mkdocs build
           echo "pwd in build project with MKDocs"
+      - name: Add .nojekyll
+        run: touch site/.nojekyll
+
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./site   
 ###
             
   # Build stage - converting md file to html using MkDocs

From 4442a1bec25b3f2bf4f251efb78c83058e811135 Mon Sep 17 00:00:00 2001
From: hshah-mitre <hshah@mitre.org>
Date: Mon, 29 Dec 2025 11:45:42 -0500
Subject: [PATCH 3/3] Change permissions from read to write for contents

---
 .github/workflows/deploy.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
index 4385a2d..5d448f1 100644
--- a/.github/workflows/deploy.yml
+++ b/.github/workflows/deploy.yml
@@ -14,7 +14,7 @@ on:
     
 
 permissions:
-  contents: read # This is required for actions/checkout
+  contents: write # This is required for actions/checkout
   pull-requests: write
   id-token: write # This is required requesting the JWT