Introduce a custom Kaniko-based image for OCI container builds, including a wrapper script (`build.sh`) for flexible execution. Added Forgejo CI workflows for PR, branch, and tag builds, along with detailed documentation in the updated README. Licensed under Apache 2.0. Reviewed-on: #1 Co-authored-by: Guillaume B.B. Van Hemmen <GuillaumeHemmen@noreply.git.van-hemmen.com> Co-committed-by: Guillaume B.B. Van Hemmen <GuillaumeHemmen@noreply.git.van-hemmen.com>
3.6 KiB
3.6 KiB
Contributing Guide
Thank you for your interest in contributing! We appreciate all pull requests (PRs), code reviews, bug reports, and feature ideas. To keep things smooth for everyone, please follow these guidelines.
Table of Contents
- Getting Started
- Code of Conduct
- How to Contribute
- Commit Message Guidelines
- Pull Request Process
- Maintainer Responsibilities
- License
Getting Started
- Fork the repository and create your own branch.
- Clone your fork to your local machine.
- Create a new branch for each piece of work:
git checkout -b feature/brief-description
Code of Conduct
All contributors are expected to follow our CODE_OF_CONDUCT.md. Be respectful, inclusive, and open-minded.
How to Contribute
Reporting Issues
- Search the issue tracker to see if your issue has already been reported.
- If not, open a new issue and provide:
- Title: Clear, concise.
- Description: Steps to reproduce, expected vs. actual behavior.
- Environment: OS, Java version, etc.
- Screenshots/Logs: When applicable.
Proposing Enhancements
- Check existing enhancement requests.
- Clearly outline:
- Motivation and use case.
- Proposed solution or approach.
- Potential alternatives.
Pull Requests (PRs)
Important:
- An issue must exist before any PR is submitted.
- Every PR must link to its corresponding issue in the description (e.g., “Closes #123”).
- All PRs must be merged using a squash commit.
Steps:
- Ensure your branch is up to date with
main
:git fetch origin git rebase origin/main
- Commit your changes (see “Commit Message Guidelines” below).
- Push your branch to your fork:
git push -u origin feature/brief-description
- Open a PR against
main
. - Fill out the PR template completely.
Commit Message Guidelines
format: "<type>
: <message>
"
Allowed <type>
values:
feat
, fix
, docs
, test
, refactor
, perf
, ci
, chore
.
Example:
fix: prevent NPE in OrderService when cart is null docs: add README section for Docker usage
Pull Request Process
- Ensure the PR description links to its issue
Use “Closes #” (or “Fixes”, “Resolves”). - Keep the PR focused—one logical change per PR.
- Rebase onto the latest
main
before opening or updating the PR:git fetch origin git rebase origin/main
- Push to your fork:
git push -u origin feature/brief-description
- Fill out every section of the PR template (tests, screenshots, etc.).
- Address all review comments; push additional commits as needed.
- Merging strategy
All PRs are merged using “Squash and merge.”
This keeps the main branch history linear and clean. - Once approved and all checks pass, a maintainer will squash-merge the PR.
Maintainer Responsibilities
- Triage new issues and confirm validity.
- Review PRs in a timely manner.
- Ensure all CI checks pass before merging.
- Enforce the squash-merge rule.
- Keep the documentation and release notes up to date.
License
By contributing, you agree that your work will be licensed under the same license as the project. See LICENSE.
Thank you again for helping make this project better!