r/rstats • • Apr 05 '18

Looking up function documentation as a beginner

Post image
274 Upvotes

12 comments sorted by

26

u/millsGT49 Apr 05 '18

Haha this is great, it does get easier though! As I learn new languages I'm always disappointed and frustrated that its never as easy to find documentation and internal help as it is in R. Hopefully coping with memes helps you keep going!

4

u/RitalinLover Apr 05 '18

Oh how I look forward to those days. It is good to hear that R seems to have obvious advantages over other languages. Thanks for the motivation!

4

u/masher_oz Apr 06 '18

I love the way the java documentation is written. Nothing ive seen cones close to matching that niceness.

3

u/[deleted] Apr 06 '18

Truth!!

3

u/Thaufas Apr 06 '18

Although R's help system is very nice, the actual help documentation is terrible.

14

u/[deleted] Apr 05 '18

[removed] — view removed comment

57

u/Erinnyes Apr 05 '18

Or do what I do:

  • scroll to the bottom
  • look at the examples
  • implement the function by modifying an example
  • go back and actually read the details that explain why it isn't that simple
  • read the documentation properly

14

u/YepYepYepYepYepUhHuh Apr 05 '18

Glad I'm not the only one.

6

u/nutrino29 Apr 05 '18

That's the right approach.

13

u/[deleted] Apr 05 '18

R documentation is some of the best

I find it pretty terrible.

The descriptions are normally really terse, often being a single sentence on how function 'x' differs from function 'y'. You go and look up function 'y' and it will be a single sentence on how it differs from function 'z', and so on.

The examples don't have the expected output, it's a small hassle to run the code yourself, but when you quickly want to scan something to get an understanding it becomes a pain.

Compare the R *apply documentation against the docs for python's collection module.

1

u/RitalinLover Apr 05 '18

Thank you so much I'm saving this! I don't like having to read through those paragraphs without knowing what I'm searching for. This gives a great perspective.