Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

I blame the R documentation standards. They force a package author to produce a useless alphabetically-listed pdf, and many people just stop at that point.

Without any standards at all, people would have at least produced a readme.txt, which would have been a huge improvement -- e.g. I much prefer working with unfamiliar user-written Matlab packages :)



I don't know why so many people complain about R documentation, I think it's pretty good. The PDFs are useless for sure, but you don't have to use that. Emacs displays documentation pages in a split window. Or you can use a web browser.

https://stat.ethz.ch/R-manual/R-devel/doc/html/packages.html


Function docs are fine, but they are not really that helpful in figuring out how to use a new package.


It seems that you are looking for vignettes in fact. Examples of use

library('zoo');

vignette('zoo');

#####

library('ggplot2');

vignette(package='ggplot2')


I am (sort of); but most packages don't have vignettes. Zoo and ggplot2 (and a few other major packages) have great documentation, but they are an exception.


It certainly needs a Pypi like rating or popularity system.




Consider applying for YC's Summer 2026 batch! Applications are open till May 4

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: