Vignettes

[sckott]

• Working with the DO API
• Docker/R and DO

[hadley]

Definitely need a section on security that describes the defaults, and our motivation for them.

[sckott]

@hadley :+1:

[sckott]

I think it makes sense to include pre-rendered vignettes in vignettes/ since it requires auth to run, Make sense?

[hadley]

I think putting a pre-rendered vignette into vignettes/ is going to open you up to a world of hurt with R CMD check

[sckott]

@hadley I don't see why? Assuming you're right, what's the alternative when compiling the vignette requires authentication? Sure, we can do that locally, but how does that work on CRAN?

[hadley]

CRAN never builds vignettes

[hadley]

I guess it does run the code in them, but you can suppress that with a "no_tangle" knitr builder.

[sckott]

So with "no_tangle" code won't be run on CRAN, but will build (unless user suppresses) on installation?

[hadley]

install_github() now sets build_vignettes = FALSE by default, and vignettes are pre-built when you install from CRAN.