Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
More explanation of functions? [episode 1 or 2] #392
Reading through 1. Analyzing Patient Data and it seems like functions are kind of glossed over (there are hyperlinks to explanations), whereas variables get a lot of explanation with diagrams. It seems a little uneven, particularly since functions are passed to another function as arguments later in the lesson (where apply is discussed). Are learners experiencing any problems with the function concept?
Regardless, I think it might be a good idea to add a learning objective. Something like "Learn how to use functions to perform operations on data".
Hello @mellertd and thanks for raising this topics :-)
I had considered your suggested learning objective as general to the entire lesson or even to the Carpentries. I'd be happy to review a PR with a specific wording suggestion. "Operations" could for example be confusing functions and operators. Also, "built-in functions" could be useful to distinguish those in 1. from the more specific objectives in 2. Creating Functions ;-)
I haven't heard such a question from learners, but I also have taught far less often than @diyadas or others.
I had not noticed particular difficulties with functions. If anything, I'd prefer a PR on episode 2, creating functions - it would indeed be a good way to reinforce episode 1. Something along the lines of
would be a better opening paragraph than the current one. Wording could be improved :) The file to edit for this PR is located in the