Maintainer Guide

Maintainer Guide

Introduction

This doc covers notes for project maintainers.

Releasing

Overview

The released workflow is handled by our Release GitHub Action.

The release workflow:

Create a thin jar using our version scheme
Apply jar version to following docs:
1. user guide docs deps.edn usage example
2. change log "unreleased" and "unreleased breaking changes" headings
Deploy the jar to clojars
Commit and push updates made to CHANGELOG.adoc and 01-user-guide.adoc back to the project
Create and push a release tag back to the project repo
Inform cljdoc of the new release

At this time, the release workflow does not run tests. The assumption is that you’ve waited for the last CI test run to complete and are happy with the results.

The release workflow will fail if the change log is not ready for release.

Updating the Version

Edit version.edn in the project root. The release workflow consults this file when constructing the version.

Special Setup

GitHub has been configured with necessary secrets for GitHub Actions to deploy to clojars.

Local Verification

To run the change log validation locally:

bb ci-release validate

If you so wish, you can also locally run all steps up to, but not including, deploy via:

bb ci-release prep

Be aware though that you will NOT want to check in changes prep makes to CHANGELOG.adoc and 01-user-guide.adoc.

As a maintainer you should have sufficient privileges to see a "Run Workflow" dropdown button on the Release action page. The dropdown will prompt for a branch. I did not see a way to disable this prompt, simply leave it at "main" and run the workflow.

Don’t forget to pull after a release to get the changes made by the release workflow.

Introduction

Releasing

Overview

Updating the Version

Special Setup

Local Verification

Invoking