Introduce the problem with an informative title

• Bad title: “I need help!”
• Good title: “Getting a ‘file not found error’ when importing scotus.csv”

Be specific with your title. It should be brief, but also informative so that when others are looking at the Issues page (and they have a similar error and/or solution), they can easily find it.

Summarize the problem

Introduce the problem you are having. Include what task you are trying to perform, pertinent error messages, and any solutions you’ve already attempted. This helps us narrow down and troubleshoot your problem.

Include a reproducible example

Including a minimal, complete, and verifiable example of the code you are using greatly helps us resolve your problem. You don’t need to copy all the code from your program into the comment, but include enough code that we can run it successfully until the point at which the error occurs.

Make sure you have pushed your recent commits to the GitHub repo. If it is up-to-date, we can quickly look in or clone your repo to our machines to replicate the problem.

Format your code snippets with reprex

The reprex package allows you to quickly generate reproducible examples that are easily shared on GitHub with all the proper formatting and syntax. Install it by running the following command from the console:

install.packages("reprex")

To use it, copy your code onto your clipboard (e.g. select the code and Ctrl + C or ⌘ + C). For example, copy this demonstration code to your clipboard:

library(tidyverse)
count(diamonds, colour)

Then run reprex() from the console, where the default target venue is GitHub:

reprex()

A nicely rendered HTML preview will display in RStudio’s Viewer (if you’re in RStudio) or your default browser otherwise.

Output of reprex()

The relevant bit of GitHub-flavored Markdown is ready to be pasted from your clipboard:

``` r
library(tidyverse)
#> + ggplot2 2.2.1          Date: 2017-08-10
#> + tibble  1.3.3             R: 3.4.1
#> + tidyr   0.6.3            OS: macOS Sierra 10.12.6
#> + readr   1.1.1           GUI: X11
#> + purrr   0.2.2.2      Locale: en_US.UTF-8
#> + dplyr   0.7.2            TZ: America/Chicago
#> + stringr 1.2.0        
#> + forcats 0.2.0
#> ── Conflicts ────────────────────────────────────────────────────
#> * filter(),  from dplyr, masks stats::filter()
#> * lag(),     from dplyr, masks stats::lag()
count(diamonds, colour)
#> Error in grouped_df_impl(data, unname(vars), drop): Column `colour` is unknown
```

Here’s what that Markdown would look like rendered in a GitHub issue:

library(tidyverse)
#> + ggplot2 2.2.1          Date: 2017-08-10
#> + tibble  1.3.3             R: 3.4.1
#> + tidyr   0.6.3            OS: macOS Sierra 10.12.6
#> + readr   1.1.1           GUI: X11
#> + purrr   0.2.2.2      Locale: en_US.UTF-8
#> + dplyr   0.7.2            TZ: America/Chicago
#> + stringr 1.2.0        
#> + forcats 0.2.0
#> ── Conflicts ────────────────────────────────────────────────────
#> * filter(),  from dplyr, masks stats::filter()
#> * lag(),     from dplyr, masks stats::lag()
count(diamonds, colour)
#> Error in grouped_df_impl(data, unname(vars), drop): Column `colour` is unknown

Anyone else can copy, paste, and run this immediately. The nice thing is that if your script also produces images or graphs (probably using ggplot()) these images are automatically uploaded and included in the issue.

To ensure your example is a reproducible example, you need to make sure to load all necessary packages and data objects at the top of your copied code. This may involve opening a new tab in the editor panel and writing a short version of the script that only includes the essentials, then copying that script to the clipboard and reprex() it.

Include your session_info()

Sometimes problems are caused by using older or incompatible versions of packages. The session_info() function in the devtools library will print a list of all active packages and their respective versions. Include this in your post so we know which versions of packages you are using by setting si = TRUE in the reprex() function, like this: reprex(si = TRUE).

Post your solution

Once you have solved the problem (either by yourself or with the help of an instructor/classmate), post the solution. This let’s us know that you have fixed the issue AND if anyone else encounters a similar error, they can refer to your solution to fix their problem.