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

Improve "Libraries" definition on Module 2 #866

Open
juanpflores opened this issue Oct 1, 2024 · 4 comments
Open

Improve "Libraries" definition on Module 2 #866

juanpflores opened this issue Oct 1, 2024 · 4 comments
Labels
Module: 2 OS101 Curriculum: Content Suggestions Suggestions for text found in the open science 101 curriculum. Use Lesson and Module labels. OS101 Status: Curriculum Openscience101.org still needs changes implemented.

Comments

@juanpflores
Copy link

I was taking the course and on Module 2 I found the definition of Libraries a bit broad:

Generic tools that implement well-known algorithms, provide statistical analysis or visualization, etc., which are incorporated in other software categories.

Proposed definition:

A software library is a collection of pre-written, reusable code that provides standardized implementations of common algorithms, utilities for tasks such as statistical analysis, data manipulation, and visualization, among others. These libraries are intended to be integrated into larger software systems, allowing developers to incorporate complex functionalities without the need to develop them from scratch.

I believe the new proposed definition would help readers understand the value of software libraries by adding more details about how developers use libraries to incorporate functionality without writing everything from scratch.

@bressler95tops
Copy link
Contributor

Thank you @juanpflores for taking the time to make suggestions for OS101! I will add this to our queue for dispositioning and we will update you if we have questions, implement your proposed definition, or if we decide to go with a modified definition.

@bressler95tops bressler95tops added OS101 Curriculum: Content Suggestions Suggestions for text found in the open science 101 curriculum. Use Lesson and Module labels. Module: 2 labels Oct 3, 2024
@bressler95tops bressler95tops added OS101 Status: Curriculum Openscience101.org still needs changes implemented. OS101 Status: GitHub GitHub still needs changes implemented. labels Oct 15, 2024
@katblanchette
Copy link

@bressler95tops - The OS101 team has reviewed @juanpflores revised definition and we agree and prefer his text. Please replace the definition in the content with the definition above. Thank you!

@bressler95tops
Copy link
Contributor

bressler95tops commented Nov 14, 2024

@katblanchette Juan addressed this issue with their own PR, specifically #930. Just so the OS101 devs have optics on where the change occurred. The 'files changed' tab likewise has the precise change when viewing the PR.

@bressler95tops bressler95tops removed the OS101 Status: GitHub GitHub still needs changes implemented. label Nov 14, 2024
@katblanchette
Copy link

@bressler95tops - Thank you for the update! The new language on #930 sounds good and we have noted this change on the spreadsheet to update in the MOOC on the next round of revisions. You may close this issue when you are ready.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Module: 2 OS101 Curriculum: Content Suggestions Suggestions for text found in the open science 101 curriculum. Use Lesson and Module labels. OS101 Status: Curriculum Openscience101.org still needs changes implemented.
Projects
None yet
Development

No branches or pull requests

4 participants
@juanpflores @katblanchette @bressler95tops and others