NMFS Open Sci Contributor Guide"
The NMFS Open Science GitHub organization (nmfs-opensci) contains repositories and content related to supporting Open Science activities at NOAA Fisheries. The types of repositories it contains include
- Repositories for Open Science community groups such as user groups. An example is the NMFS R User Group repository and homepage.
- Repositories for governance groups for Open Science and collaborations platforms.
- Repositories for Open Science or training webinar series
- Template repositories that NOAA Fisheries GitHub users and organizations. For example: NMFS specific packages, Quarto websites or books, blank repositories with disclaimers and licenses.
- Repositories related to NMFS Open Science talks and workshops
Contacts
The admins for NMFS Open Science are
Code of Conduct
See the NMFS Open Sci Code of Conduct here
Contributing
Ways to contribute
For public repositories, anyone can contribute issues and discussions (if enabled). Public repositories can also be forked and a pull-request submitted.
Only NOAA staff (with current NOAA email) can be an owner of a repository on nmfs-opensci or be a contributor with direct push permissions. Non-NOAA GitHub users can be added as contributors to public and private repositories, but with review turned on (i.e. no direct push access).
NOAA users
NOAA staff who wish to contribute to nmfs-opensci
- need to have 2FA turned on
- should review the NMFS GitHub Checklist which outlines the types of material that are not allowed on GitHub
Then contact the nmfs-opensci admins to discuss the repository you would like to create and manage on nmfs-opensci.
Disclaimers and licenses
See the template repo for the standard disclaimers to include on repositories. See the NMFS GitHub Guidelines section on Readme, disclaimers and licenses. All repositories created on nmfs-opensci will also have the Code of Conduct added to the repository; this happens automatically.
NOAA branding
The nmfs-opensci GitHub organization is not intended for official NOAA communications and NOAA logos should not generally be used on repositories.
Maintenance and Archiving
GitHub Pages
You will need to turn on GitHub Pages if desired using Settings > Pages. See the NMFS R UG repo of a Distill website with a GitHub Action that builds the page automatically. See the Resource Book as an example of a Quarto website with a GitHub Action to build the page.
Issues and Discussion
Repository owners are welcome to use these features. However if you do not need them, you might want to turn them off. The nmfs-admins will not be monitoring issues or discussions on repositories.
Back-ups
The nmfs-opensci admins do not provide back-ups of content and cannot guarantee the content on the GitHub organization will persist. Repository owners should back-up content outside of the nmfs-opensci GitHub organization.
Archiving
The nmfs-opensci admins reserve the right to archive repository content that is no longer in use or that is abandoned. The admins may also re-organize content that was created for teaching, talks, or workshops.