Contributions of any kind are welcome.
Feel free to submit Github Issues or pull requests.
The documentation site has some details about internals.
-
Fork the repo.
-
Checkout the branch you want to make changes on.
- Typically, this will be
master. Note that most of the time,masterrepresents the next release of swagger-php, so Pull Requests that break backwards compatibility might be postponed.
- Typically, this will be
-
Install dependencies:
composer install. -
Create a new branch, e.g.
feature-fooorbugfix-bar. -
Make changes.
-
If you are adding functionality or fixing a bug - add a test!
Prefer adding new test cases over modifying existing ones.
-
Update documentation:
composer docs:gen. -
Run static analysis using PHPStan/Psalm:
composer analyse. -
Check if tests pass:
composer test. -
Fix code style issues:
composer cs.
The documentation website is build from the docs folder with vitepress.
This process involves converting the existing markdown (.md) files into static HTML pages and publishing them.
Some reference content is based on the existing code, so changes to annotations, attributes and processors will require to re-generate those markdown files: composer docs:gen.
The actual published content is managed in the gh-pages branch and driven by a publish action.
composer testcomposer analyse./bin/phpunitcomposer docs:gencomposer lintcomposer cscomposer docs:dev