ci: generate docs for site and use in build

Signed-off-by: Ruby Iris Juric <[email protected]>

Author: Sorixelle

.github/workflows/build.yml

@@ -1,17 +1,116 @@
 name: Build static site
 
 on:
+  workflow_dispatch:
   push:
     branches: [main]
 
 jobs:
+  # TODO: build these docs in pebble-dev/pebble-firmware, and publish in releases
+  gendocs-c:
+    runs-on: ubuntu-24.04
+    container:
+      image: ghcr.io/pebble-dev/pebbleos-docker:v1
+
+    steps:
+      - name: Checkout pebble-firmware
+        uses: actions/checkout@v4
+        with:
+          # TODO: use pebble-dev when https://github.com/pebble-dev/pebble-firmware/pull/256 merged
+          repository: Sorixelle/pebble-firmware
+          ref: fix-sdk-docs-build
+          submodules: true
+
+      - name: Install Python dependencies
+        run: |
+          pip install -U pip
+          pip install -r requirements.txt
+
+      - name: Build aplite SDK
+        run: |
+          ./waf configure --board bb2 --nojs
+          ./waf build --onlysdk
+
+      - name: Build basalt SDK
+        run: |
+          ./waf configure --board snowy_bb2
+          ./waf build --onlysdk
+
+      - name: Generate SDK documentation
+        run: |
+          ./waf docs_sdk
+          cd build/sdk
+          zip -r PebbleSDK-4.3_docs.zip {aplite,basalt}/doxygen_sdk
+
+      - name: Publish docs artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: docs-c
+          path: build/sdk/PebbleSDK-4.3_docs.zip
+
+  # TODO: maybe build in pebble-dev/pebble-android-sdk, and publish releases?
+  gendocs-android:
+    runs-on: ubuntu-24.04
+
+    steps:
+      - name: Checkout pebble-android-sdk
+        uses: actions/checkout@v4
+        with:
+          # TODO: use pebble-dev when https://github.com/pebble-dev/pebble-android-sdk/pull/1 merged
+          repository: Sorixelle/pebble-android-sdk
+          ref: javadocs
+
+      - name: Generate documentation
+        working-directory: PebbleKit
+        run: |
+          ./gradlew releaseJavadoc
+          cd PebbleKit/build/docs
+          zip -r pebblekit_android_4.0.1.zip javadoc
+
+      - name: Publish docs artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: docs-android
+          path: PebbleKit/PebbleKit/build/docs/pebblekit_android_4.0.1.zip
+
+  # TODO: maybe fork into pebble-dev, build there, and publish releases?
+  gendocs-ios:
+    runs-on: ubuntu-24.04
+
+    steps:
+      - name: Checkout pebble-ios-sdk
+        uses: actions/checkout@v4
+        with:
+          repository: pebble/pebble-ios-sdk
+
+      - name: Generate documentation
+        working-directory: PebbleKit-iOS.docset/Contents/Resources/Documents
+        run: |
+          zip -r pebblekit_ios_4.0.0.zip *
+
+      - name: Publish docs artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: docs-ios
+          path: PebbleKit-iOS.docset/Contents/Resources/Documents/pebblekit_ios_4.0.0.zip
+
   build:
     runs-on: ubuntu-24.04
+    needs:
+      - gendocs-c
+      - gendocs-android
+      - gendocs-ios
 
     steps:
       - name: Checkout
         uses: actions/checkout@v4
 
+      - name: Download docs artifacts
+        uses: actions/download-artifact@v4
+        with:
+          pattern: docs-*
+          path: /tmp/docs
+
       - name: Setup Ruby
         uses: ruby/setup-ruby@v1
         with:
@@ -20,10 +119,10 @@ jobs:
       - name: Build site
         run: bundle exec jekyll build
         env:
-          URL: http://developer.rebble.io
+          URL: https://developer.rebble.io
           HTTPS_URL: https://developer.rebble.io
           JEKYLL_ENV: production
-          SKIP_DOCS: true # TODO: setup docs generation
+          DOCS_URL: /tmp/docs
 
       - name: Upload artifact
         uses: actions/upload-artifact@v4