class: inverse, middle, center class: left, middle, inverse <!-- Title slide --> ### Friends don't let friends copy-paste ![:pull right, 35%]( <img src="https://github.com/crsh/papaja/raw/main/tools/images/papaja_hex.png" style="padding-top: 0.5em;"> ) # Collaborative writing #### Frederik Aust & Marius Barth <small> 21.04.2023 </small> --- exclude: true --- layout: true name: footer <div class="my-footer"> <div style="float: left;"><span>Frederik Aust & Marius Barth</span></div> <div style="text-align: right;"><span>Friends don't let friends copy-paste</span></div> <div style="float: center;"><span>21.04.2023</span></div> </div> <script type="text/x-mathjax-config"> MathJax.Hub.Config({ "HTML-CSS": { scale: 150, } }); </script> --- <script src="https://cdn.jsdelivr.net/npm/medium-zoom@1.0.6/dist/medium-zoom.js"></script> <script type="module"> import mediumZoom from 'https://cdn.jsdelivr.net/npm/medium-zoom@1.0.6/dist/medium-zoom.esm.js' const zoomDefault = mediumZoom('#zoom-default') const zoomMargin = mediumZoom('#zoom-margin', { margin: 45 }) </script> --- layout: true template: footer name: colab # Collaborative writing --- Several options, but no equivalent to Word/Google Docs 1. PDF comments 2. Word/Google Docs -- 3. [**trackdown**](https://github.com/ClaudioZandonella/trackdown) and Google Docs -- 4. Git and GitHub - For a hands-on introduction see ["Reproducible research practices for psychologists"](http://frederikaust.com/reproducible-research-practices-workshop) --- layout: true template: colab name: git ### Git --- name: vc 1. Version control - Track changes to *text files* - Retain version history of snapshot (*commits*) - Track provenance (who, what, when) --- <img src="data:image/png;base64,#img/git-history.png" width="85%" id="zoom-margin" style="display: block; margin: auto;" /> --- template: vc 2. Branching - Alternative versions of files - Simultaneous asynchronous collaboration --- <img src="data:image/png;base64,#img/git-branching.jpg" width="90%" style="display: block; margin: auto;" /> --- Why use Git? - Avoid mistakes, e.g. - Working on wrong version - Inadvertently deleting or editing files -- - Track and merge changes of multiple collaborators across multiple files -- - (Offsite backups) --- layout: true template: footer class: center, middle --- <img src="data:image/png;base64,#img/git-fire.png" width="" height="450px" style="display: block; margin: auto;" /> --- <img src="data:image/png;base64,#img/git-system.png" width="550px" height="" style="display: block; margin: auto;" /> --- layout: true template: colab --- <img src="data:image/png;base64,#img/github-logo.png" width="150px" style='float:right;' style="display: block; margin: auto;" /> ### GitHub - Proprietary platform - Free to use for academics - Host remote Git repositories -- - Provides slick web interface - Offers project management tools -- - Repositories can receive a DOI with [Zenodo](https://guides.github.com/activities/citable-code/) -- - Servers located in the USA (GDPR) --- <img src="data:image/png;base64,#img/gitlab-logo.png" width="150px" style='float:right;' style="display: block; margin: auto;" /> ### GitLab - .highlight[Open source platform] - .highlight[Can be hosted by your institution] -- - Host remote Git repositories - Provides slick web interface - Offers project management tools -- - .highlight[Servers can be located in your country] (GDPR) --- layout: false template: footer class: middle, center # A quick [demonstration](https://github.com/mariusbarth/papaja-example-manuscript)!