Skip to content

Latest commit

 

History

History
86 lines (59 loc) · 3.19 KB

CONTRIBUTING.md

File metadata and controls

86 lines (59 loc) · 3.19 KB

Contribution Guidelines

You want to help contribute? Awesome! Thanks for taking the time to look at the guidelines for this repo. Here's what you need to know!

License

smartsheet-rs is proudly licenced under the MIT license, and so are all contributions. Please see the LICENSE file in this directory for more details.

Pull Requests

To make changes to smartsheet-rs, please send in pull requests on GitHub to the main branch. I'll review them and either merge or request changes. GitHub Actions tests everything as well, so you may get feedback from it too.

If you make additions or other changes to a pull request, feel free to either amend previous commits or only add new ones, however you prefer. I may ask you to squash your commits before merging, depending.

Issue Tracker

You can find the issue tracker on GitHub. If you've found a problem with smartsheet-rs, please open an issue there.

Development workflow

Check out the README.md under the examples/ folder for details on the development process.

Examples

Do you want to help show off some ways for how the library works? Feel free to work on an example and open up a PR!

To run the tests:

$ cargo test

Code

If you want to contribute code but don't know how everything works check out the source code in the library; specifically check out the api.rs which contains the client implementation logic. If you want to know what endpoints still need to be implemented see the endpoints docs.

Due to the use of certain features smartsheet-rs requires rustc version 1.18 or higher.

To run tests, you will need an access token from Smartsheet. You can follow the official Smartsheet documentation to get a personal access token for testing.

Once you have an access token, set the SMARTSHEET_ACCESS_TOKEN env variable and work on creating an example under the examples folder.

Finally, run cargo test to make sure all the tests pass.

Documentation

As with any project, documentation is a key part that can make or break usage of a library. Why use the best library ever if it has no documentation?

With that in mind, smartsheet-rs strives to document every aspect of it in order to make it easier for the user. In particular, it would be a great help to write out clear documentation and - for example - annotate the parameters and their sample usage for each newly implemented function or method.