@@ -13,14 +13,21 @@ docs/
1313│ │ │ └── 2.9-cpu-sagemaker.yml
1414│ │ └── <repository>/
1515│ │ └── <version>-<accelerator>-<platform>.yml
16+ │ ├── legacy/ # Historical support data
17+ │ │ └── legacy_support.yml
1618│ ├── tables/ # Table column configurations
1719│ │ └── <repository>.yml
1820│ ├── templates/reference/ # Jinja2 templates
1921│ │ ├── available_images.template.md
2022│ │ └── support_policy.template.md
21- │ ├── global.yml # Shared terminology and configuration
23+ │ ├── constants.py # Path constants and global variables
2224│ ├── generate.py # Generation logic
23- │ └── main.py # CLI entry point
25+ │ ├── global.yml # Shared terminology and configuration
26+ │ ├── hooks.py # MkDocs hooks entry point
27+ │ ├── logger.py # Logging configuration
28+ │ ├── macros.py # MkDocs macros plugin integration
29+ │ ├── main.py # CLI entry point
30+ │ └── utils.py # Reusable helper functions
2431├── reference/
2532│ ├── available_images.md # Generated
2633│ └── support_policy.md # Generated
@@ -111,6 +118,66 @@ eop: '2026-10-15' # End of Patch date (YYYY-MM-DD)
111118- The generator validates this and raises an error if dates are inconsistent
112119- Supported vs Unsupported is auto-determined by comparing EOP to current date
113120
121+ ### Support Policy Consolidation
122+
123+ The ` framework_groups` configuration in `global.yml` consolidates support policy rows by framework. Repositories in the same group are combined into a
124+ single row using the framework display name.
125+
126+ ` ` ` yaml
127+ # docs/src/global.yml
128+ framework_groups:
129+ pytorch:
130+ - pytorch-training
131+ - pytorch-inference
132+ - pytorch-training-arm64
133+ - pytorch-inference-arm64
134+ tensorflow:
135+ - tensorflow-training
136+ - tensorflow-inference
137+ - tensorflow-inference-arm64
138+ ` ` `
139+
140+ **Requirements:**
141+
142+ - All repositories in a group with a given version must have identical GA/EOP dates
143+ - Missing versions in some repositories are allowed (only present repos are consolidated)
144+ - A `ValueError` is raised if dates differ within a group for the same version
145+
146+ * * *
147+
148+ # # Legacy Support Data
149+
150+ Historical support policy data for older, unsupported images is stored in `docs/src/legacy/legacy_support.yml`. This data appears only in the "No
151+ Longer Supported" section of `support_policy.md`.
152+
153+ # ## File Format
154+
155+ ` ` ` yaml
156+ PyTorch:
157+ - version: "2.5"
158+ ga: "2024-10-29"
159+ eop: "2025-10-29"
160+ - version: "2.4"
161+ ga: "2024-07-24"
162+ eop: "2025-07-24"
163+ TensorFlow:
164+ - version: "2.16"
165+ ga: "2024-03-15"
166+ eop: "2025-03-15"
167+ ` ` `
168+
169+ # ## Adding Legacy Entries
170+
171+ 1. Open `docs/src/legacy/legacy_support.yml`
172+ 2. Add entries under the framework display name key (e.g., `PyTorch`, `TensorFlow`)
173+ 3. Each entry requires : ` version` , `ga`, `eop`
174+
175+ # ## Behavior
176+
177+ - Legacy entries appear only in `support_policy.md` (unsupported section)
178+ - Images past their EOP date are automatically filtered from `available_images.md`
179+ - The `is_image_supported()` function checks if `eop >= today`
180+
114181* * *
115182
116183# # Editing Table Columns in available_images.md
@@ -317,7 +384,7 @@ python main.py --verbose
317384# ## Preview with MkDocs
318385
319386` ` ` bash
320- cd /path/to/deep-learning-containers
387+ cd docs
321388mkdocs serve
322389` ` `
323390
0 commit comments