Podplane Contributors Guide

Thanks for your interest in contributing to Podplane!

The Podplane ecosystem of open source projects also includes: Netsy, Nstance, Easy OIDC, and puidv7 sub-projects.

Bug Reports & Feature Requests

If you’ve found a bug or have a feature request, please file a GitHub Issue against the relevant repository.

Community Discussion

If you’d like to discuss Podplane in general, please join the community forum at https://forum.podplane.dev

Code & Documentation Contributions

We welcome contributions to all Podplane projects.

Opening a Pull Request requires a quick onboarding process:

1. Join our Community Forum at https://forum.podplane.dev

2. Fill out our contributor sign-up form. This tells us who you are, how to reach you, and which Contributor License Agreement (CLA) applies to you. We’ll review it and email you the right CLA(s) to complete. We are currently using Adobe Acrobat for signing CLAs.

3. Once your CLA is on file, we’ll add you to the Podplane GitHub orgs/repos with permission to open pull requests.

4. Sign off all your commits with a DCO:

   git config --global format.signoff true

   This adds a Signed-off-by line certifying you have the right to submit the work under the Developer Certificate of Origin. GitHub is configured to require DCO for all commits and pull requests.

If you are working on Podplane itself, see the Development guide for the local CLI, vmconfig, and components development workflow.

Contributor License Agreements (CLAs)

Podplane CLAs are derived from Apache Software Foundation contributor agreement templates.

Markdown and PDF versions are published at https://github.com/podplane/cla, and PDF files are sent via Adobe Acrobat for collecting your eSignature as part of the onboarding process outlined above.