docs(release): v1.9

- Add initial CHANGELOG.md (Keep a Changelog format)
- Group historical commits by Conventional Commit type
- Stabilise git-cliff configuration for automated changelog generation
- Fix template issues to support first run with no tags
- Align changelog wording with Computing:Box branding

Signed-off-by: Alexander Lyall <alex@adcm.uk>

CHANGELOG.md

@@ -0,0 +1,68 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Conventional Commits](https://www.conventionalcommits.org/).
+
+## [Unreleased]
+
+
+
+### Added
+
+
+- migrate CS:Box content to Computing:Box branding
+
+
+### Bit
+
+
+- Box Feature Migration
+
+
+### CI
+
+
+- add Gitea Actions workflow for site publishing
+
+
+### Chore
+
+
+- update CODEOWNERS and remove exported site artifacts
+
+- reorganise project files and add exported pages
+
+- add git-cliff config
+
+- standardise analytics, branding, and licensing across exported pages
+
+
+### Documentation
+
+
+- apply Creative Commons licence to V1 exported site
+
+
+### Reverted
+
+
+- revert 268a82f17c00792b8e678b5fb93383ae36200dfc
+
+revert ci(deploy): add Gitea Actions workflow for site publishing
+
+- Add publish workflow to deploy main branch via SFTP
+- Configure workflow dispatch and push-to-main triggers
+- Use repository variables and secrets for SSH credentials
+- Update README logo markup for consistent sizing
+
+Signed-off-by: Alexander Davis <alex@adcm.uk>
+
+
+### Signed-off-by
+
+
+- Alexander Davis <alex@adcm.uk>
+
+<!-- generated by git-cliff -->

cliff.toml

@@ -1,69 +1,56 @@
-# git-cliff ~ configuration file
+# git-cliff configuration
-# https://git-cliff.org/docs/configuration
+# Keep a Changelog compatible
+# Safe for first run with no tags
 
 [changelog]
-# A Tera template to be rendered as the changelog's header.
-# See https://keats.github.io/tera/docs/#introduction
 header = """
-# Changelog\n
+# Changelog
+
 All notable changes to this project will be documented in this file.
 
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n
+and this project adheres to [Conventional Commits](https://www.conventionalcommits.org/).
 """
-# A Tera template to be rendered for each release in the changelog.
+
-# See https://keats.github.io/tera/docs/#introduction
 body = """
-{% if version -%}
+{% if version %}
-    ## [{{ version | trim_start_matches(pat="v") }}] - {{ timestamp | date(format="%Y-%m-%d") }}
+## [{{ version }}] - {{ timestamp | date(format="%Y-%m-%d") }}
-{% else -%}
+{% else %}
-    ## [Unreleased]
+## [Unreleased]
-{% endif -%}
+{% endif %}
+
 {% for group, commits in commits | group_by(attribute="group") %}
-    ### {{ group | upper_first }}
+### {{ group }}
-    {% for commit in commits %}
+
-        - {{ commit.message | split(pat="\n") | first | upper_first | trim }}\
+{% for commit in commits %}
-    {% endfor %}
+- {{ commit.message | trim }}
-{% endfor %}\n
+{% endfor %}
+{% endfor %}
 """
-# A Tera template to be rendered as the changelog's footer.
+
-# See https://keats.github.io/tera/docs/#introduction
 footer = """
-{{#if release.previous}}
-[{{release.version}}]: {{remote_url}}/compare/{{release.previous.version}}...{{release.version}}
-{{/if}}
-"""
 <!-- generated by git-cliff -->
 """
-# Remove leading and trailing whitespaces from the changelog's body.
+
 trim = true
 
 [git]
-# Parse commits according to the conventional commits specification.
-# See https://www.conventionalcommits.org
 conventional_commits = true
-# Exclude commits that do not match the conventional commits specification.
 filter_unconventional = false
-# An array of regex based parsers for extracting data from the commit message.
+split_commits = false
-# Assigns commits to groups.
-# Optionally sets the commit's scope and can decide to exclude commits from further processing.
 commit_parsers = [
-    { message = "^[a|A]dd", group = "Added" },
+  { message = "^feat",  group = "Added" },
-    { message = "^[s|S]upport", group = "Added" },
-    { message = "^[r|R]emove", group = "Removed" },
-    { message = "^.*: add", group = "Added" },
-    { message = "^.*: support", group = "Added" },
-    { message = "^.*: remove", group = "Removed" },
-    { message = "^.*: delete", group = "Removed" },
-    { message = "^test", group = "Fixed" },
   { message = "^fix",   group = "Fixed" },
-    { message = "^.*: fix", group = "Fixed" },
+  { message = "^docs",  group = "Documentation" },
-    { message = "^.*", group = "Changed" },
+  { message = "^style", group = "Styling" },
+  { message = "^refactor", group = "Changed" },
+  { message = "^perf",  group = "Performance" },
+  { message = "^test",  group = "Tests" },
+  { message = "^build", group = "Build" },
+  { message = "^ci",    group = "CI" },
+  { message = "^chore", group = "Chore" },
+  { message = "^revert", group = "Reverted" }
 ]
-# Prevent commits that are breaking from being excluded by commit parsers.
+
-filter_commits = false
+protect_breaking_commits = false
-# Order releases topologically instead of chronologically.
-topo_order = false
-# Order of commits in each group/release within the changelog.
-# Allowed values: newest, oldest
 sort_commits = "oldest"