Skip to content
This repository has been archived by the owner on Sep 9, 2024. It is now read-only.

Latest commit

 

History

History
58 lines (33 loc) · 2.11 KB

CONTRIBUTING.md

File metadata and controls

58 lines (33 loc) · 2.11 KB

Contributing to TokenCoreX

TokenCoreX welcomes contribution from everyone. Here are the show some ways you can help to build TokenCoreX :

Report Bug

While bugs are unfortunate, they're a reality in software. We can't fix what we don't know about, so please report liberally. If you're not sure if something is a bug or not, feel free to file a bug anyway.

<short summary of the bug>

I tried this code:

<code sample that causes the bug>

I expected to see this happen: <explanation>

Instead, this happened: <explanation>

## Meta

`rustc --version --verbose`:

Backtrace:

Submit Pull Request

Pull requests are the major way to contribute an OpenSource project. Github has a detailed explanation about Pull Request.

Code Style

We expect run cargo fmt before code commit. Follow rust community code style guide.

CI server already setup to check style on CI build. We recommend you turn on code auto format for you IDE or editor plugin, follow this rustfmt document.

CI

Code submitted must pass all unit tests and static analysis ("lint") checks. We use Travis CI to test code on Linux, macOS.

For failing CI builds, the issue may not be related to the PR itself. Such failures are usually related to flaky tests. These failures can be ignored (authors don't need to fix unrelated issues), but please file a GH issue so the test gets fixed eventually.

Commit Message

We follow a rough convention for commit message writing.

First line is the subject line, in around 50 characters or less to describe what changed. And the body of the commit should describe why changed.

Template:

Changes in around 50 charactors or less

Longer explanation of the change in the commit. You can use
multiple sentences here. It's usually best to include content
from the PR description in the final commit message.

issue notices, e.g. "Fixes #42, Resolve #123, See also #456".