Skip to content

Commit 1618bd6

Browse files
Merge pull request #291 from coding-for-reproducible-research/learnr_website_alignment
LearnR and website alignment
2 parents 82167e6 + 04a936a commit 1618bd6

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

contributing/contributing_guidelines.ipynb

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,10 @@
2626
"\n",
2727
"For R courses, we recommend using **learnr** tutorials where appropriate. The learnr package in R enables the development of interactive tutorials that incorporate markdown-formatted text, R code examples, exercises, and quizzes. This format is especially well-suited to R instruction, as it offers learners hands-on practice with immediate feedback within a single, cohesive document. However, if the course content is better served by an alternative format, instructors are encouraged to use their professional judgment in selecting the most effective approach.\n",
2828
"\n",
29+
"```{important}\n",
30+
"If you are updating a course that includes a learnr tutorial (e.g., Regression Analysis with R), please ensure that any changes made to the learnr content are also reflected in the corresponding self-study notes on the website, so the two remain aligned.\n",
31+
"```\n",
32+
"\n",
2933
"These tutorials are distrbuted as an R package [cfrr-r-tutorials](https://github.com/coding-for-reproducible-research/cfrr-r-tutorials) and should be developed in that repo. A homepage, with details on the course and instructions for how to launch the tutorial should be included in this repo. \n",
3034
"\n",
3135
"#### Guidelines for R Courses:\n",
@@ -36,6 +40,8 @@
3640
"- Use clear and concise explanations in markdown to guide learners through the content.\n",
3741
"- Test all tutorials to ensure they function correctly and provide accurate feedback.\n",
3842
"\n",
43+
"\n",
44+
"\n",
3945
"## Course Delivery\n",
4046
"\n",
4147
"Courses may be delivered in different ways depending on the tools available and the nature of the content. It's important to adhere to the standards outlined above to maintain consistency and quality across all courses.\n",

0 commit comments

Comments
 (0)