Thank you for investing your time in contributing to our project! Any contribution you make will help build the best OpenAPI generator for Ktor ✨.
Read our Code of Conduct to keep our community approachable and respectable.
In this guide you will get an overview of the contribution workflow from opening an issue, creating a PR, reviewing, and merging the PR.
Use the table of contents icon in the top left corner of this document to get to a specific section of this guide quickly.
To get an overview of the project, read the README. Here are some resources to help you get started with open source contributions:
- Finding ways to contribute to open source on GitHub
- Set up Git
- GitHub flow
- Collaborating with pull requests
The best way to get started with Kompendium is to read the docs.
If live examples are more your thing, inside the kompendium-playground module, you will find a collection of starter
examples ranging from simple CRUD and authentication examples, to more advanced topics like polymorphic serialization
and custom type overrides.
If you've discovered an issue with Kompendium, or have an idea for a new feature, search if an issue already exists. If a related issue doesn't exist, you can open a new issue using a relevant issue form.
Scan through our existing issues to find one that interests you. As a general rule, issue assignment is informal and not required. If you find an issue to work on, you are welcome to open a PR with a fix.
- Fork the repository.
-
Using GitHub Desktop:
- Getting started with GitHub Desktop will guide you through setting up Desktop.
- Once Desktop is set up, you can use it to fork the repo!
-
Using the command line:
- Fork the repo so that you can make your changes without affecting the original project until you're ready to merge them.
-
GitHub Codespaces:
- Fork, edit, and preview using GitHub Codespaces without having to install and run the project locally.
-
Install Java. Any version of Java 11+ should be fine.
-
Create a working branch and start with your changes!
Commit the changes once you are happy with them. Git hooks are automatically installed via Gradle that will run the linter
on every commit, and run the tests prior to pushing your code. This helps speed up the review cycle immensely. If you would like
to push a draft PR that skips the hooks, you can simply add the --no-verify flag, ie git commit --no-verify -m "commit message".
When you're finished with the changes, you are ready to create a pull request! There is no hard and fast rules here, but do your best to fill out the pull request template with all the requisite information!
Congratulations 🎉🎉 The Kompendium team thanks you ✨.
Once your PR is merged, it will go out in the next release cycle. We often keep these cycles super tight, it is not uncommon for each PR to get its own release.