-
Notifications
You must be signed in to change notification settings - Fork 1
/
readme-chapter-6.Rmd
78 lines (47 loc) · 3.01 KB
/
readme-chapter-6.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
---
title: "Publishing your work"
author: "Andrew Ba Tran"
output:
pdf_document: default
html_document: default
---
### Chapter 6
# Publishing
Reproducible research means structuring your project and code so that others can follow your steps to verify your findings and possibly build on your work.
We're going to learn how to move our scripts into R Markdown, which will allow you to weave a narrative of text around your code and visualizations. Imagine being able to communicate your findings as well as your thought process with your editor or members of your team.
### Show your work
**Everyone's doing it!**
<img src="/publishing/rmarkdown/images/somanyrepos.png" height="300">
For journalists, publishing your methodology and allowing others to start with raw data, transform it, and end up with your results themselves helps you:
* Build trust among readers
* Enhance transparency
* Promote community
Do this enough and you'll be able to read and interpret others' methodology.
This is a great way to learn new techniques and make you think about how to apply them to future stories.
Finally, the person who will benefit from documenting and scripting your process the most in the future is you.
R won't help make you a faster data analyst.
The process you document for the data projects you agonize over today will make your life easier in the future.
You're collecting enough scripts, whether your own or others, that you can apply to challenging stories in the future.
## In this section
* RMarkdown
* How to use the R version of notebooks
* More R Markdown
* Extra features that will enhance your reports
* Setting up an R workflow
* Best practices for staying organized to promote reproducibility
## Files and folders
The [repo for this class](https://github.com/r-journalism/learn-chapter-6) is on GitHub, but can be easily downloaded to your desktop with the following commands:
```
install.packages("usethis")
usethis::use_course("https://github.com/r-journalism/learn-chapter-6/archive/master.zip")
```
### Readings
* How Open Should Open Source Data Visualization Be? - [flowing data](
https://flowingdata.com/2008/08/29/a-case-for-open-source-data-visualization/)
* We Trained A Computer To Search For Hidden Spy Planes. This Is What We Found. - [Buzzfeed](https://buzzfeednews.github.io/2017-08-spy-plane-finder/)
* Spies in the Skies - [Buzzfeed](https://buzzfeednews.github.io/2016-04-federal-surveillance-planes/analysis.html)
* 2016 will be the warmest year, but this is how deniers will spin it - [Buzzfeed](https://buzzfeednews.github.io/2016-12-warmest-year/)
* How Trump is changing the face of legal immigration - [Washington Post](https://www.washingtonpost.com/national/how-trump-is-changing-the-face-of-legal-immigration/2018/07/02/477c78b2-65da-11e8-99d2-0d678ec08c2f_story.html?utm_term=.cf476672d6e4) | [GH](https://github.com/wpinvestigative/immigrant_visas)
* Our Data - [fivethirtyeight](https://data.fivethirtyeight.com/)
-----
<span style="color:gray">© Copyright 2018, Andrew Ba Tran</span>