# How to Contribute

## Common Scenarios

### Did you find a bug?

* **Do not open up a GitHub issue if the bug is a security vulnerability**. Instead, send a direct email to me@hildeberto.com.

* **Ensure the bug was not already reported** by searching on GitHub under [Issues](https://github.com/htmfilho/csvsource/issues).

* If you're unable to find an open issue addressing the problem, [open a new one](https://github.com/htmfilho/csvsource/issues/new). Be sure to include a **title and clear description**, as much relevant information as possible, and a **code sample** or an **executable test case** demonstrating the expected behavior that is not occurring.

* If possible, use the relevant bug report templates to create the issue.

### Did you write a patch that fixes a bug?

* Open a new GitHub pull request with the patch.

* Ensure the PR description clearly describes the problem and solution. Include the relevant issue number if applicable.

### Do you intend to add a new feature or change an existing one?

* Suggest your change in an enhancement issue. When you have a green light from the community, go ahead and start writing code.

### Do you have questions about the source code?

* Ask any question about how to use SpitFHIR by creating an issue and tag it with "question".

### Do you want to contribute to the Rails documentation?

If you tried to proceed according to the documentation and something didn't go as expected, please suggest improvements in the documentation to cover your particular use case.

## Commonly Used Cargo Commands

### Documentation

To generate documentation:

    $ cargo doc

To see the documentation:

    $ cargo doc --open

### Run

    $ cargo run -- --csv examples/waterloo_tree_inventory.csv

### Build

    $ cargo build

### Release Build

Targeting the current operating system:

    $ cargo build --release

Targeting other operating systems:

    $ cargo build --target=x86_64-pc-windows-gnu

Installing to run locally, by adding the command to the classpath:

    $ cargo install --path .