From d8973c59102d26e50cb531c0c93e716ea6b5c2b9 Mon Sep 17 00:00:00 2001 From: hadley Date: Mon, 15 Aug 2016 10:14:25 -0500 Subject: [PATCH] Quick pass through communuication intro --- communicate.Rmd | 67 +++++++++++++++++++++++++++++++++++++------------ 1 file changed, 51 insertions(+), 16 deletions(-) diff --git a/communicate.Rmd b/communicate.Rmd index 9f8d51c..af54bca 100644 --- a/communicate.Rmd +++ b/communicate.Rmd @@ -2,32 +2,67 @@ # Introduction -Parts 1 through 4 have shown you how to understand what is happening in your data, but it won't matter how well you understand your data if you cannot communicate what you find with others. To be effective, you will need to share your work in a way that your audience can comprehend. Your audience might be - -* fellow scientists who will want to reproduce the work -* non-scientists who will want to understand your findings in plain terms -* or yourself (in the future) who will be thankful if you make your work easy to re-learn and recreate - -__Part 5__ discusses communication, and how you can use R Markdown to save and share your work in an incredibly efficient way. +So far, you've learned the tools to get your data into R, tidy it into a form convenient for analysis, and then understand you data through transformation, visualisation and modelling. However, it doesn't matter how great your analysis is unless you can explain it to others: you need to __communicate__ your results. ```{r echo = FALSE, out.width = "75%"} knitr::include_graphics("diagrams/data-science-communicate.png") ``` -This part will conspicuously not cover one technology that I feel is essential to a particular type of communication: collaboration. Whenever you collaborate with one or more people, you can make your life much easier by using version control software, specifically Git and Github. We recommend two free resources that will teach you about Git. +Your audience might be: -First, Hadley has written a chapter that explains how to use Git and Github, which is available online, +* Fellow practioners who want to reproduce your work. -[r-pkgs.had.co.nz/git.html](http://r-pkgs.had.co.nz/git.html) +* Decision makers want to understand your findings in plain English. -Second, Jenny Bryan has written a terrific book on how R users can use git, which is also available for free online, +* Future-you who will be thankful if you make your work easy to re-learn + and recreate -[happygitwithr.com](http://happygitwithr.com) +In this part of the book, you will learn about: -Recommendations for learning more about communication: +* RMarkdown, a tool that allows you to easily combine prose and code to + construct reproducible reports where the inputs and outputs are always + in sync. + +* Presentation techniques for visualsiation. When creating exploratory graphics, + you want to be able to iterate as quickly as possible, so you'll typically + stick to ggplot2's defaults. When you're communicating to others, you'll + want to think through every aspect of your plot in order to make it as + easy to understand as possible. -For writing: [Style: Lessons in Clarity and Grace](http://amzn.com/0321898680), +## What you will not learn -For presentations: [slide:ology](http://amzn.com/0596522347), , (academic), http://speaking.io, https://www.coursera.org/learn/public-speaking +There are two important topics that you will not learn here: collaboration, and how to express yourself clearly. + +Collaboration is a vital part of modern data science, and you can make your life much easier by using version control tools, such as Git and Github. We recommend two free resources that will teach you about Git: + +1. "Happy Git with R": a user friendly introduction to Git and GitHub from + R users, by Jenny Bryan. The book is freely available online: + + +1. The "Git and GitHub" chapter of _R Packages_, by Hadley. You can also + read it for free online: . + +We're also not going to give you the human tools for communication. But here are a few recommendations: + +* If you want to improve your writing, I highly recommend reading either + [_Style: Lessons in Clarity and Grace_](http://amzn.com/0321898680), or + [](). Both books will help you understand the structure of sentences and + paragraphs and give you the tools to make your writing more clear. + +* To improve your presentation skills, I recommend + [_Presentation Patterns_](https://amzn.com/0321820800), by Neal Ford, + Matthew McCollough, and Nathaniel Schutta. It provides a set of effective + patterns (both low- and high-level) that you can imply to improve your + presentations. + +* If you give academic talks, I recommend reading the [_Leek group guide + to giving talks_](https://github.com/jtleek/talkguide). + +* I haven't taken it personally, but I've heard good things about Matt + McGarrity's online course on public speaking: + . + +* Finally, effectively communicating your ideas often benefits from some + knowledge of graphic design. [_The Non-Designer's Design + Book_](http://amzn.com/0133966151) is a great place to start. -Design: [The Non-Designer's Design Book](http://amzn.com/0133966151)