This repository holds publicly available instructional modules aimed at teaching data science and related skills to researchers, as part of an NIH emphasis on improving research reproducibility, transparency, and rigor.

These materials have been created for the purpose of sharing them widely with the research community. Support for this effort includes NIH funding via an R25 grant mechanism.

The training materials here are built in markdown, and you can use the Liascript markdown renderer to make them into attractive, configurable training modules. To use Liascript, go to https://liascript.github.io and enter the url of the (raw) markdown.

For example, to use the training included in data_visualization_in_ggplot2, navigate to https://liascript.github.io add the url for the "raw" version of data_visualization_in_ggplot2, which is https://raw.githubusercontent.com/arcus/education_modules/main/data_visualization_in_ggplot2/data_visualization_in_ggplot2.md. Together, that gives you this combined url: https://liascript.github.io/course/?https://raw.githubusercontent.com/arcus/education_modules/main/data_visualization_in_ggplot2/data_visualization_in_ggplot2.md

This project is grateful for the generosity of Liascript's creators and sustainers, André Dietrich and Sebastian Zug, for sharing their work (and advice!) freely.

This work is licensed with Creative Commons Attribution-ShareAlike 4.0. There is also a helpful summary of the full license that describes what we permit in brief terms. You are free to share and adapt these materials as long as you give appropriate credit and apply the same license to your version of these materials. Some uses we foresee include:

• Forking this repository and changing some elements to be more contextualized to your audience (such as translating materials or changing sample data), and sharing the remixed contents with your audience
• Forking this repository and adding or removing courses that best meet the needs of your audience
• Sharing links to this repository or its contents with communities of learners
• Suggesting changes to our materials (especially where doing so would improve generalizability and accessibility) by adding an issue or creating a pull request with proposed changes
• Creating free community learning events like user groups or hackathons that use these materials
• Using our published guidelines and methods for curriculum creation, with attribution, in your own projects

If you do use these materials, we would love to hear from you! Please let us know about your experience so we can continue to improve.

If you would like to create a module for inclusion here, please review the methods for doing so within our How To Guide.

Root level folders in this repository include instructional modules as well as some shared assets that will be used by instructional modules. Want to submit a pull request to add materials? Please abide by the file structure and naming conventions described here and captured in existing materials.

File and directory names, except for when established convention (e.g. README.md) differs, should be in lower case with underscores separating words.

./
├── README.md
├── assets
│   ├── media
│   ├── css
│   │   ├── styles.css
│   │   └── maybe_one_more.css
│   └── js
│       ├── some_script.js.min
│       └── Other_Commonly_Written_This_Way_Script.js
├── lesson_name
│   ├── lesson_name.md
│   ├── media
│   │   ├── some_video.mp4
│   │   └── some_image.png
│   └── code
│       ├── some_markdown.Rmd
│       ├── python_sample.ipynb
│       └── to_be_completed.R
└── different_lesson_name
    ├── different_lesson_name.md
    ├── media
    │   ├── best_video.mp4
    │   └── an_image.png
    └── code
       └── sample.R

If you use .css or .js scripts, it's important to know that you can't supply these scripts directly from GitHub. GitHub does not provide the appropriate metadata to indicate that the content of the files is of the correct type, which means that browsers won't include them.

One solution is to use a CDN that re-packages GitHub contents for use in a web page. For example, Liascript itself suggests using a CDN to provide a CSS script from GitHub.

Since CDNs generally have a refresh rate that doesn't meet the "let's try this really quickly" pace of development in GitHub, another option is to host your script in another publicly accessible location. In our case, we've made use of the AWS S3 service to host a custom css file. This means updating the S3 version of the file as well as the version hosted here, in this GitHub, but the extra headache is worth it.

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.