Contributing

How can I help?

Fork the repository, make your change and submit a pull request. If you would like to discuss the changes you intend to make to clarify where or how they should be implemented, please don't hesitate to create a new issue. At a minimum, you may want to read the following documentation:

When changes impact multiple repositories

While this can be tricky, we've tried to reduce how often this situation crops up this with our recent switch to a monorepo. Our maintained extensions, ui components, internationalization library, and business logic can all be developed by simply running yarn run dev from the repository root.

Testing the viewer with locally developed, unpublished package changes from a package outside of the monorepo is most common with extension development. Let's demonstrate how to accomplish this with two commonly forked extension dependencies:

`cornerstone-tools`

On your local file system:

# code/my-projects/
.
├── cornerstonejs/cornerstone-tools
└── ohif/viewers

Open a terminal/shell
Navigate to cornerstonejs/cornerstone-tools
- npm install
- yarn link
- npm run dev
Navigate to ohif/viewers.
- yarn install
- yarn link cornerstone-tools
- yarn run dev

For example if you are working on ohif-core and would like to use your local version to debug a problem in Viewers, simply run yarn link inside of the ohif-core project.

If you're experiencing issues with yarn link, try yalc

Any guidance on submitting changes?

While we do appreciate code contributions, triaging and integrating contributed code changes can be very time consuming. Please consider the following tips when working on your pull requests:

Functionality is appropriate for the repository. Consider creating a GitHub issue to discuss your suggested changes.
The scope of the pull request is not too large. Please consider separate pull requests for each feature as big pull requests are very time consuming to understand.

We will provide feedback on your pull requests as soon as possible. Following the tips above will help ensure your changes are reviewed.

Testing contribution pull requests

OHIF uses netlify so that pull requests are autogenerated and available for testing.

For example, this url allows you to test pull request 237, the request that created this FAQ entry, using data pulled from Amazon S3.

Replacing the number 237 in the link below with your pull request number should let you test it as well and you can use this link for discussions on github without requiring reviewers to download and build your branch.

https://deploy-preview-237--ohif.netlify.com/viewer/?url=https://s3.eu-central-1.amazonaws.com/ohif-viewer/sampleDICOM.json

If you have made a documentation change, a link like this will let you preview the gitbook generated by the pull request:

https://deploy-preview-237--ohif.netlify.com/contributing.html

3.5 KiB Raw Blame History