From e98320a7f28be58d73224a049f689f354cf6d040 Mon Sep 17 00:00:00 2001
From: Jonas Otto <jonas@jonasotto.com>
Date: Sat, 22 Nov 2025 13:36:22 +0100
Subject: [PATCH] fix docs file structure to work with recent rosdoc2

Signed-off-by: Jonas Otto <jonas@jonasotto.com>
---
 launch/doc/.gitignore                    |  1 -
 launch/doc/Makefile                      | 20 -------------
 launch/doc/{source => }/architecture.rst |  0
 launch/doc/{source => }/conf.py          |  0
 launch/doc/{source => }/index.rst        |  5 +++-
 launch/doc/make.bat                      | 36 ------------------------
 launch/package.xml                       |  1 +
 launch/rosdoc2.yaml                      |  6 ++++
 8 files changed, 11 insertions(+), 58 deletions(-)
 delete mode 100644 launch/doc/.gitignore
 delete mode 100644 launch/doc/Makefile
 rename launch/doc/{source => }/architecture.rst (100%)
 rename launch/doc/{source => }/conf.py (100%)
 rename launch/doc/{source => }/index.rst (76%)
 delete mode 100644 launch/doc/make.bat
 create mode 100644 launch/rosdoc2.yaml

diff --git a/launch/doc/.gitignore b/launch/doc/.gitignore
deleted file mode 100644
index 378eac25d..000000000
--- a/launch/doc/.gitignore
+++ /dev/null
@@ -1 +0,0 @@
-build
diff --git a/launch/doc/Makefile b/launch/doc/Makefile
deleted file mode 100644
index 8ff07eb9a..000000000
--- a/launch/doc/Makefile
+++ /dev/null
@@ -1,20 +0,0 @@
-# Minimal makefile for Sphinx documentation
-#
-
-# You can set these variables from the command line.
-SPHINXOPTS    =
-SPHINXBUILD   = sphinx-build
-SPHINXPROJ    = launch
-SOURCEDIR     = source
-BUILDDIR      = build
-
-# Put it first so that "make" without argument is like "make help".
-help:
-	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
-
-.PHONY: help Makefile
-
-# Catch-all target: route all unknown targets to Sphinx using the new
-# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
-%: Makefile
-	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
\ No newline at end of file
diff --git a/launch/doc/source/architecture.rst b/launch/doc/architecture.rst
similarity index 100%
rename from launch/doc/source/architecture.rst
rename to launch/doc/architecture.rst
diff --git a/launch/doc/source/conf.py b/launch/doc/conf.py
similarity index 100%
rename from launch/doc/source/conf.py
rename to launch/doc/conf.py
diff --git a/launch/doc/source/index.rst b/launch/doc/index.rst
similarity index 76%
rename from launch/doc/source/index.rst
rename to launch/doc/index.rst
index efcc56051..cf8e3e6fa 100644
--- a/launch/doc/source/index.rst
+++ b/launch/doc/index.rst
@@ -11,7 +11,10 @@ Welcome to launch's documentation!
    :caption: Contents:
 
    architecture
-   modules
+   Links <__links>
+   Python API <modules>
+   Standard Documents <__standards>
+   ROS Package Dependencies <__ros_package_dependencies>
 
 
 Indices and tables
diff --git a/launch/doc/make.bat b/launch/doc/make.bat
deleted file mode 100644
index b71a4a2b0..000000000
--- a/launch/doc/make.bat
+++ /dev/null
@@ -1,36 +0,0 @@
-@ECHO OFF
-
-pushd %~dp0
-
-REM Command file for Sphinx documentation
-
-if "%SPHINXBUILD%" == "" (
-	set SPHINXBUILD=sphinx-build
-)
-set SOURCEDIR=source
-set BUILDDIR=build
-set SPHINXPROJ=launch
-
-if "%1" == "" goto help
-
-%SPHINXBUILD% >NUL 2>NUL
-if errorlevel 9009 (
-	echo.
-	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
-	echo.installed, then set the SPHINXBUILD environment variable to point
-	echo.to the full path of the 'sphinx-build' executable. Alternatively you
-	echo.may add the Sphinx directory to PATH.
-	echo.
-	echo.If you don't have Sphinx installed, grab it from
-	echo.http://sphinx-doc.org/
-	exit /b 1
-)
-
-%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
-goto end
-
-:help
-%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
-
-:end
-popd
diff --git a/launch/package.xml b/launch/package.xml
index f254ab494..0c754acca 100644
--- a/launch/package.xml
+++ b/launch/package.xml
@@ -36,5 +36,6 @@
 
   <export>
     <build_type>ament_python</build_type>
+    <rosdoc2>rosdoc2.yaml</rosdoc2>
   </export>
 </package>
diff --git a/launch/rosdoc2.yaml b/launch/rosdoc2.yaml
new file mode 100644
index 000000000..d2f5855dd
--- /dev/null
+++ b/launch/rosdoc2.yaml
@@ -0,0 +1,6 @@
+type: "rosdoc2 config"
+version: 1
+---
+settings: {}
+builders:
+  - sphinx: { sphinx_sourcedir: "doc" }