website
website copied to clipboard
asyncapi
Adding a new contributing section onto the website
Reason/Context
Please try answering a few of those questions
Feels like we have "How to contribute" and our guidelines all over GitHub, I wonder if it would help if we added a new "How to Contribute" under the Community section on the website?
Maybe a new page, or maybe just a link somewhere helping people step by step on how to get started, the landscape of the projects etc.
I think it might help encourage people to start exploring and contributing more?
Any thoughts on this @alequetzalli?
yes yes yes!
it is all about structure, how to structure it.
also, let us use Contributor-first meetings maybe to brainstorm.
I come from many backgrounds, one of these is Product Management, and I was thinking this could be done the same way you plan a product, you have user journeys, different personas in plan.
what if we structure it this way? @alequetzalli work on this section https://github.com/asyncapi/#-contribute-to-asyncapi inspired me to think about it through the contribution bot and the list of possible contributions. So we have a journey for review-only or for docs or for maintainance and we then provide a set of materials, step by stem on how to become one? Ya know what I mean?
it is all about structure, how to structure it.
Exactly.
also, let us use Contributor-first meetings maybe to brainstorm.
Yeah, that's a great idea. I'm happy to jump on the call next time. I will try and make this evening one, but not sure I can yet!
different personas in plan.
Yeah I quite like this, "How can I contribute as a ....", (Developer, Product owner, Business Analyst etc), might be interesting, as I assume we want to allow AsyncAPI to be built and developed by people from many backgrounds.
what if we structure it this way?
Yeah my initial thoughts maybe some nice UX on the website.
"Contributing Link" > "Select your background or how you want to contribute (Code, Docs etc)" > Maybe a list of issues we have open and how you can get started?
Be awesome to have the issues on the website somehow, maybe we could grab the ones that have been tagged, somehow.
Also
Maybe we can have a section on the website for these Contributor First meetings, or maybe a dedicated video we could do to help people contribute first, maybe the video could:
- Describe how to help
- Describe why you could/need to help
- Anything else.....
Would be pretty cool!
Another random idea, @derberg the Google sheet with the issues you listed and shared today.
Maybe we could have a new page on the website dedicated to Hacktober fest that can render these issues (pull them down and render them SSR or something).
@derberg @boyney123 Oh hi 😸 ...agree, this seems like it's needed, especially from my own impression too! So cool you brought it up! So on my end, what came to mind was adding a READme on the user journeys such as:
- How can I contribute as a Reviewer?
- How can I contribute as a Code Owner?
- How can I contribute as a speaker/blogger?
- How can I contribute as a Docs contributor?
Not sure if my idea is the way to go either, just sharing what came to my mind after reading all the other idea so far. 😀👍🏽
I would love to talk more about this! My concern with the Contributor First meeting is that people can't talk, only the host talks. Responding into a chat box shortly isn't really the same? I myself would not feel heard that way, it would be odd. It seems better for a meeting that people attend in person, such as the bi-weekly Tuesday SIG meetings?
- How can I contribute as a Reviewer?
- How can I contribute as a Code Owner?
- How can I contribute as a speaker/blogger?
- How can I contribute as a Docs contributor?
Yeah I like it @alequetzalli, I'm going to throw up a new page in a PR with some titles and dummy content so we can get a feel for what it would look like and maybe take it from there, shouldn't take me too long 👍
Edit: I made a PR with a quick link https://github.com/asyncapi/website/pull/415, let me know your thoughts :)
My concern with the Contributor First meeting is that people can't talk, only the host talks
There are different preferences, some people prefer to interact through chat, some are open and do not mind discussing stuff publicly with shared video and audio. I think we need to approach different people with different preferences. First Contributor First meeting was like SIG, now I do stream with option for folks to join me if they want. So far it works fine. Also keep in mind this is still an experiment. It is scheduled for October only, then I will gather feedback, also switch focus to conference anyway, then prepare for next season.
This issue has been automatically marked as stale because it has not had recent activity :sleeping:
It will be closed in 120 days if no further activity occurs. To unstale this issue, add a comment with a detailed explanation.
There can be many reasons why some specific issue has no activity. The most probable cause is lack of time, not lack of interest. AsyncAPI Initiative is a Linux Foundation project not owned by a single for-profit company. It is a community-driven initiative ruled under open governance model.
Let us figure out together how to push this issue forward. Connect with us through one of many communication channels we established here.
Thank you for your patience :heart:
![github-actions[bot] avatar](https://avatars.githubusercontent.com/in/15368?v=4 "Published by a pub.dev verified publisher"){kind=small}
This issue has been automatically marked as stale because it has not had recent activity :sleeping:
It will be closed in 120 days if no further activity occurs. To unstale this issue, add a comment with a detailed explanation.
There can be many reasons why some specific issue has no activity. The most probable cause is lack of time, not lack of interest. AsyncAPI Initiative is a Linux Foundation project not owned by a single for-profit company. It is a community-driven initiative ruled under open governance model.
Let us figure out together how to push this issue forward. Connect with us through one of many communication channels we established here.
Thank you for your patience :heart:
@derberg @alequetzalli Is it still needed as we have CONTRIBUTING.md file? https://github.com/asyncapi/website/blob/master/CONTRIBUTING.md
This issue has been automatically marked as stale because it has not had recent activity :sleeping:
It will be closed in 120 days if no further activity occurs. To unstale this issue, add a comment with a detailed explanation.
There can be many reasons why some specific issue has no activity. The most probable cause is lack of time, not lack of interest. AsyncAPI Initiative is a Linux Foundation project not owned by a single for-profit company. It is a community-driven initiative ruled under open governance model.
Let us figure out together how to push this issue forward. Connect with us through one of many communication channels we established here.
Thank you for your patience :heart: