search

nasa / Transform-to-Open-Science

Transformation to Open Science
Other
760 stars 150 forks source link

Improve "Libraries" definition on Module 2 #866

Open juanpflores opened 1 month ago

juanpflores commented 1 month ago

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 commented 1 month ago

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.

katblanchette commented 2 weeks ago

@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!

alphachart commented 1 week ago

No no no my difi your share??!!!

bressler95tops commented 1 week ago

No no no my difi your share??!!!

Was there something we could help with @alphachart? If this is a separate concern within the scope of TOPS and the Open Science 101 curriculum, I would encourage you to open a new issue.

bressler95tops commented 1 week ago

@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.

katblanchette commented 1 week ago

@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.