2016-01-20 22:39:03 +01:00
|
|
|
# Contributing
|
2021-03-26 17:50:46 +01:00
|
|
|
We're glad you want to help us out and make this panel the best that it can be! We have a few simple things to follow
|
|
|
|
when making changes to files and adding new features.
|
|
|
|
|
|
|
|
### Development Environment
|
|
|
|
Please check the [`pterodactyl/development`](https://github.com/pterodactyl/development) repository for a Vagrant &
|
|
|
|
Docker setup that should run on most macOS and Linux distributions. In the event that your platform is not supported
|
|
|
|
you're welcome to open a PR, or just take a look at our setup scripts to see what you'll need to successfully develop
|
|
|
|
with Pterodactyl.
|
|
|
|
|
|
|
|
#### Building Assets
|
|
|
|
Please see [`BUILDING.md`](https://github.com/pterodactyl/panel/blob/develop/BUILDING.md) for details on how to actually
|
|
|
|
build and run the development server.
|
2016-01-20 22:39:03 +01:00
|
|
|
|
2017-10-05 07:13:10 +02:00
|
|
|
### Project Branches
|
|
|
|
This section mainly applies to those with read/write access to our repositories, but can be helpful for others.
|
|
|
|
|
2021-03-26 17:50:46 +01:00
|
|
|
The `develop` branch should always be in a runnable state, and not contain any major breaking features. For the most
|
|
|
|
part, this means you will need to create `feature/` branches in order to add new functionality or change how things
|
|
|
|
work. When making a feature branch, if it is referencing something in the issue tracker, please title the branch
|
|
|
|
`feature/PTDL-###` where `###` is the issue number.
|
2017-10-05 07:13:10 +02:00
|
|
|
|
2021-03-26 17:50:46 +01:00
|
|
|
All new code should contain tests to ensure their functionality is not unintentionally changed down the road. This
|
|
|
|
is especially important for any API actions or authentication based controls.
|
2017-10-05 07:13:10 +02:00
|
|
|
|
2021-03-26 17:50:46 +01:00
|
|
|
### The CHANGELOG
|
|
|
|
You should not make any changes to the `CHANGELOG.md` file during your code updates. This is updated by the maintainers
|
|
|
|
at the time of deployment to include the relevant changes that were made.
|
2017-10-05 07:13:10 +02:00
|
|
|
|
2017-04-24 22:52:04 +02:00
|
|
|
### Code Guidelines
|
2021-03-26 17:50:46 +01:00
|
|
|
We are a `PSR-4` and `PSR-0` compliant project, so please follow those guidelines at a minimum. In addition we run
|
|
|
|
`php-cs-fixer` on all PRs and releases to enforce a consistent code style. The following command executed on your machine
|
|
|
|
should show any areas where the code style does not line up correctly.
|
2017-10-05 07:13:10 +02:00
|
|
|
|
2021-03-26 17:50:46 +01:00
|
|
|
```
|
|
|
|
vendor/bin/php-cs-fixer fix --dry-run --diff --diff-format=udiff --config .php_cs.dist
|
2017-10-05 07:13:10 +02:00
|
|
|
```
|
2017-04-24 22:52:04 +02:00
|
|
|
|
2016-01-20 22:39:03 +01:00
|
|
|
### Responsible Disclosure
|
2021-03-26 17:50:46 +01:00
|
|
|
This is a fairly in-depth project and makes use of a lot of parts. We strive to keep everything as secure as possible
|
|
|
|
and welcome you to take a look at the code provided in this project yourself. We do ask that you be considerate of
|
|
|
|
others who are using the software and not publicly disclose security issues without contacting us first by email.
|
2016-01-20 22:39:03 +01:00
|
|
|
|
2021-03-26 17:50:46 +01:00
|
|
|
We'll make a deal with you: if you contact us by email and we fail to respond to you within a week you are welcome to
|
|
|
|
publicly disclose whatever issue you have found. We understand how frustrating it is when you find something big and
|
|
|
|
no one will respond to you. This holds us to a standard of providing prompt attention to any issues that arise and
|
|
|
|
keeping this community safe.
|
2016-01-20 22:39:03 +01:00
|
|
|
|
2021-03-26 17:50:46 +01:00
|
|
|
If you've found what you believe is a security issue please email `dane åt pterodactyl døt io`.
|
2016-01-20 22:39:03 +01:00
|
|
|
|
2021-03-26 17:50:46 +01:00
|
|
|
### Contact Us
|
|
|
|
You can find us in a couple places online. First and foremost, we're active right here on Github. If you encounter a
|
|
|
|
bug or other problems, open an issue on here for us to take a look at it. We also accept feature requests here as well.
|
2016-01-20 22:39:03 +01:00
|
|
|
|
2021-03-26 17:50:46 +01:00
|
|
|
You can also find us on [Discord](https://discord.gg/pterodactyl).
|