Skip to main content

Find us.

z4j is built in the open. Public discussions, issues, and release history are available 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

Roughly 800 to 3,000 lines per adapter, depending on how much of the engine's control surface it can safely expose. Protocol is public and stable. The existing adapters are the reference.

New scheduler adapter

Roughly 200 lines for a read-only surface, more where the upstream scheduler supports runtime mutation. Read and lifecycle operations are supported today; create/update is an open contribution area.

Documentation

Docs live in sites/z4j-dev/src/content/docs as Markdown and MDX. Open a pull request there and a maintainer builds and deploys the docs site.

Triage

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

Security

Find a bug, email [email protected], 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 [email protected].

Start contributing

Open a Discussion to introduce yourself or float an idea, file an issue if you found a bug, or jump straight to a pull request. DCO sign-off (git commit -s) is the only ceremony, no CLA.