Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Lesson 1 - definition of 'libraries', 'modules' and 'functions' #664

Open
HeatherAn opened this issue Jul 18, 2019 · 0 comments
Open

Lesson 1 - definition of 'libraries', 'modules' and 'functions' #664

HeatherAn opened this issue Jul 18, 2019 · 0 comments

Comments

@HeatherAn
Copy link
Contributor

@HeatherAn HeatherAn commented Jul 18, 2019

In Lesson 1 - Analyzing Patient Data, 'Loading data into Python' section, when referring to 'libraries', perhaps it would be better to state from the beginning what a 'library', a 'module' and a 'function' are.

The lesson would benefit if this distinction is made early on. Something along the lines of 'Python has functions that come by default (like print() for example), but there are also a lot of very useful functions in so-called libraries. Each library has functions that do specific tasks organized in different units called modules. Thus we can use the functions that come by default, or we can use the functions within libraries. Whenever we want to use functions within a given library, then we have to first import that library, and then call the functions using the dotted notation (library.function).'

hanlei9876 added a commit to hanlei9876/Software-Carpentry-Checkout---python-novice-inflammation that referenced this issue Mar 29, 2020
In correspondence to issue swcarpentry#664

Add a short explanation of the differences between libraries and modules

I agree with the point of introducing the concepts of 'libraries' and 'modules'. Because if not explaining them, there might be confusions to audiences. But I feel that the main thread of this lesson is to talk about Python fundamental concepts and dealing with datasets, and the terminologies of 'libraries' and 'modules' are not that much important. So, as a tradeoff, I choose to add a quick note below the first appearance of the concept 'module', so the audience won't get confused here while still following the main thread of this lesson.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
1 participant