Want to help out or contribute?

If you find any typos, errors, or places where the text could be improved, please let us know by providing feedback either in the feedback survey (given during class), by using GitLab, or directly in this document with hypothes.is annotations.

  • Open an issue or submit a merge request on GitLab with the feedback or suggestions.
  • Hypothesis Add an annotation using hypothes.is. To add an annotation, select some text and then click the on the pop-up menu. To see the annotations of others, click the in the upper right-hand corner of the page.

1 Welcome!

GitLab repository License: CC BY 4.0 License: MIT Zenodo DOI

The course is designed as a series of participatory live-coding lessons, where the instructor and learner code together, along with hands-on exercises interspersed throughout the course and a final group assignment to do a simple data analysis project. This website contains all of the material for the course, from reading material to exercises to code to images. It is structured as a book, with “chapters” as lessons, given in order of appearance. We make heavy use of the website throughout the course where code-along sessions almost identically follow the material on the website (with slight modifications for time or more detailed explanations).

The course material was created using rmarkdown to write the lessons, bookdown to create the book format, GitLab to host the Git repository of the material, and GitLab CI with Netlify to create the website. The original source material for this course is found on the r-cubed GitLab repository.

Want to contribute to this course? Check out the README file as well as the CONTRIBUTING file on the GitLab repository for more details. The two main and easiest ways to contribute are by using:

  1. hypothes.is, a web annotating tool. Go to “Get Started” to give feedback and add comments directly on this website.
  2. GitLab and creating a new Issue to make comments and give feedback on the material.

1.1 Target audiences

This website and its content are targeted to three groups:

  1. For the learners to use during the course to follow along in case they get lost and for them to use as a reference after the course ends.
  2. For the instructors to use as a guide for when they do the code-along sessions and lectures.
  3. For those who are interested in teaching, and who may not have much experience or may not know where to start, to use this website as a guide to running and instructing their own workshops.

1.2 Re-use and licensing

Creative Commons License

The course material is licensed under the Creative Commons Attribution 4.0 International License and the course code is licensed under a MIT License, so the material can be used, re-used, and modified, as long as there is attribution to this source.

1.3 Previous versions

There have been two previous “formal” versions of the course given so far:

1.4 Contributors

Contributors for version 1 were:

  • Luke Johnston: Brainstormed most of the course material and structure; set up the website; organized and coordinated the course; wrote, prepared, and taught most of the code-along sessions, as well as several lectures.
  • Daniel Witte: Participated in brainstorming on the course structure and layout; prepared and taught most of the lectures.
  • João Santiago: Taught and edited the R Markdown code-along session material.
  • Anna Schritz: Taught and edited the Data Management and Wrangling code-along session material.
  • Omar Silverman (helper) proofread and provided feedback on the material for several sessions.

Contributors for version 2 were:

  • Luke Johnston: Same as with version 1.
  • Daniel Witte: Prepared and taught most of the lectures.
  • Helene Bæk Juel: Edited and taught the Data Visualization code-along session material, as well as reviewed multiple other sections.
  • Bettina Lengger: Edited and taught the Data Management and Wrangling code-along session material, as well as reviewed multiple other sections.

Contributors for version 2.1 were:

TODO: Add this once done.

1.5 Acknowledgements

Many pieces from the (in development) course Merely Useful were modified and used in several places throughout the r-cubed course. Other parts were taken and modified from:

Content from multiple sources were used as inspiration for this course, including the R for Data Science book and the Fundamentals of Data Visualization.

The Danish Diabetes Academy hosted, organized, and sponsored versions 1 and 2 of the course. A huge thanks to them for their involvement, support, and sponsorship! Both Steno Diabetes Center Aarhus and Aarhus University were employers of Luke Johnston and Daniel Witte (the initial founders and creators).

Danish Diabetes Academy Steno Diabetes Center Aarhus Aarhus University