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

Facilitate onboarding of new contributors #1479

Open
Daniel-Mietchen opened this issue Jul 4, 2021 · 2 comments
Open

Facilitate onboarding of new contributors #1479

Daniel-Mietchen opened this issue Jul 4, 2021 · 2 comments
Labels
documentation hopefully helpful explanations of how things work good first issue An issue suitable to get your feet wet for contributing to Scholia outreach Scholia team engaging with others usability trying to minimize bad experiences while using Scholia
Milestone

Comments

@Daniel-Mietchen
Copy link
Member

There are several components to this:

  • good documentation both within the code as well as in the repo (e.g. README) and issues (e.g. labels)
  • interoperability (e.g. indentation style)
  • behavioural guidance (e.g. code of conduct or issue templates)

Some more points in this post (albeit with a certain bias for Node).

@Daniel-Mietchen Daniel-Mietchen added documentation hopefully helpful explanations of how things work usability trying to minimize bad experiences while using Scholia labels Jul 4, 2021
@Daniel-Mietchen Daniel-Mietchen added this to the 31 July 2021 milestone Jul 4, 2021
@Daniel-Mietchen Daniel-Mietchen added this to Documentation in Robustifying Scholia Jul 4, 2021
@Daniel-Mietchen
Copy link
Member Author

We already have

@Daniel-Mietchen Daniel-Mietchen added outreach Scholia team engaging with others good first issue An issue suitable to get your feet wet for contributing to Scholia labels Jul 12, 2021
@Daniel-Mietchen Daniel-Mietchen pinned this issue Jul 30, 2021
@Daniel-Mietchen
Copy link
Member Author

Here is some more guidance:

  • Ten simple rules for helping newcomers become contributors to open projects
    • Rule 1: Be welcoming
    • Rule 2: Help potential contributors evaluate if the project is a good fit
    • Rule 3: Make governance explicit
    • Rule 4: Keep knowledge up to date and findable
    • Rule 5: Have and enforce a code of conduct
    • Rule 6: Develop forms of legitimate peripheral participation
    • Rule 7: Make it easy for newcomers to get started
    • Rule 8: Use opportunities for in-person interaction—With care
    • Rule 9: Acknowledge all contributions
    • Rule 10: Follow up on both success and failure

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation hopefully helpful explanations of how things work good first issue An issue suitable to get your feet wet for contributing to Scholia outreach Scholia team engaging with others usability trying to minimize bad experiences while using Scholia
Projects
Robustifying Scholia
  
Documentation
Development

No branches or pull requests

1 participant