Skip to content

Latest commit

 

History

History
54 lines (36 loc) · 2.57 KB

CONTRIBUTING.md

File metadata and controls

54 lines (36 loc) · 2.57 KB
Raw

Welcome

This application is still in a pre-release state. That means it's very open to contributions, and we'd love to have your help!

It also means that things are changing quickly, and lots of stuff is planned that's not quite done yet. If you would like to work on TaskChampion, please contact the developers (via the issue tracker) before spending a lot of time working on a pull request. Doing so may save you some wasted time and frustration!

A good starting point might be one of the issues tagged with "good first issue".

Other Ways To Help

The best way to help this project to grow is to help spread awareness of it. Tell your friends, post to social media, blog about it -- whatever works best!

Other ideas;

  • Improve the documentation where it's unclear or lacking some information
  • Build and maintain tools that integrate with TaskChampion

Development Guide

TaskChampion is a typical Rust application. To work on TaskChampion, you'll need to install the latest version of Rust.

Running Tests

It's always a good idea to make sure tests run before you start hacking on a project. Run cargo test from the top-level of this repository to run the tests.

Read the Source

Aside from that, start reading the docs and the source to learn more! The book documentation explains lots of the concepts in the design of TaskChampion. It is linked from the README.

There are three important crates in this repository. You may be able to limit the scope of what you need to understand to just one crate.

  • taskchampion is the core functionality of the application, implemented as a library
  • taskchampion-lib implements a C API for taskchampion, used by Taskwarrior
  • integration-tests contains some tests for integrations between multiple crates.

You can generate the documentation for the taskchampion crate with cargo doc --release --open -p taskchampion.

Making a Pull Request

We expect contributors to follow the GitHub Flow. Aside from that, we have no particular requirements on pull requests. Make your patch, double-check that it's complete (tests? docs? documentation comments?), and make a new pull request.

If your pull request makes a breaking change, then Cargo Semver Checks check may fail. If this change is intentional, update the version accordingly in taskchampion/Cargo.toml (maintaining the -pre suffix), and the check should succeed.