forked from nhs-r-community/nhs-r-community
-
Notifications
You must be signed in to change notification settings - Fork 0
/
get-involved.qmd
168 lines (111 loc) · 8.79 KB
/
get-involved.qmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
---
title: "Get Involved"
sidebar: false
page-layout: article
toc: false
title-block-banner: false
---
## Get involved with NHS-R Community
We welcome contributions to our activities which range in experience of technical knowledge.
## No coding necessary
### Corrections, comments or suggestions {#contact}
Commenting on Quarto books is possible through either logging in using Giscus which requires a GitHub account and details and pointers on setting up an account are in our slides for the [Introduction to Git and GitHub using R](https://intro-git-github.nhsrcommunity.com/session-prework.html#/github) or from Hypothes.is which can be seen as a pop out in the top right of every page of a book.
Comments and suggestions can be shared with NHS-R Community in [Slack](https://nhsrcommunity.slack.com/).
Slack is also a great place to let others know about projects or events you want to promote or think are of interest.
We will also welcome comments through email at [[email protected]](https://nhsrcommunity.slack.com/).
### Blogs
We'd love to receive blogs for the website and these can be emailed to [[email protected]](https://nhsrcommunity.slack.com/).
If you want to submit the blog as a Quarto document and directly to the repository we'd love to receive a pull request from you.
If you are new to using Quarto or GitHub and need any help at all with this please do let us know as this can be a great first step into open coding.
### Contributing to the website
:::{.callout-tip collapse=false appearance='default' icon=true}
## Pre-work (tip)
Before the instructions on what to do to contribute make sure you have git installed on your computer and a GitHub account.
Details on how to get set up can be found in the [Introduction to Git and GitHub using R course](https://intro-git-github.nhsrcommunity.com/session-setup.html#/title-slide).
:::
The first step to contributing is to `clone` the site to your own GitHub account.
As with many programs and coding there are numerous ways to do this but one nice way in R is to use the package {usethis}.
Details on how to use the package to clone or fork (depending on your access rights) is detailed in the [Introduction to Git and GitHub](https://intro-git-github.nhsrcommunity.com/session-fork-clone.html#/existing-repositories) course materials.
From your own repository you should create a new branch.
Again, using {usethis} you can follow the steps from the course <https://intro-git-github.nhsrcommunity.com/session-usethis-gert.html#/start-new-work> and then create a [pull request](https://intro-git-github.nhsrcommunity.com/session-pull-requests.html#/pushing-to-the-remote-github).
:::{.callout-tip collapse=false appearance='default' icon=true}
## PR to which repository? (tip)
By following these instructions you will have created a new branch in your repository so the PR (pull request) will go automatically to your own repository's `main` branch.
You can either complete this which updates your `main` or redirect the PR in GitHub to the original NHS-R Community repository which will be possible as the two are linked.
:::
### Blog submissions
If you are writing a blog and are submitting this through a Pull Request in GitHub, please save a `.qmd` file into the folder called `blog` and any images you've used in the `img` subfolder.
Also ensure that all images used have suitable [alternative text as good practice](https://design102.blog.gov.uk/2022/01/14/whats-the-alternative-how-to-write-good-alt-text/) and this will need to be a short description of the image.
The format for the header part of the `.qmd` YAML template is often set out like this:
```
---
title: "Your title here"
date: "17 October 2022"
date-modified: "27 July 2024"
categories:
- Something
- Something Else
author: Your name
image: img/picture.jpg
image-alt: "Please add a short description"
subtitle: >
"Please add a short description of the blog if you'd like or remove this text"
---
```
The default for all blogs' YAML is:
```
execute:
`eval: true
echo: true
```
so is not necessary in the blogs themselves.
However, if you wish to change the default so the blog, for example, shows code but does not run it then the YAML needs the following added to the individual blog `.qmd` YAML:
```
execute:
eval: false
```
More details on the [excution options](https://quarto.org/docs/computations/execution-options.html) are available from the Quarto documentation website.
### Website creation
You only need to submit the `.qmd` file and any images as the repository will recreate the book online using GitHub Actions once the Pull Request has been accepted.
However, you can still view the website locally to see if everything works by running the R code with the {quarto} package loaded:
```{r}
#| eval: false
quarto::quarto_render()
```
:::{.callout-warning collapse=false appearance='default' icon=true}
## Building the website localled (warning)
Viewing the blog locally can take time as it builds several pages for the website and will create other files like `.html` as well as update the `site_libs` folder files.
When submitting an Pull Request none of these newly generated files are required.
:::
### YouTube
We have nearly 200 videos on YouTube and although subtitles are automatically added by YouTube these require tidying so if you want to watch and correct text as you go along we'd welcome your help to improve the videos and make them more accessible.
We use Clipchamp which is a free video editing program provided by Microsoft.
Videos may also benefit from video chapters being added and notes on where to find resources that are referred to in the video.
Sometimes people add these into the comments and that's very welcome!
### Podcasts
We have podcasts on Soundcloud and although these have been mostly hosted by Chris Beeley, can be hosted by anyone.
These are also being copied to YouTube so that subtitles can be added and, like the videos, often need corrections.
### NHS-R Community Committee
The NHS-R Community Committee meets regularly and details of what the Committee do and how to get involved is in our [NHS-Way book](https://nhsrway.nhsrcommunity.com/nhsr-committee.html).
### Coffee and Coding
We have a regular [coffee and coding](https://nhsrway.nhsrcommunity.com/community-handbook.html#coffee-and-coding) meeting where you can bring a question, some code you need help with or just come along to hear how about others' work.
## Practising coding
No matter where you are in your journey learning open source coding tools NHS-R Community welcomes contributions to the [GitHub repostories](https://github.com/nhs-r-community) where we have Quarto books, a website, R packages and training materials.
This is an area for practising techniques as we don't hold sensitive data.
Projects across our account use R, git, GitHub actions, [Docker](https://github.com/nhs-r-community/r_gh_actions), [R universe](https://github.com/nhs-r-community/nhs-r-community.r-universe.dev).
No project is "finished" and improvements can always be suggested, Pull Requests made and direct access given (where appropriate and agreed).
### Finding good first issues
GitHub has the facility to label or "tag" issues and this can help with searching for suitable open issues to work on or contribute to in the conversation.
We use various labels on NHS-R GitHub repositories and to get started:
[help wanted](https://github.com/search?q=org%3Anhs-r-community+is%3Aissue+is%3Aopen+label%3A%22help+wanted%22&type=issues)
[good first issue](https://github.com/search?q=org%3Anhs-r-community+is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22&type=issues)
[documentation](https://github.com/search?q=org%3Anhs-r-community+is%3Aissue+is%3Aopen+label%3A%22documentation%22&type=issues)
### Tidying repositories
Standardisation of projects has started with READMEs with templates for text in the [NHS-R Way](https://nhsrway.nhsrcommunity.com/style-guides.html#readmes-in-repositories) and shared resources like logos kept in an [asset](https://github.com/nhs-r-community/assets) repository.
Further tidying will be needed with licences, protection of main branches and [recognising all contributors](https://github.com/all-contributors/all-contributors).
### New projects
We have many repositories and ongoing projects but if you have a project you'd like to start or share with us we are happy to host these too.
We just ask that anything that is passed to our repository is open under the MIT or CC0 [licences](https://nhsrway.nhsrcommunity.com/style-guides.html#licences-to-use) and if you've used something else to just get in touch about it.
## Teaching and sharing
NHS-R Community hosts very popular, free, [workshops and webinars](https://nhsrway.nhsrcommunity.com/community-handbook.html) throughout the year.
All our materials are free to use, copy and change and we publish all our [joining instructions](https://nhsrway.nhsrcommunity.com/training.html).