# Contributing

Thanks for your interest in Cloudflare Computer. This repository accepts issues and discussions as the public contribution paths. It does not accept unsolicited pull requests.

## What to open

Use one of these routes:

1. **Bug reports, regressions, and fix proposals**
   - Open an issue: <https://github.com/cloudflare/computer/issues/new/choose>
   - Include steps to reproduce, what you expected to happen, what happened instead, and any relevant package version, runtime, operating system, Worker, or Container setup.
2. **Feature requests, enhancements, and design proposals**
   - Start a discussion: <https://github.com/cloudflare/computer/discussions/new?category=feature-request>
   - Describe the problem, the users affected, the outcome you want, and any API or workflow example that makes the proposal easier to evaluate.

## Pull requests

Please do not open a pull request unless a maintainer has asked you to. Pull requests that do not come from an approved collaborator may be closed and redirected to an issue or discussion.

If you already have a patch, open an issue or discussion instead and include:

- the problem the patch solves;
- the behavior change you propose;
- the tests or commands that prove the change works;
- any compatibility or migration concerns.

Starting from the problem gives maintainers room to decide whether the change fits the project and how it should land.

## Security reports

Do not report security issues in public issues, discussions, or pull requests. Follow Cloudflare's vulnerability disclosure process instead: <https://www.cloudflare.com/.well-known/security.txt>.

## Collaborators

Approved collaborators should follow [`COLLABORATORS.md`](COLLABORATORS.md) for setup, checks, commit messages, and pull request conventions.