✨ add guide to community health files

[ctcpip]

resolves #1263

[tobie]

We need to move the IP guidance file in this repo too, not sure what it's doing in /governance

[ctcpip]

@tobie, my brother you approved the PR that moved it from root 😄 -- #841

[tobie]

@tobie, my brother you approved the PR that moved it from root 😄 -- #841

Lol. @joesepi and I had the same thirst for cleaning things up around the same time but we sync'ed poorly. The organization of content in the repo and in the readme are all off as a result. :D

[mhdawson]

LGTM

[tobie]

Thanks for getting this started, @ctcpip, this is great!

A few (high-level) comments:

• Let's avoid setting policy in a guide as much as possible, especially if it conflicts with policy set elsewhere (e.g. the onboarding checklist)
• I think it's good to be pragmatic about the fact that every project is on GitHub, but we also want to acknowledge when things are github-specific and favor more neutral options whenever possible.
• Let's also include where the charter goes and so maybe rename the guide accordingly? "Project repository structure"?
• We use the term project to define a foundation project, so let's avoid mixing GitHub-specific organization/project lingo in here as much as possible.

[ctcpip]

@tobie

• Let's avoid setting policy in a guide as much as possible, especially if it conflicts with policy set elsewhere (e.g. the onboarding checklist)

Is this a general comment on future changes or are there specific instances in the document that are problematic?

• I think it's good to be pragmatic about the fact that every project is on GitHub, but we also want to acknowledge when things are github-specific and favor more neutral options whenever possible.

#1334 (comment)

• Let's also include where the charter goes and so maybe rename the guide accordingly? "Project repository structure"?

We're not prescribing how their repository should be structured -- only guidance on community health files.

• We use the term project to define a foundation project, so let's avoid mixing GitHub-specific organization/project lingo in here as much as possible.

Project refers to open source project / foundation project. A GitHub Project is something else entirely.

[ctcpip]

The latest changes address all comments -- and in a way that I hope folks will find satisfactory. Thanks for everyone's help and feedback!

[ctcpip]

per my last comment, I am going to merge this. discussed with Tobie earlier today and concerns are addressed. if not, let's follow up with a new issue and PRs. I already have some new content to add to this, and will follow up. thanks again everyone!