This workshop will take you from writing a simple plain text file to writing an entire research article in a fully reproducible manner. In the first day of the workshop, you will learn how to create your first reproducible document in the quarto format, report results of your analysis directly in the document, manage references with no hustle, and use templates to format your articles in an instant. In the second day of the workshop, you will learn how to collaborate with others on your reproducible document. 

By the end of the workshop, you will have created your first reproducible document, familiarized yourself with all the fantastic advantages of writing research papers in a fully reproducible manner, and have a great starting point to make all of your scientific writing fully reproducible.

Training format

During this workshop, you will alternate between these activities:
1. type and code along with the instructor;
2. practice what you learned by yourself and/or in pairs.

You will receive instructions on setting up your computer for the workshop approximately a week before the start date.

Audience

This workshop is aimed at researchers who want to write fully reproducible research articles involving the reporting of data analysis results. You have basic knowledge of data analysis with R (e.g., making simple plots, estimating simple analysis models).

Syllabus and schedule

Day 1: Writing reproducible documents (Tuesday, April 15th, 13:00-17:00)

Location: Marga Klompe MKZ 221

• Work with plain text files—Learn to separate writing from layout by working with markdown and quarto markdown files.
• Include code—Combine text with executable code and experience the joys of reporting your data-driven findings in a reproducible manner.
• Add bibliography—Learn how to handle references without pain thanks to the power of the bib file.
• Use templates—Learn how to create ready-for-submission PDF files based on publishers' templates.

Day 2: Document versions and collaboration (Thursday, April 17th, 13:00-17:00)

Location: Cube 213

• Git—Learn how to keep track of what changes in your document using the Git workflow (i.e., save, stage, commit) in the intuitive Positron interface.

• Collaborate—Learn how to share your document and its story with collaborators by connecting Git with GitLab.