dwavesystems · arcondello · Aug 13, 2026 · Aug 14, 2026 · Aug 14, 2026
diff --git a/.circleci/config.yml b/.circleci/config.yml
@@ -312,12 +312,6 @@ jobs:
       - attach_workspace:
           at: dist
 
-      - run:
-          name: install doxygen
-          command: |
-            sudo apt update
-            sudo apt install doxygen
-
       - run:
           name: install package and docs dependencies
           command: |
@@ -334,10 +328,10 @@ jobs:
               --only-binary :all:
 
       - run:
-          name: build docs
+          name: build docs with warnings as error
           command: |
             . env/bin/activate
-            make -C docs cpp html
+            make -C docs html SPHINXOPTS=-W
 
       - store_artifacts:
           path: docs/build/html

diff --git a/docs/Doxyfile b/docs/Doxyfile
diff --git a/docs/Makefile b/docs/Makefile
@@ -8,8 +8,6 @@ SPHINXPROJ    = dwave
 SOURCEDIR     = .
 BUILDDIR      = build
 
-DOXYGEN_OUTPUT_DIRECTORY=$(BUILDDIR)/doxygen/ 
-
 # Put it first so that "make" without argument is like "make help".
 help:
 	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
@@ -20,15 +18,6 @@ clean:
 	-rm -rf $(BUILDDIR)
 	-rm -rf reference/generated
 
-cpp:
-	# Note that sphinx's conf.py expects the build directory to be build/
-	# and unfortunately there isn't an easy way to read the BUILDDIR from the
-	# conf.py.
-	# We could do additional env variables, but this is mostly for the benefit
-	# of the SDK, so we'll leave it be for now.
-	mkdir $(BUILDDIR) -p
-	DOXYGEN_OUTPUT_DIRECTORY=$(DOXYGEN_OUTPUT_DIRECTORY) doxygen Doxyfile
-
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile

diff --git a/docs/conf.py b/docs/conf.py
@@ -3,9 +3,6 @@
 # For the full list of built-in configuration values, see the documentation:
 # https://www.sphinx-doc.org/en/master/usage/configuration.html
 
-import os
-import subprocess
-
 # -- Project information -----------------------------------------------------
 
 extensions = [
@@ -22,7 +19,6 @@
     'sphinx.ext.ifconfig',
 
     # other extensions
-    'breathe',
     'sphinx_design',
 ]
 
@@ -70,16 +66,6 @@
     'dwave.optimization.typing.ArraySymbolLike': 'ArraySymbol | numpy.typing.ArrayLike',
 }
 
-# -- Breathe --------------------------------------------------------------
-
-breathe_projects = {
-  'dwave-optimization': os.path.join(os.path.dirname(os.path.abspath(__file__)), 'build', 'doxygen', 'xml'),
-}
-
-# see https://breathe.readthedocs.io/en/latest/readthedocs.html
-if os.environ.get('READTHEDOCS', False):
-    subprocess.call('make cpp', shell=True, cwd=os.path.dirname(os.path.abspath(__file__)))
-
 # -- Options for HTML output ----------------------------------------------
 
 html_theme = "pydata_sphinx_theme"

diff --git a/docs/cpp.rst b/docs/cpp.rst
diff --git a/docs/philosophy.rst b/docs/philosophy.rst
@@ -5,7 +5,7 @@ Philosophy
 ==========
 
 `dwave-optimization` and
-the `Leap <https://cloud.dwavesys.com/leap/>`_\ |TM| service's quantum-classical
+the `Leap <https://cloud.dwavesys.com/leap/>`_\ ™ service's quantum-classical
 hybrid nonlinear solver
 incorporate features and design principles from each of the following areas:
 

diff --git a/pyproject.toml b/pyproject.toml
@@ -110,7 +110,6 @@ docs = [
     "pydata-sphinx-theme==0.16.1",
     "sphinx==8.2.3",
     "sphinx-design==0.6.1",
-    "breathe==4.35.0",
 ]
 
 [tool.cibuildwheel]