Currently README.md can grow stale because nothing one does in the normal course of development will cause it to be re-rendered.
We've discussed that it should be probably rendered via devtools::document().
pkgdown is also relevant, but it was recently decided that it's confusing for pkgdown::build_site() to modify files outside of docs/.
Also connected to vignette development workflows, which are up in the air:
https://github.com/r-lib/devtools/issues?utf8=✓&q=is%3Aissue+is%3Aopen+vignette
Currently README.md can grow stale because nothing one does in the normal course of development will cause it to be re-rendered.
We've discussed that it should be probably rendered via
devtools::document().pkgdown is also relevant, but it was recently decided that it's confusing for
pkgdown::build_site()to modify files outside ofdocs/.Also connected to vignette development workflows, which are up in the air:
https://github.com/r-lib/devtools/issues?utf8=✓&q=is%3Aissue+is%3Aopen+vignette