# Contributing

## Creating an issue

If you have found a bug, want to request an enhancement or simply ask
a question, feel free to open an
[issue](https://github.com/leplusorg/docker-tor/issues/new/choose).

For security-related issues, please see our [security policy](/SECURITY.md).

## Submitting a pull request

If you want to contribute code, documentation etc. you can open a pull
request. We then kindly ask that:

- before working or submitting a large pull request, please open an
  issue to discuss what you have in mind and check that there is not
  an existing solution or a different approach.
- all code changes must be tested manually and automated tests should
  be included when possible.
- all necessary documentation should be included as well.
- the first commit's message on a pull request must follow the
  [conventional commits specification](https://www.conventionalcommits.org).
  See commit history for examples.
- all commits must be signed (this is supported by most Git clients as
  well as the GitHub web UI, see link below).

## Resources

- [Managing commit signature verification](https://docs.github.com/en/authentication/managing-commit-signature-verification)
- [Using Pull Requests](https://docs.github.com/en/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests)
- [Commit Message Format](https://github.com/angular/angular/blob/main/contributing-docs/commit-message-guidelines.md)