I take Duncan's point but would second the motion to have WRE clarify
how static vignettes are supposed to work; it's a topic I am repeatedly
confused about despite being an experienced package maintainer. If
knowledgeable outsiders compiled a documentation patch would it be
likely to be considered ...??
On 11/1/20 2:29 PM, Duncan Murdoch wrote:
On 01/11/2020 1:02 p.m., Alexandre Courtiol wrote:
Noted Duncan and TRUE...
I cannot do more immediately unfortunately, that is always the issue
of asking a last minute panic attack question before teaching a course
involving the package...
I do have /doc in my .Rbuildignore for reasons I can no longer
remember... I will dig and create a MRE/reprex.
The students will download heavy packages, but they probably won't
notice.
*Apologies*
In the meantime, perhaps my question was clear enough to get clarity on:
1) whether having vignettes twice in foders inst/doc and vignettes is
normal or not when vignettes are static.
2) where could anyone find a complete documentation on R vignettes
since it is a recurring issue in this list and elsewhere.
The Writing R Extensions manual describes vignette support in R, but R
allows contributed packages (like knitr, rmarkdown, R.rsp) to handle
vignettes. WRE explains enough to write such a package, but it's up to
their authors to document how to use them, so "complete documentation"
is spread out all over the place. As with any documentation, there are
probably errors and omissions.
Duncan Murdoch
______________________________________________
R-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel
______________________________________________
R-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel
