ci(docs): add download link for openapi.yaml in doc site header

tburny · claude · tburny · commit 028be61bb234 · 2026-02-20T17:09:20.000+01:00
Blue header bar with direct raw.githubusercontent.com download link
for the OpenAPI spec file.

Co-Authored-By: Claude Opus 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/scripts/generate-docs.sh b/scripts/generate-docs.sh
@@ -198,10 +198,36 @@ generate_html_content() {
     body {
       height: 100%;
       overflow: hidden;
+      display: flex;
+      flex-direction: column;
+    }
+
+    #download-bar {
+      background: #003399;
+      color: #fff;
+      padding: 6px 16px;
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      flex-shrink: 0;
+      font-size: 13px;
+    }
+
+    #download-bar a {
+      color: #fff;
+      text-decoration: none;
+      background: rgba(255,255,255,0.15);
+      padding: 4px 12px;
+      border-radius: 4px;
+      font-size: 13px;
+    }
+
+    #download-bar a:hover {
+      background: rgba(255,255,255,0.25);
     }
 
     #redoc-container {
-      height: 100vh;
+      flex: 1;
       overflow: auto;
     }
 
@@ -214,6 +240,10 @@ generate_html_content() {
   </style>
 </head>
 <body>
+  <div id="download-bar">
+    <span>EURES Job Search API &mdash; OpenAPI 3.1.0 Specification</span>
+    <a href="https://raw.githubusercontent.com/rorar/EURES-API-Documentation/main/openapi.yaml" download="openapi.yaml">Download openapi.yaml</a>
+  </div>
   <div id="redoc-container"></div>
 
   <script src="https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js"></script>
@@ -222,7 +252,7 @@ generate_html_content() {
       'openapi.yaml',
       {
         title: 'EURES Job Search API Documentation',
-        scrollYOffset: 0,
+        scrollYOffset: 36,
         hideDownloadButton: false,
         expandResponses: '200',
         pathInMiddlePanel: true,
