search

nmfs-opensci / Contributor-Guide

NMFS Open Sci Contributor Guide
https://nmfs-opensci.github.io/Contributor-Guide/
Creative Commons Zero v1.0 Universal
0 stars 1 forks source link

v1.0 of nmfs-opensci contributor guide #1

Open eeholmes opened 1 year ago

eeholmes commented 1 year ago

@k-doering-NOAA @jmlondon First stab at a very simple and to the point GH org contributor guide. https://nmfs-opensci.github.io/Contributor-Guide/. Idea is to edit this and to have it (or a copy) be a template that other GH org admin can use as a simple template for their orgs.

To do

k-doering-NOAA commented 1 year ago

Good idea! One thing I noticed is the contributor covenant is an older version - is there a good reason for that? Here's an example Christine and I put together to use for FIT and FIMS (we also added a reporting form to allow reporting anonymously - thanks to openscapes for giving us the space to do this! :) ) https://github.com/nmfs-fish-tools/Resources/blob/main/CODE_OF_CONDUCT.md

k-doering-NOAA commented 1 year ago

The nmfs-opensci GitHub organization is not intended for official NOAA communications and NOAA logos should not generally be used on repositories.

I was honestly surprised by this! nmfs-opensci seems like it should be as "NOAA branded" as the FIT is... maybe a long-form discussion for us to have sometime? :)

eeholmes commented 1 year ago

@k-doering-NOAA Thanks for catching the old CoC. I updated to the newest one.

Re

The nmfs-opensci GitHub organization is not intended for official NOAA communications and NOAA logos should not generally be used on repositories.

GitHub use is covered under the Social Media policy per the last GitHub policy, and use of logos requires applying to use those, which I have not done. https://www.commerce.gov/about/policies/social-media. So I didn't want us to run afoul of that. My take-home from the social media policy is that one needs to be careful not to present content on social media as an official communication from NOAA.

Also technically NMFS Open Science has not been announced yet, so we are not a NOAA initiative yet. I need to work with my OST contact about getting a webpage up on fisheries.noaa.gov, which will make it feel more official.

k-doering-NOAA commented 1 year ago

ok, good to know!

What other feedback would be useful for you? Editing? Or just broader comments, such as about the Code of Conduct?

eeholmes commented 1 year ago

The following would be good feedback. Viewing this as a "template" of a minimal GH org Contributor Guide: