ddev / ddev.com

Astro source code used to generate the static, public ddev.com site.
https://ddev.com
Apache License 2.0
11 stars 19 forks source link

Explanation/promotion of contributor/maintainer opportunities #50

Open rfay opened 1 year ago

rfay commented 1 year ago

There are so many opportunities for contributors at many levels in DDEV. We need to make it clear what they are.

DDEV is a mix of many different technologies, including Go, Linux, Bash, Docker, PHP, Python, and many others, and has an extensive automated testing and CI system that must be maintained. In addition, the DDEV Add-on ecosystem uses a variety of technologies including bash and PHP. We need maintainers for all of these, and mentorship is available for those who want to learn. Paid work is available for those who want to commit to work beyond the basics.

Bing suggests these strategies: I'm glad you're interested in DDEV and want to spread the word about it. Here are some ideas on how to explain the opportunities available to potential contributors and maintainers:

I hope these ideas help you explain the opportunities available to potential contributors and maintainers of DDEV. Good luck with your project! 😊

Source: Conversation with Bing, 5/1/2023 (1) How to attract new contributors to your open source project - FreeCodecamp. https://www.freecodecamp.org/news/how-to-attract-new-contributors-to-your-open-source-project-46f8b791d787/. (2) 10 tips for onboarding open source contributors. https://opensource.com/article/19/12/open-source-contributors. (3) How to attract new contributors to your open source project. https://medium.com/free-code-camp/how-to-attract-new-contributors-to-your-open-source-project-46f8b791d787. (4) Attract contributors to your open source project with authenticity. https://opensource.com/article/22/6/attract-contributors-open-source-project. (5) 7 strategies for success when contributing to open source. https://opensource.com/article/22/1/open-source-contributions-career.

mattstein commented 1 year ago

This is exactly what I took a stab at with the Support DDEV page, where those calls to action should be resoundingly clear. And showcasing supporters on the homepage. The Get Started page is my best attempt to reduce setup friction and make it easy for someone to try DDEV.

So I’m not sure how to make this actionable or why it would start with this front-end project.

Two prerequisites I’d like to see:

  1. A clear, honest description of what DDEV is and who it’s for. It should probably include what it’s not. It now supports Python and Node.js, for example, but is that support as thorough and comprehensive as for PHP? (And do all the options and documentation support those audiences equally?) Starting here would help shape further efforts to ask people to contribute.
  2. Strategically optimizing messaging. On my list right now, for example, is to improve ddev.com, the documentation, and ddev/ddev’s project URL and readme. These all make different audience assumptions and point to competing explanations of how to contribute. We should be channeling people to our best writing and not saying the same thing a little differently in several places. It doesn’t matter how well something’s described if it’s not organized for the right person to find it at the most opportune time.
rfay commented 1 year ago

"Support DDEV" is awesome, but it's aimed at the general community/contribution angle - which is fundamental.

But it doesn't say "We want maintainers who can step in over the long term to take responsibility for parts of the project and who can also be paid for their effort". I want to figure out how to communicate that clearly, as it's a fundamental part of achieving long-term sustainability for the project.

The reason I open the issue here is to think about how to explain that on ddev.com

Thanks for having number 2 on your list, it's a great initiative of course.

I probably don't agree that the (valid) items you list as prerequisites are actually prerequisites for this initiative.

mattstein commented 1 year ago

"Support DDEV" is awesome, but it's aimed at the general community/contribution angle

I may have missed the mark, but it should be the canonical starting point for anyone wanting to get involved beyond using DDEV. Whatever this long-term maintainer solicitation should be, it should be referenced from that page at least.

I probably don't agree that the (valid) items you list as prerequisites are actually prerequisites for this initiative.

We can disagree, then. From my perspective as a potential contributor or maintainer, you’re inviting me to get on the bus without telling me where it’s going.

rfay commented 1 year ago

Absolutely agree that maintainership opportunities would be at least mentioned on the "support ddev" page, and maybe that's just where the CTA belongs.

rfay commented 1 year ago

I do hope you understand I'm not asking you to do this. Just starting the conversation to do it, with your invaluable input.

rfay commented 1 year ago

Add a banner advertising maintainer opportunities.