-
Notifications
You must be signed in to change notification settings - Fork 5
added an 'open' section to the site #75
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
base: main
Are you sure you want to change the base?
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@kungfuchicken Please see my comments.
docs/open/open.md
Outdated
These four concepts are interconnected and mutually reinforcing: | ||
* **Open Science enables Open Data and Open Source Software:** Open science practices, such as preregistration, reproducible research, and open notebooks, promote the sharing and reuse of research data and software, aligning with open data and open source principles. | ||
* **Open Data and Open Source Software fuel Open Science:** The availability of open data and open source software facilitates new scientific discoveries, enables validation of research findings, and supports the principles of open science, such as transparency and reproducibility. | ||
* **Open Scholarship integrates Open Science, Open Data, and Open Source Software:** Open scholarship embraces open science principles and practices, while also promoting open data sharing, open source software utilization, and their integration across diverse scholarly activities, including teaching, learning, and public engagement. | ||
* **Open Scholarship fosters Open Science, Open Data, and Open Source Software:** By advocating for openness in academia, open scholarship encourages the adoption of open science, open data, and open source software practices, fostering a culture of transparency and collaboration. | ||
* **Open Source Software enables Open Science and Open Scholarship:** The use of open source software tools and platforms facilitates open science practices, such as reproducible research and open collaboration, while also supporting open scholarship activities like open publishing and open educational practices. | ||
* **Open Data and Open Science drive Open Source Software development:** The availability of open data and the need for open, transparent, and reproducible research practices fuel the development and adoption of open source software solutions tailored for scientific and scholarly purposes. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is kind of a lot to process. I think the message would be easier to comprehend if this was some kind of diagram, demonstrating interconnected-ness.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
added a diagram... still a lot to process
* Mandates the deposition of data and other digital products into designated repositories, unless specific exemptions apply. | ||
* Encourages the use of open repositories, formats, and licenses to maximize accessibility and reuse. | ||
|
||
### Open Access Mandates |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Reading over the Open Data Mandates and Open Access Mandates, I think they are somewhat tangled together. For example, "NSF Data Sharing Policy (2023)" has elements of open data mandate and open access mandate. The split between the two categories seems arbitrary. I wonder if it should just be one sub-section: Open Data and Open Access Mandates, listing out all of these mandates. Adding links to those policies would be useful.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
i tried separating them out... wouldn't mind perspectives from you and @yashb196 if this is more or less confusing.
## Key Practices of Research Software Engineering | ||
|
||
Research software engineering involves the development, maintenance, and management of software used in academic and scientific research. Research software engineering improves on naive research software development by embracing rigorous software engineering best practices intended to make projects more sustainable, secure, efficient, and adaptable. There are significant overlaps between research software engineering and open source software in both required practices as well as good practices. To ensure high-quality, reproducible, and sustainable research software, the following practices are commonly employed in research software enineering: | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This list is not really unique to research software engineering. These are general good practices of software engineering (with the addition of community engagement, which comes from the open source aspect). I'm not sure what I'm suggesting here, just an observation.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
borrowing this observation to improve the text.
@yashb196 let's also add links to external sites that are authoritative definitions and resources. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@yashb196 you've found some great links! if you can find a place that makes sense to link to content from https://verso.w3.uvm.edu/, that would be good. We have told our funders we will work with them to develop resources, and cross link were possible. It would also be good to link to https://curioss.org/ somewhere, as we are a member and want to support all their efforts.
docs/open/open.md
Outdated
|
||
Open source software enables collaborative research and sustainable innovation. | ||
|
||
[Open source software is based on a set of principles and practices](https://aws.amazon.com/what-is/open-source/). The most obvious practice is making the human-readable "source" code for software freely available for use, study, modification, and distribution. This fosters transparency, collaboration, and continuous improvement. Open source principles promote transparency by making code openly accessible, aligning with reproducibility goals in research. Open source solutions provide cost-effective, customizable alternatives to proprietary software, promoting vendor independence and long-term sustainability. The collaborative nature of open source communities drives sustained innovation and robust software development through diverse contributions and knowledge sharing. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@yashb196 it would be better if we could point to a neutral third party source. I would be okay with just pointing to the OSI definition of open source (https://opensource.org/osd). We can also consider pointing to that definition for "principles" and some other document for "practices"
My goal here is to create a SLU-specific info source. Ultimately I'm envisioning this as having more tools and resources to enable faculty to engage with these areas. It probably needs some additional content for industry-audiences. In other words, this is just a start.