Skip to main content

Find us.

z4j is built in the open. Every feature decision, every bug report, every release lives on GitHub.

contributing

How to contribute

Bug fixes

Open a PR against main. DCO sign-off required (git commit -s). Tests required for anything non-trivial.

New engine adapter

~300 LOC per adapter. Protocol is public + stable. The existing adapters are the reference.

New scheduler adapter

~200 LOC per adapter. Read + lifecycle operations (v1.0), create/update in v1.1.

Documentation

docs live in /docs on the main branch. Markdown. z4j.dev is auto-built from that content.

Triage

Helping new contributors land their first PR, labeling incoming issues, verifying bug reports.

Security

Find a bug, email security@z4j.com, get credit in the advisory. We welcome adversarial reviews.

code of conduct

How we behave here

We follow the Contributor Covenant 2.1. Translation: be respectful, assume good intent, disagree on the technical merits, let maintainers have the last word when the conversation stops being productive.

Harassment, personal attacks, or hostile behavior will get you banned. Reports go to conduct@z4j.com.

Start contributing

The contributor guide walks through the whole workflow in 15 minutes.