Add AI4SDLC subsite via MkDocs submodule

risacher · risacher · commit 1f77603b2ef1 · 2026-04-13T05:38:50.000-04:00
diff --git a/.github/workflows/jekyll.yml b/.github/workflows/jekyll.yml
@@ -32,6 +32,8 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          submodules: recursive
       - name: Setup Ruby
         uses: ruby/setup-ruby@v1
         with:
@@ -67,6 +69,14 @@ jobs:
 
       - name: Run tests
         run: ./scripts/test
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Build AI4SDLC (MkDocs)
+        run: |
+          pip install mkdocs-material
+          mkdocs build -f ai4sdlc-mkdocs.yml --site-dir public/AI4SDLC
       - name: Upload artifact
         # Automatically uploads an artifact from the './_site' directory by default
         uses: actions/upload-pages-artifact@v3
diff --git a/.gitignore b/.gitignore
@@ -4,3 +4,4 @@
 public/
 tmp/
 .DS_Store
+.venv/
diff --git a/.gitmodules b/.gitmodules
@@ -0,0 +1,3 @@
+[submodule "AI4SDLC"]
+	path = AI4SDLC
+	url = https://github.com/Code-dot-mil/AI4SDLC
diff --git a/AI4SDLC b/AI4SDLC
@@ -0,0 +1 @@
+Subproject commit 94bb9340777e4ae19c04d811a387b95b859862b0
diff --git a/ai4sdlc-mkdocs.yml b/ai4sdlc-mkdocs.yml
@@ -0,0 +1,22 @@
+INHERIT: AI4SDLC/mkdocs.yml
+
+site_url: https://code.mil/AI4SDLC/
+docs_dir: AI4SDLC/docs
+
+theme:
+  name: material
+  custom_dir: AI4SDLC/docs/overrides
+  font:
+    text: Source Sans Pro
+  logo: images/DOW_CIO_Seal.png
+  favicon: images/DOW_CIO_Seal.png
+  include_homepage_in_sidebar: False
+  palette:
+    scheme: default
+    primary: blue
+    accent: pink
+  features:
+    - navigation.tabs
+    - navigation.instant
+    - search.suggest
+    - search.highlight
diff --git a/scripts/test b/scripts/test
@@ -2,5 +2,9 @@
 set -e # halt script on error
 
 bundle exec jekyll build
+mkdocs build -f ai4sdlc-mkdocs.yml --site-dir public/AI4SDLC --quiet
 # Government and some other sites block automated requests with 403; ignore them.
-bundle exec htmlproofer ./public --timeframe 6w --url-ignore "/^mailto:/,/code.gov\/about\/open-source\/introduction/,/code.gov\/about\/compliance\/inventory-code/,/twitter.com\/DefenseDigital/,/dodcio\.defense\.gov/,/www\.defense\.gov/"
+# code.mil self-references are canonical/sitemap links generated by MkDocs; ignore them too.
+bundle exec htmlproofer ./public --timeframe 6w \
+  --file-ignore "/\/AI4SDLC\//" \
+  --url-ignore "/^mailto:/,/code\.mil\//,/code.gov\/about\/open-source\/introduction/,/code.gov\/about\/compliance\/inventory-code/,/twitter.com\/DefenseDigital/,/dodcio\.defense\.gov/,/www\.defense\.gov/,/media\.defense\.gov/,/www\.esd\.whs\.mil/,/platform\.openai\.com/,/fonts\.gstatic\.com/"
diff --git a/src/_data/navigation.yml b/src/_data/navigation.yml
@@ -7,5 +7,7 @@ secondary: &secondary_navigation
     href: /how-to-open-source.html
   - text: FAQs
     href: /frequently-asked-questions.html
+  - text: AI4SDLC
+    href: /AI4SDLC/
 
 sidebar: *secondary_navigation
diff --git a/src/ai4sdlc.html b/src/ai4sdlc.html
@@ -0,0 +1,14 @@
+---
+layout: null
+permalink: /ai4sdlc/
+---
+<!DOCTYPE html>
+<html>
+<head>
+  <meta http-equiv="refresh" content="0; url=/AI4SDLC/">
+  <link rel="canonical" href="/AI4SDLC/">
+</head>
+<body>
+  <p>Redirecting to <a href="/AI4SDLC/">AI4SDLC</a>...</p>
+</body>
+</html>

-Original file line number
+Diff line change
 public/
 tmp/
 .DS_Store
 +.venv/
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+[submodule "AI4SDLC"]`
	`2`	`+ path = AI4SDLC`
	`3`	`+ url = https://github.com/Code-dot-mil/AI4SDLC`