You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The InsightDoxygenDocTag-<version>.gz release artifact stopped shipping after v5.3.0, even though Documentation/Maintenance/Release.md still requires it. Downstream documentation builds (ITKSphinxExamples) that resolve itk:: class references through the tag file are pinned to the stale 5.3.0 copy, which predates current class compounds and produces broken/missing class links.
Root cause
When nightly Doxygen generation moved to the ITKDoxygen GHA repository (Discourse #4790), its packaging only shipped the Html and Xml tarballs. Doxygen generates InsightDoxygen.tag on every run (Utilities/Doxygen/DoxygenConfig.cmake sets GENERATE_TAGFILE), but run.sh never copies it out of the container — so the "download from the latest ITKDoxygen Release and rename" release flow silently lost the asset. No issue, PR, or Discourse thread records a decision to drop it; it is an unnoticed omission.
The v5.3.0-era Doxygen run produced no class compounds for itk::AddImageFilter and itk::Statistics::SampleToHistogramFilter (the only published XML/tag with them is now v6.0b01).
Current ITKDoxygen artifacts lack itk::ImageToVTKImageFilter, itk::VTKImageToImageFilter, and itk::OpenCVImageBridge, because the docker build does not enable Module_ITKVtkGlue / Module_ITKVideoBridgeOpenCV (no VTK/OpenCV in the image); the 5.3-era build covered them.
The
InsightDoxygenDocTag-<version>.gzrelease artifact stopped shipping after v5.3.0, even thoughDocumentation/Maintenance/Release.mdstill requires it. Downstream documentation builds (ITKSphinxExamples) that resolveitk::class references through the tag file are pinned to the stale 5.3.0 copy, which predates current class compounds and produces broken/missing class links.Root cause
When nightly Doxygen generation moved to the ITKDoxygen GHA repository (Discourse #4790), its packaging only shipped the Html and Xml tarballs. Doxygen generates
InsightDoxygen.tagon every run (Utilities/Doxygen/DoxygenConfig.cmakesetsGENERATE_TAGFILE), butrun.shnever copies it out of the container — so the "download from the latest ITKDoxygen Release and rename" release flow silently lost the asset. No issue, PR, or Discourse thread records a decision to drop it; it is an unnoticed omission.Two secondary coverage gaps were found while diagnosing this in ITKSphinxExamples (InsightSoftwareConsortium/ITKSphinxExamples#458):
itk::AddImageFilteranditk::Statistics::SampleToHistogramFilter(the only published XML/tag with them is now v6.0b01).itk::ImageToVTKImageFilter,itk::VTKImageToImageFilter, anditk::OpenCVImageBridge, because the docker build does not enableModule_ITKVtkGlue/Module_ITKVideoBridgeOpenCV(no VTK/OpenCV in the image); the 5.3-era build covered them.Proposed plan
InsightDoxygenDocTag-latest.gznext to Html/Xml, and add VTK/OpenCV to the image so the bridge-module classes return. One Doxygen run then produces a consistent html+xml+tag set.v*tag pushes now uploadInsightDoxygenDocTag-<version>.gzto the release, restoringRelease.mdcompliance with no manual steps. Its module set is aligned with the ITKDoxygen nightly.latestrelease (the examples build ITKmain, so trackinglatestis more correct than pinning immutable release assets) and remove the temporary missing-class warning exception.Acceptance
InsightDoxygenDocTag-*present in the ITKDoxygenlatestrelease and in the next ITK release's assets.