We welcome contributions in the form of issues or pull requests. We recommend starting with an issue to have a conversation before changing any files.
Help us keep the Patient Data Use Agreement open and inclusive. Please read and follow our Code of Conduct.
- Ensure the issue was not already reported by searching on GitHub under Issues.
- If you're unable to find an open issue addressing the problem, open a new issue and label it 'bug'. Be sure to include a title and clear description, as much relevant information as possible, and a text sample or an executable test case demonstrating the expected behavior that is not occurring.
- Suggest your change as a new issue and label it 'feature request' before writing any text.
- The team will review your new feature and respond within 24 business hours.
- No pull request is too small: fix typos, add comments, clean up inconsistent whitespace.
- Ensure the pull request description clearly describes the problem and solution. Include the relevant issue number if applicable.
- The team will review your pull request and respond within 24 business hours.
First, make sure you're logged in with your Github account. When you have a change you wish to make, simply find the version of the document that you wish to change. Open it and press the Edit button.
On the edit page, you'll be presented with a version of the document. Edit the text you wish to change. When you are done editing, there will be a section at the bottom of the page to save your work. Under "Commit summary", enter a brief description of the change(s) you're making. In the "Extended description" field, explain what the changes are and why they're needed. Select the "Create a new branch for this commit..." option. When you're done, commit your changes.
At this point, you'll be presented with a form to submit a pull request. The bottom section of the page will show all of the changes you've made to the document, and all you should need to do is press the "Send Pull Request" button.
Once you've submitted a pull request, the PDUA team can review the work under the Pull Requests tab on the right-hand side, and a contributor to the repo can merge your changes.
These files are written in the Markdown syntax. You can reference this guide for formatting (ex. Bold, Footnotes, Lists, Links).