--- title: "Contributions" version: "5.15" --- > Documentation Index > Fetch the complete documentation index at: https://docs.phalcon.io/llms.txt > Use this file to discover all available pages before exploring further. # Contributions # Contributing to Phalcon Phalcon is an open-source project and relies heavily on volunteer efforts and contributions. We welcome contributions from everyone! Please take a few moments to review this document to understand the contribution process and make it as efficient as possible for all. By following these guidelines, we can have faster resolution of issues and better communication, and we can all move the project forward! The Phalcon source code (along with documentation, websites, etc.) is stored in [GitHub][github]. You can browse our repositories on our [organization page][phalcon-org]. If you wish to contribute to Phalcon, you can do so by issuing a [GitHub pull request][github-pr]. :::info[AI Coding Assistants] If you use an AI coding assistant (Claude Code, GitHub Copilot, Cursor, Gemini, etc.) when preparing your contribution, please review the [AI Development][ai-development] page. It describes the quality expectations and the per-commit `Assisted-by:` attribution we require. ::: When you create a pull request, we have a handy template to help you describe what is the scope of the pull request. It is very important and helpful to the community that you add tests to your pull request. Each pull request will be reviewed by a core contributor (someone with permission to merge pull requests). Based on the type and content of the pull request, it could be: * merged immediately or * put on hold, where the reviewer requires changes (styling, tests, etc.) * put on hold, if a discussion is necessary (community, core team etc.) * rejected :::warning[WARNING] If your pull request is a new feature, it is best to discuss it with the core team first, to ensure that it will align with the evolution of the framework. ::: :::danger[DANGER] Please make sure that the target branch that you send your pull request is correct and that you have already rebased your code. Pull requests to the **master** branch are not allowed ::: ## Documentation If programming in Zephir seems daunting, there are plenty of areas that you can contribute. You can always check the documentation for any typographic or context errors. You could also enhance the documentation with more examples on the respective pages. All you have to do is go to our [documentation][phalcon-documentation] repository, fork it, make the changes, and send us a pull request. ## Translations We have removed the translations from v5.5.x onward. There was not that much traffic from the community to help with translating the documentation into different languages. ## Questions and Support :::danger[DANGER] We only accept bug reports, new feature requests and pull requests in GitHub. For questions regarding the usage of the framework or support requests please visit the [official discussions page][phalcon-discussions] or our [Discord][phalcon-discord] server. ::: ## Bug Report Checklist - Make sure you are using the latest released version of Phalcon before creating an issue in GitHub. - Only bugs found in the latest released version of Phalcon will be addressed. - We have a handy template when creating an issue to help you provide as much information for the core team to reproduce and address. Being able to reproduce a bug significantly reduces the time to find the cause and fix it. Scripts of even failing tests are more than appreciated. Please check how to create the [reproducible tests][tests] page for more information. - As part of your report, please include additional information such as the OS, PHP version, Phalcon version, web server, memory, etc. - If you're submitting a [Segmentation Fault][segfault] error, we require a backtrace. Please check the [Generating a Backtrace](#generating-a-backtrace) section for more information. ### Generating a Backtrace Sometimes due to [Segmentation Fault][segfault] error, Phalcon could crash some of your web server processes. In order to help us find the cause of this segmentation fault, we will need the crash backtrace. Please check the following links for instructions on how to generate the backtrace: * [Generating a gdb backtrace][gdb] * [Generating a backtrace, with a compiler, on Win32][gdb-w32] * [Debugging Symbols][symbols] * [Building PHP][building-php] ## Pull Request Checklist - Pull requests to the `master` branch are not accepted. Please fork the repository and create your branch from the necessary "source" branch, for instance, `4.0.x`, and if need be rebase your branch before submitting your pull request. If there are collisions, we will ask you to rebase your branch again. - Add tests to your pull request or adjust existing ones. This is very important since it helps justify your pull request. Please check our [testing][env] page for more information on how to set up a test environment and how to write tests. - Since Phalcon is written in [Zephir][zephir], please do not submit commits that modify the C-generated files directly - Phalcon follows a specific coding style. Please install the `editorconfig` plugin in your favorite IDE to take advantage of the supplied `.editorconfig` file that comes with this repository and not have to worry about coding standards. All tests (PHP code), follow the [PSR-12][psr-12] standard - Remove any change to `ext/kernel`, `*.zep.c`, and `*.zep.h` files before submitting the pull request - More information [here][pr]. Before submitting **new functionality**, please open a [NFR][nfr] as a new issue on GitHub to discuss the impact of including the functionality or changes in the core extension. Once the functionality is approved, make sure your PR contains the following: - An update to the `CHANGELOG.md` - Unit Tests - Documentation or Usage Examples ## Getting Support If you have any questions about how to use Phalcon, please see the [support page][support]. ## Requesting Features If you have any changes or new features in mind, please fill out an [NFR][nfr]. Thanks! <3 Phalcon Team [github]: https://github.com [phalcon-org]: https://github.com/phalcon [github-pr]: https://help.github.com/articles/using-pull-requests/ [phalcon-documentation]: https://github.com/phalcon/documentation [phalcon-discussions]: https://phalcon.io/discussions [phalcon-discord]: https://phalcon.io/discord [tests]: /5.15/reproducible-tests/ [segfault]: https://en.wikipedia.org/wiki/Segmentation_fault [gdb]: https://bugs.php.net/bugs-generating-backtrace.php [gdb-w32]: https://bugs.php.net/bugs-generating-backtrace-win32.php [symbols]: https://github.com/oerdnj/deb.sury.org/wiki/Debugging-symbols [building-php]: https://www.phpinternalsbook.com/build_system/building_php.html [env]: /5.15/testing-environment/ [zephir]: https://zephir-lang.com [psr-12]: https://www.php-fig.org/psr/ [pr]: /5.15/new-pull-request/ [nfr]: /5.15/new-feature-request/ [support]: https://phalcon.io/support [ai-development]: /5.15/ai-development/ Source: https://docs.phalcon.io/5.15/contributions/index.mdx