Hide the starts of EOL versions

Author: encukou

_static/devguide_overrides.css

@@ -54,8 +54,9 @@
     fill: black;
 }
 
+.release-cycle-chart .release-cycle-blob-label.release-cycle-status-end-of-life,
 .release-cycle-chart .release-cycle-blob-label.release-cycle-status-feature {
-    /* and FG when it's not in a pill */
+    /* and FG when it's not in a blob */
     fill: var(--color-foreground-primary);
 }
 

_tools/generate_release_cycle.py

@@ -39,24 +39,30 @@ def __init__(self, limit_to_active=False) -> None:
             version["start_security_date"] = r1 + dt.timedelta(days=2 * 365)
             version["end_of_life_date"] = parse_date(version["end_of_life"])
 
+        self.cutoff = min(ver["first_release_date"] for ver in self.versions.values())
+
         if limit_to_active:
-            cutoff = min(
+            self.cutoff = min(
                 version["first_release_date"]
                 for version in self.versions.values()
                 if version["status"] != 'end-of-life'
             )
             self.versions = {
                 key: version
                 for key, version in self.versions.items()
-                if version["end_of_life_date"] >= cutoff
+                if version["end_of_life_date"] >= self.cutoff
             }
+            self.id_key='active'
+        else:
+            self.id_key='all'
 
         self.sorted_versions = sorted(
             self.versions.values(),
             key=lambda v: [int(i) for i in v["key"].split(".")],
             reverse=True,
         )
 
+
     def write_csv(self) -> None:
         """Output CSV files."""
         now_str = str(dt.datetime.now(dt.timezone.utc))
@@ -110,7 +116,7 @@ def write_svg(self, today: str, out_path: str) -> None:
         # some positioning numbers in the template as well.
         LINE_HEIGHT = 1.5
 
-        first_date = min(ver["first_release_date"] for ver in self.sorted_versions)
+        first_date = self.cutoff
         last_date = max(ver["end_of_life_date"] for ver in self.sorted_versions)
 
         def date_to_x(date: dt.date) -> float:
@@ -136,11 +142,14 @@ def format_year(year: int) -> str:
                 diagram_height=(len(self.sorted_versions) + 2) * LINE_HEIGHT,
                 years=range(first_date.year, last_date.year + 1),
                 LINE_HEIGHT=LINE_HEIGHT,
+                LEGEND_WIDTH=LEGEND_WIDTH,
+                RIGHT_MARGIN=RIGHT_MARGIN,
                 versions=list(reversed(self.sorted_versions)),
                 today=dt.datetime.strptime(today, "%Y-%m-%d").date(),
                 year_to_x=year_to_x,
                 date_to_x=date_to_x,
                 format_year=format_year,
+                id_key=self.id_key,
             ).dump(f)
 
 

_tools/release_cycle_template.svg.jinja

@@ -4,6 +4,12 @@
     class="release-cycle-chart"
     viewBox="0 0 {{ diagram_width * SCALE }} {{ diagram_height * SCALE }}"
 >
+    <defs>
+        <linearGradient id="release-cycle-mask-gradient-{{ id_key }}">
+            <stop stop-color="black" offset="0%" />
+            <stop stop-color="white" offset="100%" />
+        </linearGradient>
+    </defs>
 
     {% for version in versions %}
         {% set y = loop.index * LINE_HEIGHT %}
@@ -42,6 +48,31 @@
         {% endif %}
     {% endfor %}
 
+    <!-- Gradient mask to fade out end-of-life versions -->
+    <mask id="release-cycle-mask-{{ id_key }}">
+        <rect
+            x="0"
+            y="0"
+            width="{{ LEGEND_WIDTH * SCALE }}"
+            height="{{ diagram_height * SCALE }}"
+            fill="black"
+        />
+        <rect
+            x="{{ (LEGEND_WIDTH - RIGHT_MARGIN) * SCALE }}"
+            y="0"
+            width="{{ RIGHT_MARGIN * SCALE }}"
+            height="{{ diagram_height * SCALE }}"
+            fill="url(#release-cycle-mask-gradient-{{ id_key }})"
+        />
+        <rect
+            x="{{ (LEGEND_WIDTH ) * SCALE }}"
+            y="0"
+            width="{{ diagram_width * SCALE }}"
+            height="{{ diagram_height * SCALE }}"
+            fill="white"
+        />
+    </mask>
+
     {% for version in versions %}
         {% set y = loop.index * LINE_HEIGHT %}
 
@@ -74,7 +105,7 @@
         {% set radius_value = 0.25 * SCALE %}
 
         {% if version.status != "end-of-life" %}
-            <!-- Split the pill -->
+            <!-- Split the blob -->
             <path
                 class="release-cycle-blob release-cycle-status-bugfix"
                 d="
@@ -109,6 +140,7 @@
             height="{{ 1.25 * SCALE }}"
             rx="0.25em"
             ry="0.25em"
+            mask="url(#release-cycle-mask-{{ id_key }})"
         />
         <rect
             class="release-cycle-border release-cycle-status-{{ version.status }}"
@@ -118,6 +150,7 @@
             height="{{ 1.25 * SCALE }}"
             rx="0.25em"
             ry="0.25em"
+            mask="url(#release-cycle-mask-{{ id_key }})"
         />
         {% if version.status == "bugfix" %}
             <text
@@ -142,27 +175,22 @@
         {% elif version.status == "end-of-life" %}
             <text
                 class="release-cycle-blob-label release-cycle-status-end-of-life"
-                {% if version.key != "3.0" %}
-                    x="{{ (start_x + end_x) / 2 * SCALE }}"
-                    text-anchor="middle"
-                {% else %}
-                    x="{{ (end_x + 0.25) * SCALE }}"
-                    text-anchor="start"
-                {% endif %}
+                x="{{ (end_x + 0.25) * SCALE }}"
+                text-anchor="start"
                 y="{{ (y - 0.1) * SCALE }}"
                 font-size="{{ SCALE * 0.75 }}"
             >
                 end-of-life
             </text>
-        {% elif version.status == "feature" %}
+        {% else %}
             <text
                 class="release-cycle-blob-label release-cycle-status-feature"
                 x="{{ (start_x - 0.5) * SCALE }}"
                 y="{{ (y - 0.1) * SCALE }}"
                 font-size="{{ SCALE * 0.75 }}"
                 text-anchor="end"
             >
-                feature
+                {{ version.status }}
             </text>
         {% endif %}
     {% endfor %}