# Contributing

# Podplane Contributors Guide

Thanks for your interest in contributing to Podplane!

The Podplane ecosystem of open source projects also includes: [Netsy](https://netsy.dev), [Nstance](https://nstance.dev), [Easy OIDC](https://easy-oidc.dev), and [puidv7](https://puidv7.dev) 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](https://forum.podplane.dev)

2. **Fill out our [contributor sign-up form](https://contribute.podplane.dev/signup).** 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](https://developercertificate.org/). GitHub is configured to require DCO for all commits and pull requests.

If you are working on Podplane itself, see the [Development](development.md) 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](https://www.apache.org/licenses/contributor-agreements.html).

Markdown and PDF versions are published at [https://github.com/podplane/cla](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.