Skip to content

Stop building & deploying EOL distro documentation. - #7022

Open
fujitatomoya wants to merge 2 commits into
rollingfrom
ros2_documentation/issues/6964
Open

Stop building & deploying EOL distro documentation.#7022
fujitatomoya wants to merge 2 commits into
rollingfrom
ros2_documentation/issues/6964

Conversation

@fujitatomoya

Copy link
Copy Markdown
Collaborator

Description

part of #6964

Fixes # (issue)

Did you use Generative AI?

Yes, Claude Opus 5

Additional Information

@github-actions

github-actions Bot commented Jul 27, 2026

Copy link
Copy Markdown

HTML artifacts: https://github.com/ros2/ros2_documentation/actions/runs/31062985964/artifacts/8952877868.

To view the resulting site:

  1. Click on the above link to download the artifacts archive
  2. Extract it
  3. Open html-artifacts-7022/index.html in your favorite browser

Comment thread conf.py
# insertion order).
smv_all_versions = list(distro_full_names)

smv_latest_version = 'lyrical'

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Probably want to make sure this is a check list item for the release @sloretz.

Comment thread source/_templates/versions.html
@kscottz

kscottz commented Aug 3, 2026

Copy link
Copy Markdown
Collaborator

@fujitatomoya I checked out this PR and ran make clean followed by make multiversion and ended up with this set of warnings. Does this PR rely on anything else? Shouldn't these branches not be getting built?

/tmp/tmp3kp_fgyj/c9ca47d35c6e921b09ea03060a5e34a1a74a4075/source/Releases/Release-Dashing-Diademata.rst:936: WARNING: 'any' reference target not found: rosdistro [ref.any]
/tmp/tmp3kp_fgyj/c9ca47d35c6e921b09ea03060a5e34a1a74a4075/source/Releases/Release-Eloquent-Elusor.rst:389: WARNING: 'any' reference target not found: rosdistro [ref.any]
/tmp/tmp3kp_fgyj/c9ca47d35c6e921b09ea03060a5e34a1a74a4075/source/Releases/Release-Foxy-Fitzroy.rst:603: WARNING: 'any' reference target not found: rosdistro [ref.any]
build finished with problems, 3 warnings (with warnings treated as errors).
Traceback (most recent call last):
  File "/home/katscott/Code/ros2doc/bin/sphinx-multiversion", line 7, in <module>
    sys.exit(main())
             ~~~~^^
  File "/home/katscott/Code/ros2doc/lib/python3.13/site-packages/sphinx_multiversion/main.py", line 338, in main
    subprocess.check_call(cmd, cwd=current_cwd)
    ~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3.13/subprocess.py", line 419, in check_call
    raise CalledProcessError(retcode, cmd)
subprocess.CalledProcessError: Command '('/home/katscott/Code/ros2doc/bin/python3', '-R', '-m', 'sphinx', '-W', '-D', 'smv_metadata_path=/tmp/tmp3kp_fgyj/versions.json', '-D', 'smv_current_version=lyrical', '-c', '/home/katscott/Code/ros2_documentation', '/tmp/tmp3kp_fgyj/c9ca47d35c6e921b09ea03060a5e34a1a74a4075/source', '/home/katscott/Code/ros2_documentation/build/html/lyrical')' returned non-zero exit status 1.
make: *** [Makefile:22: multiversion] Error 1
(ros2doc) katscott@katscott-glaptop2:~/Code/ros2_documentation$ 

@fujitatomoya

Copy link
Copy Markdown
Collaborator Author

@kscottz thanks for checking this. hmmm, that is strange, i checked all the make targets worked okay. let me confirm those.

Signed-off-by: Tomoya.Fujita <fujita.tomoya@triorb.co.jp>
@fujitatomoya
fujitatomoya force-pushed the ros2_documentation/issues/6964 branch from 8c8b64b to cdc03fd Compare August 6, 2026 00:50
@fujitatomoya

Copy link
Copy Markdown
Collaborator Author

@fujitatomoya I checked out this PR and ran make clean followed by make multiversion and ended up with this set of warnings. Does this PR rely on anything else? Shouldn't these branches not be getting built?

/tmp/tmp3kp_fgyj/c9ca47d35c6e921b09ea03060a5e34a1a74a4075/source/Releases/Release-Dashing-Diademata.rst:936: WARNING: 'any' reference target not found: rosdistro [ref.any]
/tmp/tmp3kp_fgyj/c9ca47d35c6e921b09ea03060a5e34a1a74a4075/source/Releases/Release-Eloquent-Elusor.rst:389: WARNING: 'any' reference target not found: rosdistro [ref.any]
/tmp/tmp3kp_fgyj/c9ca47d35c6e921b09ea03060a5e34a1a74a4075/source/Releases/Release-Foxy-Fitzroy.rst:603: WARNING: 'any' reference target not found: rosdistro [ref.any]
build finished with problems, 3 warnings (with warnings treated as errors).
Traceback (most recent call last):
  File "/home/katscott/Code/ros2doc/bin/sphinx-multiversion", line 7, in <module>
    sys.exit(main())
             ~~~~^^
  File "/home/katscott/Code/ros2doc/lib/python3.13/site-packages/sphinx_multiversion/main.py", line 338, in main
    subprocess.check_call(cmd, cwd=current_cwd)
    ~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3.13/subprocess.py", line 419, in check_call
    raise CalledProcessError(retcode, cmd)
subprocess.CalledProcessError: Command '('/home/katscott/Code/ros2doc/bin/python3', '-R', '-m', 'sphinx', '-W', '-D', 'smv_metadata_path=/tmp/tmp3kp_fgyj/versions.json', '-D', 'smv_current_version=lyrical', '-c', '/home/katscott/Code/ros2_documentation', '/tmp/tmp3kp_fgyj/c9ca47d35c6e921b09ea03060a5e34a1a74a4075/source', '/home/katscott/Code/ros2_documentation/build/html/lyrical')' returned non-zero exit status 1.
make: *** [Makefile:22: multiversion] Error 1
(ros2doc) katscott@katscott-glaptop2:~/Code/ros2_documentation$ 

this is not happening in my local build environment.

tomoyafujita@~/DVT/github.com/ros2/ros2_documentation >make multiversion
...
writing additional pages... search done
copying images... [ 41%] Tutorials/Beginner-CLI-Tools/Understanding-ROS2-Topics/images/Topic-SinglePublisherandSingleSubscriber.gicopying images... [ 41%] Tutorials/Beginner-CLI-Tools/Understanding-ROS2-Topics/images/Topic-MultiplePublisherandMultipleSubscribecopying images... [100%] Tutorials/Miscellaneous/images/eclipse-oxygen-35.png
dumping search index in English (code: en)... done
dumping object inventory... done
sphinx-sitemap-ros: sitemap.xml was generated for URL https://docs.ros.org/en/lyrical in /home/tomoyafujita/DVT/github.com/ros2/ros2_documentation/build/html/lyrical/sitemap.xml
build succeeded.

The HTML pages are in ../../../home/tomoyafujita/DVT/github.com/ros2/ros2_documentation/build/html/lyrical.
python3 make_sitemapindex.py
(ros2doc)
tomoyafujita@~/DVT/github.com/ros2/ros2_documentation >make clean
Removing everything under 'build'...

Signed-off-by: Tomoya Fujita <fujita.tomoya@triorb.co.jp>
@fujitatomoya
fujitatomoya requested a review from kscottz August 6, 2026 01:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants