Add changelog to brain updates

Author: trickeydan

Rakefile

@@ -41,7 +41,7 @@ task :validate_kit_versions do
   data = YAML.load_file('_data/kit_versions.yml')
   data.each do |entry|
     actual = entry.keys.to_set
-    expected = ['version', 'released'].to_set
+    expected = ['version', 'released', 'changelog'].to_set
     missing = expected - actual
     extra = actual - expected
     messages = []

_data/kit_versions.yml

@@ -2,5 +2,10 @@
 # The format of this file should be like such:
 # - version: 20xx.y.z
 #   released: 2038-01-19
+#   changelog:
+#     - Changed something
+#     - Changed another thing too
 - version: 2023.0.0
-  released: 2022-10-21
+  released: 2022-10-21
+  changelog:
+    - Initial release for SR2023.

_includes/updates-list.html

@@ -0,0 +1,16 @@
+{% for kit_version in site.data.kit_versions %}
+  {% assign version = kit_version.version %}
+  {% if forloop.first %}
+  <h2><code><strong>{{ version }}</strong> ({{ kit_version.released | date_to_string }})</code> </h2>
+  {% else %}
+  <h2><code>{{ version }} ({{ kit_version.released | date_to_string }})</code></h2>
+  {% endif %}
+  <a class="kit-download-link" data-version="{{ version }}" href="https://github.com/srobo/robot-image/releases/download/v{{ version }}/srobo-image-robot-{{ version }}.img.xz">
+      Download {{ version }}
+  </a>
+  <ul>
+  {% for log in kit_version.changelog %}
+    <li>{{log }}</li>
+  {% endfor %}
+  </ul>
+{% endfor %}

_includes/updates-table.html

@@ -9,7 +9,7 @@ function handleDownloadClick(event) {
 }
 
 function addDownloadTracking() {
-  document.querySelectorAll("#updates-table .kit-download-link").forEach(function(link) {
+  document.querySelectorAll(".kit-download-link").forEach(function(link) {
     link.addEventListener("click", handleDownloadClick);
   });
 }

js/updates.js

@@ -13,9 +13,7 @@ Once you have downloaded the file you need, refer to the documentation on [updat
 Each update file is a complete upgrade. Each file contains the changes of those before it. If you need to jump up multiple versions, you can do so by using the latest file.
 
 {% if site.data.kit_versions.size > 0 %}
-The following table outlines the updates which have been published.
-
-{% include updates-table.html %}
+{% include updates-list.html %}
 {% else %}
 There are currently no updates available.
 {% endif %}