Introduction

Recently, we submitted our first manuscript that was entirely written in Rmarkdown. See \citealt{Roth_2018} for the manuscript. The code that was used to produce this manuscript can be downloaded from our GitHub repository . Rmarkdown in connection with the version control provided by git / GitHub is a great environment to develop the statistical analyses from the first ideas to the final results. It is also a great way to provide reproducible data analyses to reviewers and readers. However, we felt that the system was not perfectly adapted to a smooth writing process, which includes the writing of the first draft of the manuscript in parallel with developing the statistical analyses as well as the process of developing the final MS from the first draft in collaboration among all the authors (we were eight). In our point of view our workflow had the following shortcomings:
So after this experience I was hoping to slightly improve the writing part of the workflow for the next project.  My wish list included the following:
When searching on the web to improve things I came across several sources that mentioned Authorea . Authorea is a collaborative writing platform for researchers. Authorea has some features that sounded promising to me:
So I decided to give it a try. This document is the result of this try. The GitHub repository that is linked to this article can be found at https://github.com/TobiasRoth/RtoAuthorea

Connecting an Authorea document to own GitHub repository

New repository from scratch