Merge branch 'main' into feat-publish-coprocessor-metrics

Author: samfreund

Diff for: .github/workflows/cut-new-tag.yml

@@ -30,7 +30,7 @@ jobs:
         with:
           python-version: 3.11
       - name: Install wpiformat
-        run: pip3 install wpiformat==2024.45
+        run: pip3 install wpiformat==2025.32
       - name: Run
         run: wpiformat
       - name: Check output

Diff for: .github/workflows/lint-format.yml

@@ -1,4 +1,4 @@
-name: Photon Code Documentation
+name: Photon API Documentation
 
 on:
   # Run on pushes to main and pushed tags, and on pull requests against main, but ignore the docs folder
@@ -21,8 +21,8 @@ permissions:
   id-token: write
 
 jobs:
-  build-client:
-    name: "PhotonClient Build"
+  build_demo:
+    name: Build PhotonClient Demo
     defaults:
       run:
         working-directory: photon-client
@@ -39,10 +39,11 @@ jobs:
         run: npm run build-demo
       - uses: actions/upload-artifact@v4
         with:
-          name: built-client
+          name: built-demo
           path: photon-client/dist/
 
-  run_docs:
+  run_api_docs:
+    name: Build API Docs
     runs-on: "ubuntu-22.04"
     steps:
     - name: Checkout code
@@ -56,34 +57,56 @@ jobs:
       with:
         java-version: 17
         distribution: temurin
-
     - name: Build javadocs/doxygen
       run: |
         chmod +x gradlew
         ./gradlew photon-docs:generateJavaDocs photon-docs:doxygen
-
     - uses: actions/upload-artifact@v4
       with:
         name: built-docs
         path: photon-docs/build/docs
 
-  release:
-    needs: [build-client, run_docs]
-
+  publish_api_docs:
+    name: Publish API Docs
+    needs: [run_api_docs]
     runs-on: ubuntu-22.04
     steps:
-
-      # Download literally every single artifact.
+      # Download docs artifact
       - uses: actions/download-artifact@v4
-
+        with:
+          name: built-docs
       - run: find .
-      - name: copy file via ssh password
+      - name: Publish Docs To Development
         if: github.ref == 'refs/heads/main'
-        uses: appleboy/[email protected]
+        uses: up9cloud/[email protected]
+        env:
+          HOST: ${{ secrets.WEBMASTER_SSH_HOST }}
+          USER: ${{ secrets.WEBMASTER_SSH_USERNAME }}
+          KEY: ${{secrets.WEBMASTER_SSH_KEY}}
+          TARGET: /var/www/html/photonvision-docs/development
+      - name: Publish Docs To Release
+        if: startsWith(github.ref, 'refs/tags/v')
+        uses: up9cloud/[email protected]
+        env:
+          HOST: ${{ secrets.WEBMASTER_SSH_HOST }}
+          USER: ${{ secrets.WEBMASTER_SSH_USERNAME }}
+          KEY: ${{ secrets.WEBMASTER_SSH_KEY }}
+          TARGET: /var/www/html/photonvision-docs/release/
+
+  publish_demo:
+      name: Publish PhotonClient Demo
+      needs: [build_demo]
+      runs-on: ubuntu-22.04
+      steps:
+      - uses: actions/download-artifact@v4
         with:
-          host: ${{ secrets.WEBMASTER_SSH_HOST }}
-          username: ${{ secrets.WEBMASTER_SSH_USERNAME }}
-          password: ${{ secrets.WEBMASTER_SSH_KEY }}
-          port: ${{ secrets.WEBMASTER_SSH_PORT }}
-          source: "*"
-          target: /var/www/html/photonvision-docs/
+          name: built-demo
+      - run: find .
+      - name: Publish demo
+        if: github.ref == 'refs/heads/main'
+        uses: up9cloud/[email protected]
+        env:
+          HOST: ${{ secrets.WEBMASTER_SSH_HOST }}
+          USER: ${{ secrets.WEBMASTER_SSH_USERNAME }}
+          KEY: ${{ secrets.WEBMASTER_SSH_KEY }}
+          TARGET: /var/www/html/photonvision-demo

Diff for: .github/workflows/photon-code-docs.yml renamed to .github/workflows/photon-api-docs.yml

@@ -1,4 +1,4 @@
-name: PhotonVision Sphinx Documentation Checks
+name: PhotonVision ReadTheDocs Checks
 
 on:
   push:
@@ -16,6 +16,7 @@ env:
 
 jobs:
   build:
+    name: Build and Check Docs
     runs-on: ubuntu-22.04
 
     steps:

Diff for: .github/workflows/photonvision-docs.yml renamed to .github/workflows/photonvision-rtd.yml

@@ -0,0 +1,48 @@
+name: Website
+
+on:
+  push:
+    # For now, run on all commits to main
+    branches: [ main ]
+    tags:
+      - 'v*'
+  pull_request:
+    branches: [ main ]
+  merge_group:
+
+jobs:
+  rsync:
+    name: Build and Sync Files
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup Node
+        uses: actions/setup-node@v4
+      - name: Install packages
+        run: npm ci
+        working-directory: website
+      - name: Build project
+        run: npm run build
+        working-directory: website
+      - uses: up9cloud/[email protected]
+        if: github.ref == 'refs/heads/main'
+        env:
+          HOST: ${{ secrets.WEBMASTER_SSH_HOST }}
+          USER: ${{ secrets.WEBMASTER_SSH_USERNAME }}
+          KEY: ${{secrets.WEBMASTER_SSH_KEY}}
+          SOURCE: website/dist/*
+          TARGET: /var/www/html/photonvision-website
+
+  format-check:
+    name: Check Formatting
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup Node
+        uses: actions/setup-node@v4
+      - name: Install Packages
+        run: npm ci
+        working-directory: website
+      - name: Run Formatting Check
+        run: npx prettier -c .
+        working-directory: website

Diff for: .github/workflows/website.yml

@@ -150,3 +150,7 @@ photon-server/src/main/resources/web/*
 venv
 .venv/*
 .venv
+networktables.json
+
+website/node_modules
+website/dist

Diff for: .gitignore

@@ -19,6 +19,9 @@ modifiableFileExclude {
   \.webp$
   \.ico$
   \.rknn$
+  \.mp4$
+  \.ttf$
+  \.woff2$
   gradlew
   photon-lib/py/photonlibpy/generated/
   photon-targeting/src/main/native/cpp/photon/constrained_solvepnp/generate/

Diff for: .styleguide

@@ -4,7 +4,7 @@ plugins {
     id "cpp"
     id "com.diffplug.spotless" version "6.24.0"
     id "edu.wpi.first.wpilib.repositories.WPILibRepositoriesPlugin" version "2020.2"
-    id "edu.wpi.first.GradleRIO" version "2025.3.1"
+    id "edu.wpi.first.GradleRIO" version "2025.3.2"
     id 'edu.wpi.first.WpilibTools' version '1.3.0'
     id 'com.google.protobuf' version '0.9.3' apply false
     id 'edu.wpi.first.GradleJni' version '1.1.0'
@@ -33,7 +33,7 @@ ext.allOutputsFolder = file("$project.buildDir/outputs")
 apply from: "versioningHelper.gradle"
 
 ext {
-    wpilibVersion = "2025.3.1"
+    wpilibVersion = "2025.3.2"
     wpimathVersion = wpilibVersion
     openCVYear = "2025"
     openCVversion = "4.10.0-3"

Diff for: README.md

@@ -1,44 +1,59 @@
-alabaster==0.7.13
-Babel==2.13.1
-beautifulsoup4==4.12.2
-certifi==2023.11.17
-charset-normalizer==3.3.2
+alabaster==1.0.0
+anyio==4.9.0
+babel==2.17.0
+beautifulsoup4==4.13.3
+certifi==2025.1.31
+charset-normalizer==3.4.1
+click==8.1.8
 colorama==0.4.6
-doc8==0.11.2
+doc8==1.1.2
 docopt==0.6.2
-docutils==0.18.1
-furo==2023.9.10
-idna==3.4
+docutils==0.21.2
+furo==2024.8.6
+h11==0.14.0
+idna==3.10
 imagesize==1.4.1
-Jinja2==3.0.3
-MarkupSafe==2.1.3
-packaging==23.2
-pbr==6.0.0
+Jinja2==3.1.6
+markdown-it-py==3.0.0
+MarkupSafe==3.0.2
+mdit-py-plugins==0.4.2
+mdurl==0.1.2
+myst-parser==4.0.1
+packaging==24.2
+pbr==6.1.1
 pipreqs==0.4.13
-Pygments==2.17.1
-requests==2.31.0
-restructuredtext-lint==1.4.0
-six==1.16.0
+Pygments==2.19.1
+PyYAML==6.0.2
+requests==2.32.3
+restructuredtext_lint==1.4.0
+roman-numerals-py==3.1.0
+setuptools==77.0.3
+six==1.17.0
+sniffio==1.3.1
 snowballstemmer==2.2.0
-soupsieve==2.5
-Sphinx==7.2.6
+soupsieve==2.6
+Sphinx==8.2.3
+sphinx-autobuild==2024.10.3
 sphinx-basic-ng==1.0.0b2
-sphinx-notfound-page==1.0.0
-sphinx-rtd-theme==1.3.0
-sphinx-tabs==3.4.4
-sphinx_design==0.5.0
-sphinxcontrib-applehelp==1.0.7
-sphinxcontrib-devhelp==1.0.5
+sphinx-notfound-page==1.1.0
+sphinx-rtd-theme==3.0.2
+sphinx-tabs==3.4.7
+sphinx_design==0.6.1
+sphinxcontrib-applehelp==2.0.0
+sphinxcontrib-devhelp==2.0.0
 sphinxcontrib-ghcontributors==0.2.3
-sphinxcontrib-htmlhelp==2.0.4
+sphinxcontrib-htmlhelp==2.1.0
 sphinxcontrib-jquery==4.1
 sphinxcontrib-jsmath==1.0.1
-sphinxcontrib-qthelp==1.0.6
-sphinxcontrib-serializinghtml==1.1.9
-sphinxext-opengraph==0.9.0
-sphinxext-remoteliteralinclude==0.4.0
-stevedore==5.1.0
-urllib3==2.1.0
-yarg==0.1.9
-sphinx-autobuild==2024.4.16
-myst_parser==3.0.1
+sphinxcontrib-qthelp==2.0.0
+sphinxcontrib-serializinghtml==2.0.0
+sphinxext-opengraph==0.9.1
+sphinxext-remoteliteralinclude==0.5.0
+starlette==0.46.1
+stevedore==5.4.1
+typing_extensions==4.12.2
+urllib3==2.3.0
+uvicorn==0.34.0
+watchfiles==1.0.4
+websockets==15.0.1
+yarg==0.1.10

Diff for: build.gradle

@@ -87,6 +87,9 @@ def setup(app):
 
 html_theme_options = {
     "sidebar_hide_name": True,
+    "top_of_page_buttons": ["view", "edit"],
+    "source_edit_link": "https://github.com/PhotonVision/photonvision/edit/main/docs/source/{filename}",
+    "source_view_link": "https://github.com/PhotonVision/photonvision/blob/main/docs/source/{filename}",
     "light_logo": "assets/PhotonVision-Header-onWhite.png",
     "dark_logo": "assets/PhotonVision-Header-noBG.png",
     "light_css_variables": {