Skip to content

MAI-14: document CI auto-version-bump workflow#10

Merged
vsmash merged 2 commits into
developfrom
task/MAI-14_document_ci_auto_bump
May 12, 2026
Merged

MAI-14: document CI auto-version-bump workflow#10
vsmash merged 2 commits into
developfrom
task/MAI-14_document_ci_auto_bump

Conversation

@vsmash
Copy link
Copy Markdown
Owner

@vsmash vsmash commented May 12, 2026

Summary

The CI auto-version-bump flags (`--create-gh-action`, `--show-gl-excerpt`, `--show-bb-excerpt`) appeared in `maiass --help` but were undocumented in `docs/` and the README. Adds narrative coverage so users have a real install path.

  • `docs/workflow.md` — new "CI Auto-Version-Bump on PR Merge" section covering value prop, the three install commands, per-provider PAT/token/app-password setup, the `MAIASS_DEVELOPBRANCH` bake-in (per MAI-13), the double-bump guard on GitLab/Bitbucket, and the AI-disabled-in-CI note.
  • `docs/commands.md` — new "CI Setup Commands" subsection with one-liners + link.
  • `docs/setup.md` — short "Continuous Integration" section.
  • `docs/configuration.md` — cross-reference under Branch Configuration.
  • `README.md` — new feature bullet under Key Features.

Test plan

  • Markdown links checked (all anchors target real sections).
  • Command examples are runnable as-shown.
  • All three providers (GitHub Actions / GitLab CI / Bitbucket Pipelines) are covered.
  • MAIASS_DEVELOPBRANCH bake-in mentioned in workflow.md and cross-referenced from configuration.md.

Ticket: https://velvary.atlassian.net/browse/MAI-14
Related: MAI-13 (substitution feature shipped)

Tyler Durton and others added 2 commits May 12, 2026 17:03
Added narrative documentation for the --create-gh-action,
--show-gl-excerpt, and --show-bb-excerpt flags. They are in --help
but were undocumented elsewhere; users discovering them had no path
to the PAT/token/app-password setup steps per provider.

- docs/workflow.md: new "CI Auto-Version-Bump on PR Merge" section
  covering the value prop, the three install commands, per-provider
  auth setup, the MAIASS_DEVELOPBRANCH bake-in (MAI-13), the double-
  bump guard mechanism, and the AI-disabled-in-CI note.
- docs/commands.md: new "CI Setup Commands" subsection under Command
  Structure, listing all three flags with one-liners and a link to
  the workflow.md walkthrough.
- docs/setup.md: short "Continuous Integration" section before
  Troubleshooting, with a link to workflow.md.
- docs/configuration.md: callout under "Branch Configuration"
  cross-referencing the CI template substitution.
- README.md: new "CI auto-version-bump" bullet under Key Features.

https://velvary.atlassian.net/browse/MAI-14
@vsmash vsmash merged commit 3cf40fa into develop May 12, 2026
8 checks passed
@vsmash vsmash deleted the task/MAI-14_document_ci_auto_bump branch May 12, 2026 07:06
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.

1 participant