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

Added the Introduction to the Contributor Journey Research #121

Merged
merged 2 commits into from Mar 25, 2024
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
31 changes: 31 additions & 0 deletions user-research/contributor-research/Introduction.md
@@ -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.
Copy link
Member

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.

Copy link
Contributor Author

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.

This research aims to understand why some individuals sustain active involvement in Knative while others contribute sporadically or disengage entirely. The ultimate goal is to identify aspects of the contributor experience that could be improved to enhance contributor retention and propose actionable recommendations to tackle these issues.

## 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:
Copy link
Member

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?

Copy link
Contributor Author

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).

- 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.
Copy link
Member

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.

Copy link
Contributor Author

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!

- Determine potential interventions or improvements to enhance the contributor experience and retention rate.

## Key Research Questions:
- What motivated contributors to join the Knative community initially and what were their expectations regarding their involvement in the projects?
- What were the primary challenges they encountered during the onboarding process? (e.g. selecting the right project and right issues to contribute to as per one’s technical expertise)
- How did contributors interact with the Knative community, and what were their experiences regarding communication and collaboration within the community
- At what stage did certain contributors typically begin to disengage from the community?
- What factors lead contributors to discontinue their engagement with Knative, and what practical recommendations do they offer to enhance the contributor experience, fostering a more sustainable and active ecosystem?
- Are there any differences in experiences between contributors with varying levels of technical expertise or backgrounds?
- What is missing in the current contributor experience of Knative as compared to some other well-established open-source projects?

## Hypotheses:
- Contributors who have a positive onboarding experience, are proactive, and receive clear guidance and support, are more likely to stay engaged with the Knative community.
- 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.


Copy link
Member

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.

Copy link
Contributor Author

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.