Updating the documentation
OpenSAFELY is a rapidly changing platform and the user documentation should be updated frequently to keep pace. If you are an OpenSAFELY user and want to contribute corrections, clarifications, or new materials to the documentation, please do! You can either:
- Suggest improvements in an issue.
- Clone the repo locally, make edits on a new branch, then create a pull request for it.
- Edit directly on GitHub (instructions), making sure to "Create a new branch for this commit and start a pull request".
Do not commit changes directly to the main branch.
When adding or revising text, use Semantic Line Breaks rather than fixed length lines. With semantic line breaks, the diff is more concise and easier to interpret than with fixed length lines, where a single change can propagate through a whole paragraph.
Making changes to the study definition variables🔗
Edit the docstrings in the
patients.py file in the
Variable docstrings follow the Google style guide.
If you don't have write access, you can fork the cohort-extractor repo, make a change, and submit a pull request.
Editing directly in GitHub will take you through these steps automatically.
At least one commit in the pull request should be named using the prefix
feature:. For example
fix: typo in age_as_of docstring.
This ensures that a new version of
cohortextractor is released and can be imported by the documentation via GitHub actions.
Then add a reference to your new variable in the variables page.
file in the documentation
repo itself has to be
updated to match the new incremented version of
the documentation repository's
that details the use of
pip-compile for this.