Skip to content
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

onboarding meta questions #398

Closed
jorydotcom opened this issue Nov 5, 2019 · 8 comments
Closed

onboarding meta questions #398

jorydotcom opened this issue Nov 5, 2019 · 8 comments
Labels
onboarding tracking onboarding for new/incubating projects

Comments

@jorydotcom
Copy link
Contributor

Question 1:
Should all issues related to onboarding be moved to the onboarding repo, or just the issues specific to onboarding individual projects?

Question 2:
Looking at required files, such as a code of conduct file, do we also require uniformity in naming - 'CODE_OF-CONDUCT.md' vs. 'CoC.md' for example?

@mhdawson
Copy link
Member

mhdawson commented Nov 6, 2019

Question 2:

I think ideally we'd go for consistency. Do we think it will be an issue to ask projects to use common naming for the Code of conduct?

Question 1: my preference is macro questions like Question 2 be in this repo, and the ones that are specific to on-boarding a specific project be in the on-boarding repo.

@ljharb
Copy link
Member

ljharb commented Nov 7, 2019

I think GitHub prefers CODE_OF_CONDUCT.md, so I'm not sure why anyone would want a different filename.

@jorydotcom jorydotcom added cross-project-council-agenda onboarding tracking onboarding for new/incubating projects labels Nov 7, 2019
@tobie
Copy link
Contributor

tobie commented Nov 7, 2019

Question 1: my preference is macro questions like Question 2 be in this repo, and the ones that are specific to on-boarding a specific project be in the on-boarding repo.

Thank you for clarifying this. I've been wondering about this as I was filing issues about the onboarding process in this repo.

Additionally, and that ties in to #400, are project-specific issues expected to be filed in the project's own org (as AMP is doing), or on the onboarding repo, or is that tbd on a case per case basis?

@mhdawson
Copy link
Member

mhdawson commented Nov 7, 2019

If github perfers CODE_OF_CONDUCT.md, then that is what I'd want as well.

@mhdawson
Copy link
Member

mhdawson commented Nov 7, 2019

Additionally, and that ties in to #400, are project-specific issues expected to be filed in the project's own org (as AMP is doing), or on the onboarding repo, or is that tbd on a case per case basis?

My personal take would be that anything that needs significant CPC interaction it would be make sense to be in the onboarding repo. If its something that does not need CPC interaction then the project repo makes more sense. In some cases you might want a tracking issue in the onboarding repo if there is cross-over where most of the work is within the project but you want some CPC input/visibility.

@tobie
Copy link
Contributor

tobie commented Nov 7, 2019

My personal take would be that anything that needs significant CPC interaction it would be make sense to be in the onboarding repo. If its something that does not need CPC interaction then the project repo makes more sense. In some cases you might want a tracking issue in the onboarding repo if there is cross-over where most of the work is within the project but you want some CPC input/visibility.

Thanks @mhdawson. Where would be the right place to document this practice?

@mhdawson
Copy link
Member

mhdawson commented Nov 7, 2019

Not 100% sure. Two ideas are either as a document in the top level of the CPC level repo or in the README.md for the onboarding repo. Not sure which will be more visible, be found most easily by the right people.

@joesepi
Copy link
Member

joesepi commented Dec 3, 2019

To be clear, based on previous CPC meeting conversations:
Q1: Onboarding repo is place for all onboarding issues and documentation. Exceptions may arise but should be dealt with as they come.
Q2: We should follow Github naming conventions. Per COC, @mhdawson will update CoC proposal to advise there but otherwise, we will not be explicit

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
onboarding tracking onboarding for new/incubating projects
Projects
None yet
Development

No branches or pull requests

5 participants