docs: added versions page

risk: low

Author: ParzivalPavlis

docs/content/en/versions/_index.md

@@ -1,6 +1,16 @@
 ---
-title: "Release Notes and Upgrade Guides"
+itle: "Python SDK Archive"
 linkTitle: "Versions"
 toc_hide: true
+versionPicker: false
+sectionIndex: falsex
+cascade:
+- type: "docs"
+  toc_root: true
+  _target:
+    path: "/*/**"
 ---
-Here you can find all available releases.
+
+This page contains the latest versions of the Python SDK documentation.
+
+{{< versions-archive >}}

docs/layouts/shortcodes/versions-archive.html

@@ -0,0 +1,87 @@
+{{/* (C) 2023 GoodData Corporation */}}
+{{/* Static versions archive table - generated by Hugo at build time */}}
+
+{{ if .Site.Params.versions }}
+
+{{ $allVersions := .Site.Params.versions }}
+{{ $changelogPageURL := "https://github.com/gooddata/gooddata-python-sdk/releases/tag/v" }}
+
+{{ if $allVersions }}
+<div id="versions-container">
+    <!-- Non-dev versions table -->
+    <div class="table-responsive">
+        <p>Latest versions</p>
+        <table class="table table-striped table-hover" id="versions-table">
+            <thead class="table-dark">
+                <tr>
+                    <th scope="col">Version</th>
+                    <th scope="col">Documentation</th>
+                    <th scope="col">Changelog</th>
+                </tr>
+            </thead>
+            <tbody id="versions-tbody">
+                {{ range $allVersions }}
+                {{ if not (eq .version "dev") }}
+                <tr>
+                    <td><strong>{{ .version }}</strong></td>
+                    <td>
+                        <a href="{{ .url }}" aria-label="View documentation for version {{ .version }}">
+                            <i class="fas fa-book me-1" aria-hidden="true"></i>View Documentation
+                        </a>
+                    </td>
+                    <td>
+                        {{ if .changelog}}
+                            <a href="{{ .changelog }}" aria-label="View changelog for version {{ .version }}">
+                                <i class="fas fa-book me-1" aria-hidden="true"></i>View Changelog
+                            </a>
+                        {{ else }}
+                            {{ $versionParts := split .version "." }}
+                            {{ $formattedVersion := .version }}
+                            {{ if eq (len $versionParts) 2 }}
+                                {{ $formattedVersion = printf "%s.0" .version }}
+                            {{ end }}
+                            <a href="{{ $changelogPageURL }}{{ $formattedVersion }}" aria-label="View changelog for version {{ .version }}">
+                                <i class="fas fa-book me-1" aria-hidden="true"></i>View Changelog
+                            </a>
+                        {{ end }}
+                    </td>
+                </tr>
+                {{ end }}
+                {{ end }}
+            </tbody>
+        </table>
+    </div>
+    <!-- Dev version table -->
+    <div class="table-responsive">
+        <p>Versions in active development</p>
+        <table class="table table-striped table-hover" id="dev-versions-table">
+            <thead class="table-dark">
+                <tr>
+                    <th scope="col">Version</th>
+                    <th scope="col">Documentation</th>
+                </tr>
+            </thead>
+            <tbody id="dev-versions-tbody">
+                {{ range $allVersions }}
+                {{ if eq .version "dev" }}
+                <tr>
+                    <td><strong>{{ .version }}</strong></td>
+                    <td>
+                        <a href="{{ .url }}" aria-label="View documentation for version {{ .version }}">
+                            <i class="fas fa-book me-1" aria-hidden="true"></i>View Documentation
+                        </a>
+                    </td>
+                </tr>
+                {{ end }}
+                {{ end }}
+            </tbody>
+        </table>
+    </div>
+</div>
+{{ else }}
+<div class="alert alert-warning" role="alert">
+    <h4>No Versions Available</h4>
+    <p>No documentation versions are currently available for display.</p>
+</div>
+{{ end }}
+{{ end }}

docs/static/js/archive-link.js

@@ -0,0 +1,38 @@
+document.addEventListener('DOMContentLoaded', function () {
+    function createArchiveLink() {
+        const link = document.createElement('a');
+        link.className = 'dropdown-item';
+
+        const currentHostname = window.location.hostname;
+        if (currentHostname.includes('netlify.app')) {
+            // For Netlify previews, link to the versions page within the current preview site
+            link.href = window.location.origin + '/docs/python-sdk/versions/';
+        } else if (currentHostname === 'localhost' || currentHostname === '127.0.0.1') {
+            // For local testing, link to the versions page
+            link.href = '/versions/';
+        } else {
+            // For production - link to the unversioned archive page
+            link.href = 'https://www.gooddata.com/docs/python-sdk/versions/';
+        }
+
+        // Safe DOM manipulation - XSS protected
+        const icon = document.createElement('i');
+        icon.className = 'fas fa-archive me-2';
+        icon.setAttribute('aria-hidden', 'true');
+
+        link.appendChild(icon);
+        link.appendChild(document.createTextNode('Archive'));
+
+        // Add descriptive text for screen readers
+        link.setAttribute('aria-label', 'View all versions in archive');
+
+        return link;
+    }
+
+    // Select the dropdown menu and add the archive link
+    const dropdownMenus = document.getElementsByClassName('dropdown-menu');
+    for (let i = 0; i < dropdownMenus.length; i++) {
+        const archiveLink = createArchiveLink();
+        dropdownMenus[i].appendChild(archiveLink);
+    }
+});