Skip to content

docs: add CI section to README and CI configuration guide - #59

Merged
ehennestad merged 11 commits into
mainfrom
add-ci-documentation
Jul 16, 2026
Merged

docs: add CI section to README and CI configuration guide#59
ehennestad merged 11 commits into
mainfrom
add-ci-documentation

Conversation

@ehennestad

@ehennestad ehennestad commented Jul 16, 2026

Copy link
Copy Markdown
Owner

Summary

Adds documentation for setting up GitHub Actions CI in toolbox repositories, and makes the README introduction benefit-oriented.

  • README: intro rewritten to lead with the problems MatBox solves (no package manager for dependencies, CI report formats, manual packaging), pairing each capability with the concrete command and the artifact it produces; replaces the abstract "What MatBox Does" feature list
  • README: new "Continuous Integration" section with a minimal test workflow example, an explanation of how MatBox and matbox-actions divide responsibility, and a link to the full guide
  • docs/ci.md: full CI guide covering the expected repository layout, all four reusable workflows (test-code-workflow, check-code-workflow, codespell-workflow, prepare-release-workflow) with complete input tables, the five-stage release pipeline, custom task wrapper discovery, badge behavior, Codecov setup, and version pinning

All documented inputs and behavior were checked against the actual matbox-actions@v1 workflow and action definitions.

Closes #42

🤖 Generated with Claude Code

Document how to set up GitHub Actions CI for toolbox repositories
using the matbox-actions reusable workflows: testing, code analysis,
spell checking, the release pipeline, badge behavior, and coverage.

Closes #42

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Test Results

23 tests   23 ✅  18s ⏱️
 5 suites   0 💤
 1 files     0 ❌

Results for commit a35e2a3.

♻️ This comment has been updated with latest results.

@codecov

codecov Bot commented Jul 16, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 43.29%. Comparing base (2519f3d) to head (a35e2a3).
⚠️ Report is 8 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main      #59      +/-   ##
==========================================
+ Coverage   42.02%   43.29%   +1.26%     
==========================================
  Files          59       61       +2     
  Lines        1468     1522      +54     
==========================================
+ Hits          617      659      +42     
- Misses        851      863      +12     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

ehennestad and others added 10 commits July 16, 2026 19:15
Lead with the problems MatBox solves (no package manager, CI report
formats, manual packaging) and pair each capability with the concrete
command and artifact, replacing the abstract feature list.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Real repositories show MatBox-produced badges, CI runs, and releases
live, serving as concrete demonstrations of the toolbox in use.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
MATLAB R2023b+ buildtool tasks can produce JUnit and Cobertura
reports, and R2025a integrates toolbox packaging with projects, so
'no standard way' overclaimed. The durable gaps are dependency
installation and the per-repository glue, which is what the intro
now claims.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Covers the feature merged in #61: project root files declared in
MLToolboxInfo.json (default LICENSE) are included in the packaged
toolbox.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
One-sentence factual summary, then a problem/solution bullet per
capability, with the example repositories as bullets instead of
inside a sentence. Drops the duplicate Example Repositories section
and the remaining marketing phrasing.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@ehennestad
ehennestad merged commit 48a63ea into main Jul 16, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Feature Request: Improve Documentation for CI Configuration

1 participant