[R-pkg-devel] R-bloggers and vignettes

Maëlle SALMON m@e||e@@@|mon @end|ng |rom y@hoo@@e
Fri Mar 11 07:53:35 CET 2022


Hello,


To me, if you have the time, the second solution sounds the best as reading a shorter post might be appealing to more readers, who can then explore your package docs or just put the existence of your package in a corner of their memory for later when they actually need it. And then you can keep this habit and blog again when your package has a new release. :-)

Here's an example of a blog post by Neal Richardson advertising a package in a different way than in the package vignettes (that are published on a pkgdown website): https://enpiar.com/2017/06/21/7-hard-testing-problems-made-easy-by-httptest/

Curious to read others' opinions. Good luck in any case!

Maëlle.

Den torsdag 10 mars 2022 22:00:32 CET, Michael Barr <mike using bikeactuary.com> skrev: 





Hi again -

Hope this is not misplaced, but I have a question related more to publishing a release note on r-bloggers. My site is already fed into r-bloggers and I've put a couple posts there. But with my first package I'm wondering if it is bad form to blog the entire vignette on your own site (and by extension on r-bloggers) when it is rather long with many examples. Is there any convention here, for example:

- publish just the first x% of the vignette, with a read more link to the full write up posted elsewhere (either the CRAN hosted or somewhere else on your own blog)
- write a separate, more condensed version that gets across the main points (say with less examples)
- publish the whole thing and it's fine

Just looking for thoughts on what others like or expect to see. Thanks

Mike

    [[alternative HTML version deleted]]

______________________________________________
R-package-devel using r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-package-devel



More information about the R-package-devel mailing list