trackdown

# A simple framework for collaboration <br/> in a literate programming workflow

### @useR 2021

---

# Literate programming in R

---
class: fullscreen

---

# Amazing packages for different kinds of documents

---

# What about collaboration?

---

# Why?

* We have to collaborate both with ne**R**d people and the average Microsoft Word user 😱

* We have to collaborate on **plain text files** (`.Rmd` or `.Rnw`) so before the compilation stage

* We **lack of a collaborative environment** for text-based documents such as the revision mode of Microsoft Word or Google Docs

]

---
class: chapter-slide, centre, middle

# Wait! we have GIT for collaboration on plain text files! 😎

---

# GIT is powerful! but not for text-based documents! 😢

<div class="figure" style="text-align: center">
<img src="img/word_based.png" alt="With standard reviewing tools" width="1060" height="350" />
<p class="caption">With standard reviewing tools</p>
</div>

]

<div class="figure" style="text-align: center">
<img src="img/git_text_problem_high.png" alt="Using GIT" width="2475" height="350" />
<p class="caption">Using GIT</p>
</div>

]

---

# In an ideal world...

---

## We need a tool that:

* Allow us to easily **collaborate in the same way as a standard Word file**

<br/>

--
* Is **user friendly** for the average user and **powerful** for experts

<br/>

--
* **Keep all amazing features of a literate programming framework**, without any compromises

---
class: center, middle

# This is the main aim of the trackdown package 😎

<img src="img/trackdown_logo.png" width="30%" style="display: block; margin: auto;" />
---
class: chapter-slide, center, middle

# The big picture

---
# The big picture

---

# trackdown::upload_file()

---
class: fullscreen

---

# Awesome collaboration on Google Docs

---
class: fullscreen

---

# trackdown::download_file()

---
class: fullscreen

---

# Most relevant features

* Support for both `.Rmd` and `.Rnw` files

</br>

* Powerful system to **hide/restore and backup code chunks** between the `upload` and `download` process

</br>

* Perfectly integrated with a GIT workflow

---
class: fullscreen

# Check the full documentation 😄

[**ClaudioZandonella/trackdown**](https://github.com/ClaudioZandonella/trackdown) <svg viewBox="0 0 496 512" style="height:1em;position:relative;display:inline-block;top:.1em;" xmlns="http://www.w3.org/2000/svg">  <path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"></path></svg>

---
class: split-five, fullscreen

# The developers 😎

.column[
<div class="figure" style="text-align: center">
<img src="img/filippo.jpg" alt="&lt;a href='mailto:filippo.gambarota@phd.unipd.it'&gt; Filippo Gambarota &lt;/a&gt; &lt;/br&gt; &lt;p style='font-size:10px'&gt;University of Padova&lt;/p&gt;" width="70%" />
<p class="caption"><a href='mailto:filippo.gambarota@phd.unipd.it'> Filippo Gambarota </a> </br> <p style='font-size:10px'>University of Padova</p></p>
</div>
]

.column[
<div class="figure" style="text-align: center">
<img src="img/claudio.jpeg" alt="&lt;a href='mailto:claudiozandonella@gmail.it'&gt; Claudio Zandonella Callegher &lt;/a&gt; &lt;/br&gt; &lt;p style='font-size:10px'&gt;University of Padova&lt;/p&gt;" width="70%" />
<p class="caption"><a href='mailto:claudiozandonella@gmail.it'> Claudio Zandonella Callegher </a> </br> <p style='font-size:10px'>University of Padova</p></p>
</div>
]

.column[
<div class="figure" style="text-align: center">
<img src="img/janosch.jpg" alt="&lt;a href='mailto:jlinkersdoerfer@ucsd.edu'&gt; Janosch Linkersdörfer &lt;/a&gt; &lt;/br&gt; &lt;p style='font-size:10px'&gt;University of California&lt;/p&gt;" width="70%" />
<p class="caption"><a href='mailto:jlinkersdoerfer@ucsd.edu'> Janosch Linkersdörfer </a> </br> <p style='font-size:10px'>University of California</p></p>
</div>
]

.column[
<div class="figure" style="text-align: center">
<img src="img/mathew.jpg" alt="&lt;a href='mailto:m.ling@deakin.edu.au'&gt; Mathew Ling &lt;/a&gt; &lt;/br&gt; &lt;p style='font-size:10px'&gt;Deakin University&lt;/p&gt;" width="70%" />
<p class="caption"><a href='mailto:m.ling@deakin.edu.au'> Mathew Ling </a> </br> <p style='font-size:10px'>Deakin University</p></p>
</div>
]

.column[
<div class="figure" style="text-align: center">
<img src="img/emily.jpeg" alt="&lt;a href='mailto:emily.kothe@deakin.edu.au'&gt; Emily Kothe &lt;/a&gt; &lt;/br&gt; &lt;p style='font-size:10px'&gt;Deakin University&lt;/p&gt;" width="70%" />
<p class="caption"><a href='mailto:emily.kothe@deakin.edu.au'> Emily Kothe </a> </br> <p style='font-size:10px'>Deakin University</p></p>
</div>
]

---
class: psicostat, fullscreen

# A special thanks to Psicostat members

Check our [**website**](https://psicostat.dpss.psy.unipd.it/index.html) 😄

---
class: final-slide, center, middle

### .large[[filippo.gambarota@phd.unipd.it](mailto:filippo.gambarota@phd.unipd.it)]

.tiny[Slides made with the [Xaringan](https://github.com/yihui/xaringan) package by [Yihui Xie](https://yihui.name/)]