Improve download page guidance

website/src/_data/downloads.js

@@ -7,6 +7,7 @@ module.exports = [
         format: "ZIP x64",
         icon: "🪟",
         recommended: true,
+        note: "Best choice for most Windows users.",
         url: `${base}/praktiKST-${latestTag}-windows-x64.zip`
     },
     {
@@ -14,6 +15,7 @@ module.exports = [
         format: "AppImage x86_64",
         icon: "🐧",
         recommended: true,
+        note: "Portable Linux build without package installation.",
         url: `${base}/KST4Contest-${latestTag}-linux-x86_64.AppImage`
     },
     {
@@ -21,6 +23,7 @@ module.exports = [
         format: "DEB amd64",
         icon: "📦",
         recommended: false,
+        note: "Native package for Debian and Ubuntu based systems.",
         url: `${base}/KST4Contest-${latestTag}-debian-amd64.deb`
     },
     {
@@ -28,6 +31,7 @@ module.exports = [
         format: "RPM x86_64",
         icon: "📦",
         recommended: false,
+        note: "Native package for Fedora/RPM based systems.",
         url: `${base}/KST4Contest-${latestTag}-fedora-x86_64.rpm`
     },
     {
@@ -35,6 +39,7 @@ module.exports = [
         format: "pkg.tar.zst",
         icon: "📦",
         recommended: false,
+        note: "Package build for Arch Linux users.",
         url: `${base}/KST4Contest-${latestTag}-archlinux-x86_64.pkg.tar.zst`
     },
     {
@@ -42,6 +47,7 @@ module.exports = [
         format: "DMG arm64",
         icon: "🍎",
         recommended: false,
+        note: "For Apple Silicon Macs.",
         url: `${base}/KST4Contest-${latestTag}-macos-arm64.dmg`
     },
     {
@@ -49,6 +55,7 @@ module.exports = [
         format: "DMG x86_64",
         icon: "🍎",
         recommended: false,
+        note: "For Intel-based Macs.",
         url: `${base}/KST4Contest-${latestTag}-macos-x86_64.dmg`
     },
     {
@@ -56,6 +63,7 @@ module.exports = [
         format: "PDF",
         icon: "📘",
         recommended: false,
+        note: "English PDF manual.",
         url: `${base}/KST4Contest-${latestTag}-manual-en.pdf`
     },
     {
@@ -63,6 +71,7 @@ module.exports = [
         format: "PDF",
         icon: "📘",
         recommended: false,
+        note: "German PDF manual.",
         url: `${base}/KST4Contest-${latestTag}-manual-de.pdf`
     }
 ];

website/src/download/index.njk

@@ -8,25 +8,51 @@ description: Download KST4Contest releases for Windows, Linux and macOS.
   <p class="badge">Download</p>
   <h1>Get KST4Contest</h1>
   <p class="lead">
-    Official builds are published through GitHub Releases for Windows, Linux and macOS.
+    Choose the package for your operating system. Official builds are published through GitHub Releases.
   </p>
 
   <div class="actions">
-    <a class="button" href="https://github.com/praktimarc/kst4contest/releases/latest">Latest release</a>
+    <a class="button" href="https://github.com/praktimarc/kst4contest/releases/latest">Latest release on GitHub</a>
     <a class="button secondary" href="https://github.com/praktimarc/kst4contest/releases">All releases</a>
   </div>
 </section>
 
 <section class="section">
+  <div class="section-heading">
+    <p class="eyebrow">Recommended downloads</p>
+    <h2>Pick your platform</h2>
+  </div>
+
   <div class="grid">
     {% for item in downloads %}
       <article class="card download-card">
         <div class="feature-icon">{{ item.icon }}</div>
-        {% if item.recommended %}<p class="badge">Recommended</p>{% endif %}
+
+        {% if item.recommended %}
+          <p class="badge">Recommended</p>
+        {% endif %}
+
         <h3>{{ item.os }}</h3>
-        <p>{{ item.format }}</p>
-        <a href="{{ item.url }}">Open download →</a>
+        <p><strong>{{ item.format }}</strong></p>
+        <p>{{ item.note }}</p>
+
+        <a class="button secondary" href="{{ item.url }}">Download →</a>
       </article>
     {% endfor %}
   </div>
+</section>
+
+<section class="section">
+  <div class="cta-panel">
+    <p class="eyebrow">Not sure?</p>
+    <h2>Which file should I use?</h2>
+    <p>
+      Windows users usually want the ZIP package. Linux users can start with the AppImage,
+      or install a native DEB/RPM package if preferred. The PDF manuals are attached to the same GitHub release.
+    </p>
+    <div class="actions">
+      <a class="button" href="/manual/en/installation/">Installation guide</a>
+      <a class="button secondary" href="/faq/">FAQ</a>
+    </div>
+  </div>
 </section>