Guides
Task-oriented manuals for working on cmdAbl. (Design docs live in
../feature-plans/.)
| Guide |
Use it when |
| Releasing cmdAbl |
You want to publish a new cmdAbl version |
| pakabl index |
An extension has a new version, or you want to add one to pakabl list |
| CI |
You want to know what runs on a PR / push and what the results mean |
The three workflows at a glance
| Workflow file |
Runs |
Does |
You do |
.github/workflows/ci.yml |
PRs, pushes to features/main, weekly |
Builds and packages the .ablx as a run artifact. Never releases. |
Read the result |
.github/workflows/package-release.yml |
Push to main |
Publishes a GitHub Release v<version> only if that version isn't released yet |
Bump the version to release |
.github/workflows/pakabl-index.yml |
Daily + manually |
Crawls approved sources and opens a PR with the refreshed pakabl/index.json |
Merge the PR |