Thank you for your interest in contributing to Dokkatoo! We appreciate your help in making this project better.
To get started with local development, follow these steps:
- Clone the repository:
git clone https://github.com/adamko-dev/dokkatoo.git
- Navigate to the project directory:
cd dokkatoo - Build the project:
./gradlew build
Here are some additional helpful commands:
- Run tests:
./gradlew check
- Publish the project to a project-local directory, to verify publication works:
./gradlew publishToTestMavenRepo
- Update the
Binary Compatibility Validator
API dump:
./gradlew apiDump
When adding new features, it's generally recommended to create an issue first before starting any work. This allows for better discussion and alignment with the project's goals. Creating an issue can help clarify the purpose and prevent duplicate work.
In some cases, making a PR first can be helpful to demonstrate the desired result and initiate a discussions. Try to keep the PR small and focused.
If you decide to work on an existing issue, please comment on the issue to let others know that you are taking it up. This will avoid unnecessary duplication of effort.
We have the following guidelines for writing code:
-
The code style follows the official Kotlin Coding conventions, with a few differences.
The most significant difference is that the indent is 2 spaces, not 4.
The code style is committed in IntelliJ format the repo, in the directory .idea/codeStyles.
-
Follow the Library creators' guidelines
-
ABI changes are tracked using Binary Compatibility Validator.
-
Ideally all changes should have automated test coverage.
Each commit should have a clear and descriptive commit message.
When submitting a pull request, please follow these guidelines:
- Each PR should have a clear title and description (bullet points are preferred) explaining the purpose of the changes.
- Include the issue number(s) related to the PR, if applicable.
PRs will be squashed into a single commit before merging. This will allow us to maintain a clean commit history.
Thank you for your contribution!