Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: minor text tweaks

I was chatting on slack Slack, having a conversation I've had many times before: how can we better guide potential new contributors to find the right place where they can start working?  ComDev theoretically is for mentoring and outreach, but the main way our few regular volunteers do this is manually replying to emails, effectively asking people do do  some research themselves over here, there, or there.  That method doesn't scale, and isn't as helpful to less-self-starting volunteers who might need more help even finding a project that they might be interested in.

So why don't we automate the basic question & answer portion of helping a newcomer?  What languages do you program in - or only docs?  What kinds of technologies are you interested in?  What other open source or project development experience do you have?  And so on.... these These questions all take time to consider and reply to if the newcomer asks for more help, but our volunteer energy isn't scalable or consistent.

What if we came up with questions and some pathways to gather as much of this information as we can up front, and then use the output to give the person some much more specific guidance of about which Apache projects might interest them?  If we can make the questions inviting and interesting, they might also spur a newcomer to explore more areas, or they might click additional info links we include in those pathways.

...

  • How experienced are you with open source contributions?
    • (several levels from newcomer, to existing committer on another project)
  • What languages do you want to contribute in?
    • First slide is high level: compiled languages (C, C++, etc.); scripting languages (python, ruby, etc.); databases; web frameworks (javascript, css, tailwind, etc.); website or documentation or designing; testingQA, including test design.
    • Based on the answers to the After answering first slide, then ask for more details about each set of languages or areas the person mentioned.  This There might be multiple follow-ups.
  • What technologies are you interested in?
    • The categories here need to be listed from the newcomer's perspective.  Maybe Front end frameworks; Back end frameworks; Databases; Messaging; Scientific; or the like.  (This needs some thought, both to be useful for a newcomer, but also to then know which projects to guide them to.)
  • Break slide: we could include a few "Did you know?" slides with selected useful links to some FAQs in the middle if desired.  Provide short FAQ type headers that let someone link out to some useful resource elsewhere along the way.
  • How do you want to contribute?
    • Github GitHub only; Github GitHub or someplace else; Subversion or wherever the project lives.  This is critical to classify people who only see GitHub PRs as a way to contribute.
  • What other questions might we want to ask a newcomer?  Either to help them find specific projects that really meet their interests, or to help them think about why and how they really want to contribute?

Once the data is all saved, use the intersection of various sets to show them a specific subset of projects.a.o PMCs that might meet their desires.  This obviously will take some work to code, and also relies on project.a.o data, but that's something we could improve separately if this tool gains traction.  In particular, if we get people excited about this new contributor funnel (and can show it's its usage logs or the like), that would be incentive for projects to update their projects.a.o data.

...

  • Permissively licensed
  • Low maintenance server/engine/whatever tool, that ComDev or Whimsy can install without having to worry about maintenance
  • Fully templated questions & paths, so that it's easy to configure the pathways later, or so that we could build new pathways (perhaps for designers, docs, etc.) without needing to know programming
  • Runs on any browser, with no server storage. Bonus points if a user can come back to finish completing a questionnare questionnaire (cookies, local storage, whatever).
  • Basic skinnable features so it can roughly match existing ComDev website
  • Stretch: translatable engine text (on buttons, etc.) and in scripting