FIX: Update the "intro" section of the peer review guide

[lwasser]

This PR updates and cleans up a lot of content in the About section of the peer review guide. It includes

• A reorganization of content related to peer review overview
• It begins to deprecate the code of conduct in favor of it living in our governance docs pyopensci.org/governance/code-of-conduct see issue here for more
• It adds an explicit benefits of peer review section
• It adds a technical scope criteria to our reviews in the instance that we have a forked repo where upstream isn't independently sourced.

[NickleDave]

The peer review guide is really coming along and I'm excited to see it get to this point. I see where you are going and I hope my review helps you get there a little easier. 🚀 🐍 ➕ 🧑‍🔬

[Batalex]

The template is well laid out! Would there be a legitimate interest in knowing if the submitting author is committing to the package's maintenance at this point?

Edit: Ok, the 1-2 year(s) of commitment is mentioned elsewhere

[lwasser]

good point. @Batalex do you think we should add that to the presubmission template as a link ? we just want to avoid people trying to publish a package (a one time activity) and be done vs vet it and maintain over time.

[Batalex]

I took the liberty of submitting a PR: pyOpenSci/software-submission#66

[lwasser]

Thanks! i'll look at that PR today as well. going to focus on this pr first and then your pr in software review! thanks @Batalex i do think it's good to set expectations early. otherwise someone would get to the review and maybe walk away then. it saves us all time to tell them early what we expect :) excellent feedback

[lwasser]

ok @Batalex @arianesasso @NickleDave i've addressed (i think) all of your comments. please feel free to have a look again. i'm going to add a zenodo file to this repo in another PR with your names in it. thank you for all of the great feedback I think it really improved this section of our peer review guidebook

[lwasser]

oh phew! what a great round of reviews. Thank you everyone!
I am merging this. YES it has a red X.

This is there because
3/4 links are in this PR so they don't exist online. There is a way to fix this with html proofer I just haven't had time to implement it yet. The 4th is the code of conduct which is in governance. there is a PR open for it but I need to have the board review and OK it. So that is coming soon. Maybe i'll work on it a bit more today actually to get that moving as it's important.

for now i'm merging this!! yahoo!

[lwasser]

The peer review guide is really coming along and I'm excited to see it get to this point. I see where you are going and I hope my review helps you get there a little easier. 🚀 🐍 ➕ 🧑‍🔬

@NickleDave yay!! i'm glad that you see where this is going! and so appreciative of all your feedback and help !! you're definitely helping me and pyOpenSci get to where we want to be!!