diff --git a/.github/workflows/build_examples.yml b/.github/workflows/build_examples.yml
index 36c40e8..b3cbc94 100644
--- a/.github/workflows/build_examples.yml
+++ b/.github/workflows/build_examples.yml
@@ -16,12 +16,19 @@ jobs:
       - name: Install Manta from Source
         run: |
           pip install setuptools --upgrade
+
+          # omitting the following commmand causes the version of setuptools
+          # used by python to get confused, and it doesn't detect the name
+          # or version of the package from pyproject.toml - so the following
+          # workaround is used:
+          # https://github.com/pypa/setuptools/issues/3269#issuecomment-1254507377
           export DEB_PYTHON_INSTALL_LAYOUT=deb_system
+
           python3 -m pip install .
 
       - name: Generate Core
         run: manta gen examples/counter/manta.yaml examples/counter/src/debug.sv
-      
+
       - name: Build Verilog
         working-directory: examples/counter
         run: mkdir obj && python3 lab-bc.py