Skip to content

Latest commit

 

History

History
30 lines (21 loc) · 1.61 KB

CONTRIBUTING.md

File metadata and controls

30 lines (21 loc) · 1.61 KB
Raw

Contributing to KVision

👍🎉 Thanks for taking the time to contribute! 🎉👍

How to contribute

  • Use KVision in your applications to test the framework 😄
  • Report bugs or feature requests by creating GitHub issues.
  • Fix existing bugs.
  • Implement new features and modules.

How to develop KVision

  1. You need JDK 8 or later installed on your system.
  2. Clone the code repository (create a fork if you want to make pull requests with your changes).
  3. Change the version number at the bottom of kvision-tools/kvision-gradle-plugin/src/main/kotlin/pl/treksoft/kvision/gradle/KVisionGradleSubplugin.kt file to the current version number with a -SNAPSHOT suffix.
  4. Make your changes to KVision code.
  5. Run tests with ./gradlew check command to check if everything is OK.
  6. Compile and publish artifacts to your local Maven repository with ./gradlew publishToMavenLocal -PSNAPSHOT=true command. It will automatically publish a *-SNAPSHOT version.
  7. Use your snapshot of KVision by specifying the correct version number in your application (in gradle.properties file). Remember to clean your project every time you publish new version of the framework.

How to create new module

  1. Copy one of exising module directories with new name (choose the module most similar to the one you create).
  2. Add new module name to the list in the settings.gradle.kts file and to the dokka task in the build.gradle.kts file.
  3. Remove copied code and start writing your own.

Where to get help

Ask questions on Kotlin Slack KVision channel.