geom_boxplot + geom_jitter documentation clarity

[igordot]

In the documentation for geom_boxplot, there is an example:

p <- ggplot(mpg, aes(class, hwy))
p + geom_boxplot() + geom_jitter(width = 0.2)

This is useful if you want to see all the points. What is not entirely obvious is that the command retains both the outlier and jitter points. Thus, you may end up with more plotted points then data points. You can see this more easily by coloring one of them:

p + geom_boxplot(outlier.colour = "red") + geom_jitter(width = 0.2)

I am not sure what the proper fix would be since this is not really an error, but the documentation should probably clarify this situation.

[clauswilke]

I think the line

p + geom_boxplot() + geom_jitter(width = 0.2)

should be replaced by these two lines (and possibly moved further down in the examples):

# remove outliers when overlaying boxplot with original data points
p + geom_boxplot(outlier.shape = NA) + geom_jitter(width = 0.2)

Maybe @dpseidel can make this part of her documentation revisions.

[dpseidel]

Sure I still have a couple open docs PRs, I can slip this in.

[dpseidel]

Alright - the adjustment has been made and this issue will close once PR #2768 is merged.

[lock]

This old issue has been automatically locked. If you believe you have found a related problem, please file a new issue (with reprex) and link to this issue. https://reprex.tidyverse.org/