@@ -9,7 +9,7 @@ on:
     inputs:
       su2_ref:
         description: SU2 commit SHA or branch
-        default: docs/developer-guides
+        default: develop
 
 permissions:
   contents: read
@@ -29,11 +29,11 @@ jobs:
           fetch-depth: 0
           filter: blob:none
           persist-credentials: false
-      - name: Checkout SU2 documentation tools
+      - name: Checkout SU2 source
         uses: actions/checkout@v4
         with:
-          repository: rois1995/SU2
-          ref: ${{ inputs.su2_ref || 'docs/developer-guides' }}
+          repository: su2code/SU2
+          ref: ${{ inputs.su2_ref || 'develop' }}
           path: su2
           fetch-depth: 0
           filter: blob:none
@@ -57,9 +57,9 @@ jobs:
         run: sudo apt-get update && sudo apt-get install -y doxygen graphviz
       - name: Build and check website
         env:
-          GITHUB_REPOSITORY: rois1995/SU2
+          GITHUB_REPOSITORY: su2code/SU2
           BUNDLE_PATH: ${{ github.workspace }}/site/vendor/bundle
-        run: python3 su2/Docs/website/tools/build_docs.py --su2 su2 --site site --build-dir "$RUNNER_TEMP/docs-site" --baseurl /SU2 --mark-changes
+        run: python3 site/developer-docs/tools/build_docs.py --su2 su2 --site site --build-dir "$RUNNER_TEMP/docs-site" --baseurl /SU2 --mark-changes
       - name: Upload checked preview
         uses: actions/upload-artifact@v4
         with:
 
@@ -0,0 +1,17 @@
+# Developer documentation
+
+The developer guides and website tools live in this repository. The generator reads an SU2 checkout to produce configuration, output, error and migration references and copies selected notes from the source tree. It stages the site without changing either checkout.
+
+To build locally, install Python 3.8+, Git, Ruby and Bundler versions specified by the website, Doxygen and Graphviz, and install the locked gems. From the website root, run:
+
+```sh
+python3 developer-docs/tools/build_docs.py --su2 /path/to/SU2 --site . --build-dir /path/to/empty-build --baseurl /SU2
+```
+
+The build directory must be separate from both source trees. The build runs the Python tests, generates the references and Doxygen, builds Jekyll and checks the result. To run the Python tests alone:
+
+```sh
+SU2_SOURCE=/path/to/SU2 python3 -m unittest discover -s developer-docs/tools
+```
+
+Edit the guides in `developer-docs/pages`; generated pages are built from SU2 and should not be edited directly. The documentation checks workflow builds a preview with SU2 develop and records the revisions used. External links and numerical convergence are not checked.