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
Added the Introduction to the Contributor Journey Research #121
Conversation
directory naming changed
Welcome @prajjwalyd! It looks like this is your first PR to knative/ux 🎉 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@prajjwalyd this looks good to me! As discussed in the last UX WG meeting we will leave this open until the next UX WG meeting so others can review it, and we will approve as a group at the meeting.
Thanks for your work on this!
/cc @Leo6Leo @zainabhusain227 @mmejia02 @aliok Please leave comments! We'll do final approval and merge at the next WG meeting, but it would be great to request any changes before then |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Just left some my thoughts, the intro is well-structured, great start @prajjwalyd !!
- Gather insights into the onboarding process for new contributors to Knative. | ||
- Explore the experiences of both retained and departed contributors. | ||
- Identify pain points and areas of dissatisfaction throughout the contributor journey. | ||
- Investigate the effectiveness of existing resources and documentation for contributors. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Just a thought: Explore with Existing Literature
Briefly mentioning existing research or literature on open-source contributor engagement and retention could be helpful. Maybe there are some good research or good practice happening in other open source projects.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Just added a whole new 'Methods' section from my drafts!
- Factors such as perceived value of contributions, prospective future opportunities, and alignment with personal or professional goals influence contributors' decisions to remain active in the project. | ||
- Contributors may disengage due to challenges like unclear contribution processes, technical knowledge/expertise barriers, insufficient/delayed feedback, lack of recognition, community integration issues, etc. Additionally, heavy workloads, limited free time, personal commitments, or simply a change of plans may also contribute to disengagement. | ||
|
||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Consider adding a section on the potential impact of your research findings and how you envision the implementation of your recommendations within the Knative community could be cool? This not only shows the practical relevance of your research but also can help in convincing the community.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
covered this point in the 'Abstract' section.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is a great start @prajjwalyd - awesome work! I just left a few comments where I was confused or unsure of a few sentences.
@@ -0,0 +1,31 @@ | |||
## Abstract: | |||
Knative is a vital tool in the open-source and cloud-native ecosystem, enabling the development of enterprise-level serverless and event-driven applications. However, its complexity poses challenges for both new contributors and maintainers. Providing guidance consumes valuable maintainer time, resulting in challenges when contributors leave after limited engagement. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm not totally sure about the last two sentences on this line. They seem to state your hypotheses as facts, when we are actually seeking to understand what the challenges are.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
just made some changes to this part. please review.
## Research Goals: | ||
- Understand the current contributor journey within Knative. | ||
- Identify factors that contribute to contributors staying or leaving the Knative community. | ||
- Highlight areas of the contributor experience that can be improved to increase contributor retention and propose ways to improve those areas. | ||
|
||
## Objectives: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
What is the difference between research goals and objectives?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Goals are like the bigger picture, while objectives are the smaller tasks to make those goals happen...
For eg. to achieve the goal of understanding the current contributor journey within Knative (1st goal), there are a few potential objectives (1, 2 and to some extent, the 3rd one too).
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
/lgtm
/approve
Thanks @prajjwalyd - great work!
[APPROVALNOTIFIER] This PR is APPROVED This pull-request has been approved by: Cali0707, prajjwalyd The full list of commands accepted by this bot can be found here. The pull request process is described here
Needs approval from an approver in each of these files:
Approvers can indicate their approval by writing |
Changes
The introduction contains:
/kind documentation
Fixes #
Release Note
Docs