# Benefits of Dynamic Documents

'Dynamic Documents' are projects or papers that are developed using prominent tools such as R-markdown or JuPyTer notebooks (the two most prominent tools).

The salient features and benefits of this approach include:

* **Integrated data analysis and reporting** means the data analysis (as well as math/simulations) is done and reported in the same space that the results and discussion are presented. This is made possible through the concealment of 'code blocks'.
* **Transparent reporting** means you can track exactly what is being reported and how it was constructed:
  * Making the process a lot less error-prone
  * Helping readers understand it better (see ['explorable explanations'](http://worrydream.com/ExplorableExplanations/))
  * Helping replicators and future researchers build on it
* Other advantages of these formats (over PDFs for example) include:
  * Convenient ‘folding blocks’
  * Margin comments
  * [Hoverable notes](#user-content-fn-1)[^1] and links
  * Integrating interactive tools

### **Better examples, the case for dynamic documents**

{% embed url="<https://quarto.org/>" %}

{% embed url="<https://distill.pub/2020/communicating-with-interactive-articles>" %}

{% embed url="<http://worrydream.com/ExplorableExplanations>" %}

<details>

<summary>Also consider...</summary>

* Elife's 'editable graphics'... Brett Viktor?
* see corrigendum in journals Reinhart and Rogoff error?
* open science MOOC in R markdown ...
* OSF and all of their training/promo materials in OS

</details>

### Reinstein's own examples

Some quick examples from my own work in progress (but other people have done it much better)

{% embed url="<https://daaronr.github.io/dualprocess/introduction-effective-giving-responses-to-analytical-effectiveness-information.html>" %}

{% embed url="<https://rethinkpriorities.github.io/ea_data_public/eas_donations.html>" %}

### Other (randomly selected) examples

{% embed url="<https://www.fharrell.com/post/impactpo>" %}

{% embed url="<https://bookdown.org/psonkin18/berkshire/#tldr-otherwise-known-as-an-executive-summary>" %}

{% embed url="<https://bookdown.org/jsiwinski2/play-in-book/>" %}

[^1]: like this.