| name | dev-workflow |
|---|---|
| description | Use when branching, building with Maven, CI, or release/publish workflows for this repo. |
- You need the canonical build/test commands or CI expectations.
- You are opening a PR and need branch rules (
development→master, GitHub Release publishing). - You are changing
pom.xml, plugins, or publishing configuration.
- Flow: work merges to
development; release PRs godevelopment→master(nostaging). Aftermastermoves, .github/workflows/back-merge-pr.yml can open a PRmaster→developmentto stay aligned. - Releases: create a GitHub Release (triggers .github/workflows/maven-publish.yml on
release: created). PRs that changesrc/mainorpom.xmlare checked by .github/workflows/check-version-bump.yml (version +changelog.md).
- Compile:
mvn clean compile - Tests:
mvn clean test -DskipTests=false(Surefire is configured withskipTeststrue by default inpom.xml; always pass-DskipTests=falsefor real test runs unless you intentionally skip.) - Package:
mvn clean package— note tests may be skipped unless you add-DskipTests=false. - Coverage report: after tests with skip disabled,
mvn jacoco:reportand opentarget/site/jacoco/index.html.
- On push, .github/workflows/coverage.yml uses Java 11 on Ubuntu and runs Maven + JaCoCo. Align local verification with those steps when debugging CI-only failures.
- Publishing and security scans live under .github/workflows/; read the relevant workflow before changing release or scan behavior.
- Run tests locally with
-DskipTests=falsebefore pushing. - Update changelog.md or version metadata when your team’s release process requires it.