r-novice-inflammation icon indicating copy to clipboard operation
r-novice-inflammation copied to clipboard

Diagrams to describe functions

Open karenword opened this issue 4 years ago • 2 comments

The following was submitted by email as a contribution for checkout:

"As part of my checkout process, I would like to make a contribution to Programming with R - Creating Functions, by adding a diagram to describe functions (svg and png files are attached). For the novice, even after seeing how a function works, it can be difficult to understand what components are doing what, and what needs to be changed when creating a new function. Hopefully the image below will help with that.

Below is a visual representation of different components of a function. When creating a new function, one can define the following components a: 1) function name, 2) function argument(s), and 3) function body."

https://drive.google.com/file/d/1f29zR5WJW_Ie3FSZeUTSY8-ar15RCqd1/view?usp=sharing

https://drive.google.com/file/d/1y6ZgUwFw9XJV-57lgpfsqhpqWJRFYWqH/view?usp=sharing

karenword avatar Sep 08 '20 16:09 karenword

I think this is a good idea to include in the the lesson plan or as some form of supplementary material. Having a static image that connects terms to examples helps explain the definitions and can provide a great reference for people to come back to. I think this would be a good idea to expand upon with other terms early on in lessons.

C-CAB avatar Sep 10 '20 21:09 C-CAB

This is fantastic, I've been using Jamboard to draw precisely this. It'd be great to have a PR for this change.

HaoZeke avatar Dec 29 '20 01:12 HaoZeke