|
21 | 21 | "source": [ |
22 | 22 | "## Why Contribute?\n", |
23 | 23 | "\n", |
24 | | - "The Coding for Reproducible Research (CfRR) training initiative has been a collaborative effort since the program's start; as such, we are always interested in collaborating with anyone who wants to help expand the available resources. By contributing, you can add to the existing content, help others, and potentially practice skills you have developed through CfRR training programs such as Introduction to Version Control With Git and GitHub!\n", |
| 24 | + "The Coding for Reproducible Research (CfRR) training initiative has been a collaborative effort since the programme's start; as such, we are always interested in collaborating with anyone who wants to help expand the available resources. By contributing, you can add to the existing content, help others, and potentially practice skills you have developed through CfRR training programs.\n", |
25 | 25 | "\n", |
26 | 26 | "\n", |
27 | 27 | "## How Do I Contribute?\n", |
28 | 28 | "\n", |
29 | | - "There are a range of different ways for you to engage with the CfRR training program depending on the skillset you currently have, and the skillset you want to develop. There are three key ways in which you can engage with the CfRR training program, including **(1)** becoming a helper within workshops and helping to deliver training workshops to individual across the university, **(2)** identify and highlight issues with the current material on the website, or **(3)** create and contribute your own course to the CfRR program. Each of these different methods of contributing to the program are discussed in more depth below. \n", |
| 29 | + "There are a range of different ways for you to engage with the CfRR training programme depending on the skillset you currently have, and the skillset you want to develop. There are three key ways in which you can engage with the CfRR training program, including **(1)** becoming a helper within workshops and helping to deliver training workshops to individuals across the university, **(2)** identify and highlight issues with the current material on the website, or **(3)** create and contribute your own course to the CfRR program. Each of these different methods of contributing to the programme are discussed in more depth below. \n", |
30 | 30 | "\n", |
31 | 31 | "### Become a helper \n", |
32 | 32 | "\n", |
33 | | - "When the CfRR delivers a workshop, the general format that is followed is to have a course leader who is responsible for delivering the content itself, in the form of being the individual who stands at the front of the workshop and talks through the content, conducting the live programming examples and providing overall management for the workshop. Alongside the course leader, we have several course helpers who answer any questions during the workshop, ensuring that no one who attends the workshop gets left behind. If you have experience in some of the offered content and would be interested in becoming a course helper, please get in touch with the team at our email address below. To help us manage the emails better, we would be grateful if you could start the email subject as 'EOI Course Helper: {Course Name} {Your Name}\".\n", |
| 33 | + "When the CfRR delivers a workshop, the general format that is followed is to have a course leader who is responsible for delivering the content itself, in the form of being the individual who stands at the front of the workshop and talks through the content, conducting the live programming examples and providing overall management for the workshop. Alongside the course leader, we have several course helpers who answer any questions during the workshop, ensuring that no one who attends the workshop gets left behind. \n", |
34 | 34 | "\n", |
35 | | - "CfRR Email Address: [email protected]\n", |
| 35 | + "If you have experience in some of the offered content and would be interested in becoming a course helper, please get in touch with the team at our email address: [email protected] or fill out the form [here](https://forms.office.com/Pages/ResponsePage.aspx?id=d10qkZj77k6vMhM02PBKU-3R4SvRoClNrKjEX5qG1X1UNkhISjdLVVpOQk83QldVSVdVUzZQSUEyRy4u).\n", |
36 | 36 | "\n", |
37 | 37 | "### Highlighting Issues\n", |
38 | 38 | "\n", |
39 | | - "If you would like to contribute to the program but don't have the time to become a helper or develop course content. Auditing the course content is an excellent way to refresh your understanding of content and help improve the CfRR program. While due care is taken to ensure that the program's material is accurate and up to date, mistakes do happen, and some of the content on the website may be incorrect. It might also be the case that you think there is a better way to explain a concept or add additional context to part of a course. We want to make the CfRR content the best possible, so it's better to raise it and verify even if you are unsure if the content needs changing. We are a very friendly bunch, so we are more than happy to have feedback on the program. \n", |
| 39 | + "If you would like to contribute to the programme but don't have the time to become a helper or develop course content, auditing the course materials is an excellent way to refresh your understanding of content and help improve the CfRR program. While due care is taken to ensure that the programme's material is accurate and up to date, mistakes do happen, and some of the content on the website may be incorrect. It might also be the case that you think there is a better way to explain a concept or add additional context to part of a course. We want to make the CfRR content the best possible, so it's better to raise any queries and verify the materials, even if you are unsure if the content needs changing. We are a very friendly bunch, so we are more than happy to have feedback on the programme. \n", |
40 | 40 | "\n", |
41 | 41 | "#### Types of Issue\n", |
42 | 42 | "\n", |
|
47 | 47 | "3. **Content Clarity and Comprehension**: Ambiguous statements, poorly explained concepts, jargon not explained etc.\n", |
48 | 48 | "4. **Formatting and Layout Issues**: Inconsistent font usage, poor image quality, mismatched or misaligned elements etc.\n", |
49 | 49 | "5. **Technical Errors**: Broken links, non-functional interactive elements, issues with embedded media, accessibility issues (e.g. lack of alt text for images) etc.\n", |
50 | | - "6. **Cultural and Bias Concerns**: Content that may be culturally insensitive or offensive, gender or racial biases, steoetyping, lack of inclusivity etc.\n", |
51 | | - "7. **Outdated Content**: Information not reflecting the latest research or developments, old statistics or data, References to outdated technologies or practices etc.\n", |
52 | | - "8. **Logical Fallacies or Reasoning Errors**: Oversimplification, Hasty generalizations, Contradictions or inconsistencies in content etc.\n", |
| 50 | + "6. **Cultural and Bias Concerns**: Content that may be culturally insensitive or offensive, gender or racial biases, stereotyping, lack of inclusivity etc.\n", |
| 51 | + "7. **Outdated Content**: Information not reflecting the latest research or developments, old statistics or data, references to outdated technologies or practices etc.\n", |
| 52 | + "8. **Logical Fallacies or Reasoning Errors**: Oversimplification, hasty generalizations, contradictions or inconsistencies in content etc.\n", |
53 | 53 | "\n", |
54 | 54 | "The above list is meant to provide some examples, but is not meant to be exhaustive. If you find an issue that is not on the list please do still raise it, and we can add that type of issue to the list!\n", |
55 | 55 | "\n", |
56 | | - "#### Creating an GitHub Issue\n", |
| 56 | + "#### Creating a GitHub Issue\n", |
57 | 57 | "\n", |
58 | | - "If while going through the content of the website you notice that there is an error then the way in which to let us know is to raise a GitHub Issue. You are able to do this easily from the website, simply click the Github Icon in the top right of the page where the issue is, and click `Open Issue`, as shown below. \n", |
| 58 | + "If while going through the content of the website you notice that there is an error, the way to let us know is to raise a GitHub Issue. You are able to do this easily from the website - simply click the GitHub Icon in the top right of the page where the issue is, and click `Open Issue`, as shown below. \n", |
59 | 59 | "\n", |
60 | | - "##### Github Issue Button\n", |
| 60 | + "##### GitHub Issue Button\n", |
61 | 61 | "\n", |
62 | 62 | "```{figure} images/github_issue_button.png\n", |
63 | 63 | ":alt: Example GitHub Issue Button on the CfRR Website\n", |
|
68 | 68 | "Example Github Issue Button on the CfRR Website\n", |
69 | 69 | "```\n", |
70 | 70 | "\n", |
71 | | - "Once you have clicked the button a new tab will open taking you into a ready made GitHub Issue form that you can then add content to explain the issue in more depth. The button will automatically populate the title with page that the issue is on, please leave that in the title as it makes it easier for whoever fixes the issue to find the issue being discussed. \n", |
| 71 | + "Once you have clicked the button, a new tab will open taking you into a ready-made GitHub Issue form that you can then add content to explain the issue in more depth. The button will automatically populate the title with the page that the issue is on - please leave that in the title as it makes it easier for whoever fixes the issue to find the issue being discussed. \n", |
72 | 72 | "\n", |
73 | | - "The two primary elements that are needed to raise a Github Issue are:\n", |
| 73 | + "The two primary elements that are needed to raise a GitHub Issue are:\n", |
74 | 74 | "- **Title**: The title should briefly cover what the issue with the website content is.\n", |
75 | 75 | "- **Main Body**: The main body of the issue should provide enough context so that anyone can understand the issue and contribute the fix to the problem.\n", |
76 | 76 | "\n", |
77 | | - "Alongside the two main elements if desired it is also possible for you to include a label for the issue that will help contributors to know what sort of issue is being raised and assign it to the correct indiivudal, however this can be done by the central CfRR team and so feel free to leave it blank for now. \n", |
| 77 | + "Alongside the two main elements, if desired, it is also possible for you to include a label for the issue that will help contributors to know what sort of issue is being raised and assign it to the correct individual. However, this can be done by the central CfRR team so feel free to leave it blank. \n", |
78 | 78 | "\n", |
79 | 79 | "Once you are happy with the content of the issue, then click `Submit new issue`.\n", |
80 | 80 | "\n", |
81 | | - "At this stage the issue wil then be added to the GitHub repository and the central CfRR team will be able to see the issue, triage it and put into motion the needed elements to fix the issue. \n", |
| 81 | + "At this stage the issue will then be added to the GitHub repository and the central CfRR team will be able to see the issue, triage it and put into motion the needed elements to fix the issue. \n", |
82 | 82 | "\n", |
83 | | - "As an example issue, we raised the problem that when discussing the process of highlighting issues in this exact webpage, no example issues were given, which could be confusing for individual who have never audited educational material before. As such we raised the issue and then a subsequent fix could be implemented, in this case added example to the webpage. A screenshot of the webpage with the implemented solution can be seen below, with the link to the webpage of the now closed issue can be found here: [Highlight Issues Example Issue](https://github.com/coding-for-reproducible-research/CfRR_Courses/issues/22)\n", |
| 83 | + "As an example issue, we raised the problem that when discussing the process of highlighting issues in this exact webpage, no example issues were given, which could be confusing for an individual who had never audited educational material before. As such, we raised the issue and then a subsequent fix could be implemented, in this case we added an example to the webpage. A screenshot of the webpage with the implemented solution can be seen below, with the link to the webpage of the now closed issue which can be found here: [Highlight Issues Example Issue](https://github.com/coding-for-reproducible-research/CfRR_Courses/issues/22)\n", |
84 | 84 | "\n", |
85 | 85 | "##### Github Issue Example\n", |
86 | 86 | "\n", |
|
112 | 112 | "\n", |
113 | 113 | "#### Contribute back to the Main CfRR Branch\n", |
114 | 114 | "- **Github Repository**: Navigate to the repository on GitHub where you pushed the branch.\n", |
115 | | - "- **Create a Pull Request**: At the top of the GitHub page, you should see a prompt to create a pull request for the branch you pushed; click on `Compare and Pull Request`. If you dont see this, try switching from the branch you are currently on to the branch you have created. \n", |
| 115 | + "- **Create a Pull Request**: At the top of the GitHub page, you should see a prompt to create a pull request for the branch you pushed; click on `Compare and Pull Request`. If you don't see this, try switching from the branch you are currently on to the branch you have created. \n", |
116 | 116 | "- **Complete Pull Request Form**: Provide both a title and a description for the pull request.\n", |
117 | 117 | "- **Select the base repository and branch**: Ensure that the base repository is set to the original repository and the base branch is the branch you want to merge into (`main` for CfRR_Courses).\n", |
118 | 118 | "- **Submit the Pull Request**: Click on `Create Pull Request` to submit the pull request and allow us, the central CfRR team, to integrate the changes into the main materials.\n", |
|
0 commit comments