Skip to content

Latest commit

 

History

History
41 lines (24 loc) · 4.46 KB

CONTRIBUTING.md

File metadata and controls

41 lines (24 loc) · 4.46 KB

Contributing to Canvas Medical

✨ First off, thanks for taking the time to contribute! ✨

We do not intend to make representations or warranties regarding workflow experiences. We understand that each practice may have individual requirements for their Canvas instance and supporting apps. We want to empower external developers to customize and share their unique solutions to individualize their Canvas experience.

Code of Conduct

The Canvas Medical Code of Conduct governs this project and everyone participating. By participating, you are expected to uphold this code.

You understand that these Contributing Guidelines, our Code of Conduct, and any license terms that we provide with open source materials (collectively “Open Source Terms”), are specific to the materials available through the Canvas Medical Open Source Project only. Under no circumstances will any of the Open Source Terms apply to Canvas Medical’s products and services generally. Unless materials are specifically identified as “Open Source”, materials available through the Canvas Medical website are subject to our general Terms of Use or our License Agreement.

Please never include any PHI when submitting examples. Revealing PHI would directly violate our Code of Conduct and would result in your dismissal from the project. If you find any security vulnerabilities relating to PHI or encounter unacceptable behavior, please report them directly to community-engagement@canvasmedical.com rather than opening a new issue.

What should I know before I get started?

Canvas Medical open source is designed to support developers customizing their Canvas instances. If you do not have a sandbox account, consider signing up and going through the getting started documentation. Or, if you want more information on what Canvas can offer you and your team, contact us.

You understand that by contributing work to the Canvas Medical Open Source project (“Contributions”), those Contributions become a part of the Canvas Medical Open Source project, and that we may use your Contributions without limitation, including to modify or improve Canvas Medical’s existing products or services, or to create new products or services. If we choose to incorporate any of your Contributions into Canvas Medical’s products or services, you understand that you will have no rights to those new or improved products or services, and that in no way are we required to relicense products or services into which we incorporate Contributions on any Open Source Terms.

How Can I Contribute?

There are many ways to contribute, from writing tutorials or blog posts, improving the documentation, submitting workflow and feature requests, or writing code that can be incorporated into this open source branch of Canvas Medical.

Please, don't use the issue tracker for support questions. Please check existing Issues, Pull requests, and Projects before submitting a new Issue or PR.

We want to encourage users to do the following to share their unique protocol and workflow solutions:

  • Create your own fork of the code.
  • Do the changes in your fork.
  • If you like the change and think the project could use it:
    • Be sure you have followed the code style for the project.
    • Be sure to review the Code of Conduct.
    • Send a pull request indicating that you have read and acknowledged the Code of Conduct. Please be sure to use the PR template provided. We also request that your code be well tested. All existing and new tests must pass before requesting review.

If you would like to submit a workflow or feature request as an issue, please use the Issue template provided.

Before Submitting An Workflow/Feature Suggestion

  • Check the Canvas Medical docs for tips — you might discover what you are looking for.
  • Perform a cursory search to see if the issue has already been suggested. If it has, add a comment to the existing issue instead of opening a new one.