From af0ebdd8493749c594a8ba41091e25acd7e59875 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 2 Sep 2023 16:46:34 -0400 Subject: [PATCH 01/69] docs: add explainer page about Dev Card feature --- docs/community/dev-card.md | 0 sidebars.js | 1 + 2 files changed, 1 insertion(+) create mode 100644 docs/community/dev-card.md diff --git a/docs/community/dev-card.md b/docs/community/dev-card.md new file mode 100644 index 00000000..e69de29b diff --git a/sidebars.js b/sidebars.js index 97946ec6..ec09f9b3 100644 --- a/sidebars.js +++ b/sidebars.js @@ -22,6 +22,7 @@ module.exports = { "community/highlights", "community/insights", "community/faqs", + "community/dev-card", ], }, { From 98f6a7283456c654291fd5fe5bfc766cd7e0183f Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sun, 3 Sep 2023 00:33:50 -0400 Subject: [PATCH 02/69] docs: add explainer page about the dev card --- docs/community/dev-card.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/community/dev-card.md b/docs/community/dev-card.md index e69de29b..fb5dd05a 100644 --- a/docs/community/dev-card.md +++ b/docs/community/dev-card.md @@ -0,0 +1,9 @@ +--- +id: dev-card +title: 'Showcase your open source stats with your dev card' +sidebar_label: 'Dev Card' +keywords: +- dev-card +--- + +The Dev card feature is what we like to call your "open source business card". It displays the amount of pull requests you create, repositories you contribute to, and how often you are active in the community. Whether you are a person who's just beginning their open source journey or a maintainer looking for more contributors and/or sponsors, the dev card is a great way to show your audience how active you are in the community. From 4dc016e1486f2c1fa1d0c27f3f25b24a23900e08 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sun, 3 Sep 2023 01:00:42 -0400 Subject: [PATCH 03/69] Revert "docs: add explainer page about the dev card" This reverts commit 98f6a7283456c654291fd5fe5bfc766cd7e0183f. --- docs/community/dev-card.md | 9 --------- 1 file changed, 9 deletions(-) diff --git a/docs/community/dev-card.md b/docs/community/dev-card.md index fb5dd05a..e69de29b 100644 --- a/docs/community/dev-card.md +++ b/docs/community/dev-card.md @@ -1,9 +0,0 @@ ---- -id: dev-card -title: 'Showcase your open source stats with your dev card' -sidebar_label: 'Dev Card' -keywords: -- dev-card ---- - -The Dev card feature is what we like to call your "open source business card". It displays the amount of pull requests you create, repositories you contribute to, and how often you are active in the community. Whether you are a person who's just beginning their open source journey or a maintainer looking for more contributors and/or sponsors, the dev card is a great way to show your audience how active you are in the community. From f8bbc837133fa588434571053b389e48859c9c9f Mon Sep 17 00:00:00 2001 From: "codesee-maps[bot]" <86324825+codesee-maps[bot]@users.noreply.github.com> Date: Mon, 4 Sep 2023 15:21:33 +0000 Subject: [PATCH 04/69] Install the CodeSee workflow. Learn more at https://docs.codesee.io --- .github/workflows/codesee-arch-diagram.yml | 23 ++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 .github/workflows/codesee-arch-diagram.yml diff --git a/.github/workflows/codesee-arch-diagram.yml b/.github/workflows/codesee-arch-diagram.yml new file mode 100644 index 00000000..806d41d1 --- /dev/null +++ b/.github/workflows/codesee-arch-diagram.yml @@ -0,0 +1,23 @@ +# This workflow was added by CodeSee. Learn more at https://codesee.io/ +# This is v2.0 of this workflow file +on: + push: + branches: + - main + pull_request_target: + types: [opened, synchronize, reopened] + +name: CodeSee + +permissions: read-all + +jobs: + codesee: + runs-on: ubuntu-latest + continue-on-error: true + name: Analyze the repo with CodeSee + steps: + - uses: Codesee-io/codesee-action@v2 + with: + codesee-token: ${{ secrets.CODESEE_ARCH_DIAG_API_TOKEN }} + codesee-url: https://app.codesee.io From 1f148efb2d6dd547de2679e0dbcdd8845066c5b4 Mon Sep 17 00:00:00 2001 From: Christine Date: Wed, 3 Apr 2024 21:22:20 +0000 Subject: [PATCH 05/69] feat: adding section on growing your project Signed-off-by: Christine --- docs/maintainers/growing-your-project.md | 21 +++++++++++++++++++++ sidebars.js | 1 + 2 files changed, 22 insertions(+) create mode 100644 docs/maintainers/growing-your-project.md diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md new file mode 100644 index 00000000..e83c4e63 --- /dev/null +++ b/docs/maintainers/growing-your-project.md @@ -0,0 +1,21 @@ +--- +id: growing-your-project +title: "Growing Your Project" +sidebar_label: "Growing Your Project" +keywords: + - "maintainers" + - "guides" +--- +## Growing Your Project + +### When to grow your project + + +### How to identify new contributors and team members + + +### Recruiting team members + + +### Understanding team participation + \ No newline at end of file diff --git a/sidebars.js b/sidebars.js index 7eebed30..b9b7616f 100644 --- a/sidebars.js +++ b/sidebars.js @@ -61,6 +61,7 @@ module.exports = { "maintainers/maintainers-guide-to-open-sauced", "maintainers/understanding-repo-insights", "maintainers/understanding-contribs-insights", + "maintainers/growing-your-project", ], }, { From a3f16f9bf44d042d35464ac9e4e62d7c9969d82f Mon Sep 17 00:00:00 2001 From: Christine Date: Wed, 3 Apr 2024 21:31:33 +0000 Subject: [PATCH 06/69] Revert "Install the CodeSee workflow. Learn more at https://docs.codesee.io" This reverts commit f8bbc837133fa588434571053b389e48859c9c9f. --- .github/workflows/codesee-arch-diagram.yml | 23 ---------------------- 1 file changed, 23 deletions(-) delete mode 100644 .github/workflows/codesee-arch-diagram.yml diff --git a/.github/workflows/codesee-arch-diagram.yml b/.github/workflows/codesee-arch-diagram.yml deleted file mode 100644 index 806d41d1..00000000 --- a/.github/workflows/codesee-arch-diagram.yml +++ /dev/null @@ -1,23 +0,0 @@ -# This workflow was added by CodeSee. Learn more at https://codesee.io/ -# This is v2.0 of this workflow file -on: - push: - branches: - - main - pull_request_target: - types: [opened, synchronize, reopened] - -name: CodeSee - -permissions: read-all - -jobs: - codesee: - runs-on: ubuntu-latest - continue-on-error: true - name: Analyze the repo with CodeSee - steps: - - uses: Codesee-io/codesee-action@v2 - with: - codesee-token: ${{ secrets.CODESEE_ARCH_DIAG_API_TOKEN }} - codesee-url: https://app.codesee.io From 578aa7b9f5ec3a0f30a9cf2761345893cc003e7e Mon Sep 17 00:00:00 2001 From: Christine Date: Wed, 3 Apr 2024 23:04:58 +0000 Subject: [PATCH 07/69] eat: add explanation in "when to grow your project section --- docs/maintainers/growing-your-project.md | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index e83c4e63..30fd0aa8 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -6,13 +6,19 @@ keywords: - "maintainers" - "guides" --- -## Growing Your Project - -### When to grow your project - -### How to identify new contributors and team members - +## Growing Your Project +Growth is the the crucial aspect of a successful open source project. If you're at this stage in your open source maintainer journey, here are some things to consider when thinking of growth strategies. + +### When to grow your project + +When it comes to deciding on whether your open source project is ready to grow, consider reviewing your project's repository insights page in its Workspace page and asking yourself the following questions: +- Are there tasks that are becoming too overwhelming for me and/or team? +- How can I improve and maintaining my project's current and pending features? +If you have said yes to these questions, it's time to develop your growth strategies. If you haven't already, consider creating different teams for specific purposes. For example, you can create a docs team for documentation maintainence, a triage team for reviewing and improving issues, or a maintainer team to help you with overall oversight of the project. Once you have decided the types of teams you want to add to your project, you can create separate pages for each team in your project's Workspace page. Check out the [Creating a New Repository Insights Page](../docs/maintainers-guide.md#adding-repositories-to-your-workspace) + +### How to identify new contributors and team members + ### Recruiting team members From 012eebb8369b90a893832b10a612e6d875bfaeef Mon Sep 17 00:00:00 2001 From: Christine Date: Wed, 3 Apr 2024 23:07:12 +0000 Subject: [PATCH 08/69] fix: fix markdown error --- docs/maintainers/growing-your-project.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 30fd0aa8..0881094f 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -15,7 +15,8 @@ Growth is the the crucial aspect of a successful open source project. If you're When it comes to deciding on whether your open source project is ready to grow, consider reviewing your project's repository insights page in its Workspace page and asking yourself the following questions: - Are there tasks that are becoming too overwhelming for me and/or team? - How can I improve and maintaining my project's current and pending features? -If you have said yes to these questions, it's time to develop your growth strategies. If you haven't already, consider creating different teams for specific purposes. For example, you can create a docs team for documentation maintainence, a triage team for reviewing and improving issues, or a maintainer team to help you with overall oversight of the project. Once you have decided the types of teams you want to add to your project, you can create separate pages for each team in your project's Workspace page. Check out the [Creating a New Repository Insights Page](../docs/maintainers-guide.md#adding-repositories-to-your-workspace) +If you have said yes to these questions, it's time to develop your growth strategies. If you haven't already, consider creating different teams for specific purposes. For example, you can create a docs team for documentation maintenance, a triage team for reviewing and improving issues, or a maintainer team to help you with overall oversight of the project. Once you have decided the types of teams you want to add to your project, you can create separate pages for each team in your project's Workspace page. Check out the [Creating a New Repository Insights Page](../docs/maintainers-guide.md#adding-repositories-to-your-workspace). + ### How to identify new contributors and team members From 40120292790c5853ec14add114c5ce31cf1fcf23 Mon Sep 17 00:00:00 2001 From: Christine Date: Fri, 5 Apr 2024 00:41:45 +0000 Subject: [PATCH 09/69] docs: finish section on identifying and recruiting team members and new contributors Signed-off-by: Christine --- docs/maintainers/growing-your-project.md | 39 +++++++++++++++++++----- 1 file changed, 32 insertions(+), 7 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 0881094f..45b4a825 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -7,22 +7,47 @@ keywords: - "guides" --- -## Growing Your Project +## Growing your project + Growth is the the crucial aspect of a successful open source project. If you're at this stage in your open source maintainer journey, here are some things to consider when thinking of growth strategies. ### When to grow your project When it comes to deciding on whether your open source project is ready to grow, consider reviewing your project's repository insights page in its Workspace page and asking yourself the following questions: -- Are there tasks that are becoming too overwhelming for me and/or team? + +- Are there tasks that are becoming too overwhelming for me and/or team? - How can I improve and maintaining my project's current and pending features? +- How many stars and forks do I want to reach this time, and who can help me achieve it? If you have said yes to these questions, it's time to develop your growth strategies. If you haven't already, consider creating different teams for specific purposes. For example, you can create a docs team for documentation maintenance, a triage team for reviewing and improving issues, or a maintainer team to help you with overall oversight of the project. Once you have decided the types of teams you want to add to your project, you can create separate pages for each team in your project's Workspace page. Check out the [Creating a New Repository Insights Page](../docs/maintainers-guide.md#adding-repositories-to-your-workspace). - ### How to identify new contributors and team members - -### Recruiting team members - +Like Superman, Wonder Woman, the Flash, and Batman in ***The Justice League***, the people you bring on your team(s) and your project's contributors are key to its success, which is why picking the right people is important. When doing this process, consider going to their OpenSauced profiles and ask yourself the following questions: + +- How often do they contribute to yours and other open source projects in general? +- Are they invested in your project's success? + +Once you have your list of potential candidates, [create an Insights page for your project](../docs/maintainers-guide.md#creating-a-new-repository-insight-page), and add your candidates. From there, monitor their progress by reviewing the contributions that they post in the Highlights section. As you analyze this information, conisder using the following questions to help with this step in your open source project's growth journey: + +- How have they grown since you found their profile? +- What types of contributions does this person frequently make to yours and other open source projects? +From there, consider narrowing down your list to If you need more tips on how to pick people that can help grow your project, check out our blog post, ["How to Build Your Open Source Dream Team"](https://dev.to/opensauced/how-to-build-your-open-source-dream-team-a-guide-3i90). + +### Recruiting team members and contributors + +When you're ready to recruit your team members, consider going to their OpenSauced profiles and send them a message via the contact information they provide. +::: + +:::tip +When contacting your team members, consider doing as message such as "Hi there, we've seen your growth in this project and we think you'd be a great member to our team. Do you want to join us?" +::: + +To recruit new contributors, consider doing the following methods: +- Do posts about your new releases via social media +- Host live events via Twitch or your project's Slack or Discord servers +- Write blog posts about your project + +Regardless which method you pick, you want to excite your potential team members and new contributors, so always come with a positive attitude. ### Understanding team participation - \ No newline at end of file + From 0bbf75c1d1f0a1df640c264d2e764052166d22eb Mon Sep 17 00:00:00 2001 From: Christine Date: Fri, 5 Apr 2024 01:08:37 +0000 Subject: [PATCH 10/69] docs: finish section on monitor team participation Signed-off-by: Christine --- docs/maintainers/growing-your-project.md | 19 ++++++++----------- 1 file changed, 8 insertions(+), 11 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 45b4a825..be1f6258 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -33,21 +33,18 @@ Once you have your list of potential candidates, [create an Insights page for yo - What types of contributions does this person frequently make to yours and other open source projects? From there, consider narrowing down your list to If you need more tips on how to pick people that can help grow your project, check out our blog post, ["How to Build Your Open Source Dream Team"](https://dev.to/opensauced/how-to-build-your-open-source-dream-team-a-guide-3i90). -### Recruiting team members and contributors +### Recruiting team members and contributors -When you're ready to recruit your team members, consider going to their OpenSauced profiles and send them a message via the contact information they provide. -::: - -:::tip -When contacting your team members, consider doing as message such as "Hi there, we've seen your growth in this project and we think you'd be a great member to our team. Do you want to join us?" -::: +When you're ready to recruit your team members, consider going to their OpenSauced profiles and send them a message via the contact information they provide. If you and they have a PRO account, you can also send them invites using the [connections feature](../../docs/features-connections.md). To recruit new contributors, consider doing the following methods: -- Do posts about your new releases via social media -- Host live events via Twitch or your project's Slack or Discord servers -- Write blog posts about your project -Regardless which method you pick, you want to excite your potential team members and new contributors, so always come with a positive attitude. +- Do posts about your project's new releases via Linkedin, X(Twitter), and other forms of social media +- Host events via Twitch or your project's Slack or Discord servers +- Write blog posts about your project ### Understanding team participation +Once you have picked your official team members, it is crucial to monitior their participation to ensure that they are help the project run efficiently. You can do this by using [the team sync feature](../docs/features/workspaces.md#team-workspaces). + +![Add People](../../static/img/add-to-workspace.png) From 64704048278270af57950ecda379c29e7740354e Mon Sep 17 00:00:00 2001 From: Christine Date: Fri, 5 Apr 2024 16:51:31 +0000 Subject: [PATCH 11/69] docs: revise section on recruiting contributors --- docs/maintainers/growing-your-project.md | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index be1f6258..6459be96 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -18,16 +18,16 @@ When it comes to deciding on whether your open source project is ready to grow, - Are there tasks that are becoming too overwhelming for me and/or team? - How can I improve and maintaining my project's current and pending features? - How many stars and forks do I want to reach this time, and who can help me achieve it? -If you have said yes to these questions, it's time to develop your growth strategies. If you haven't already, consider creating different teams for specific purposes. For example, you can create a docs team for documentation maintenance, a triage team for reviewing and improving issues, or a maintainer team to help you with overall oversight of the project. Once you have decided the types of teams you want to add to your project, you can create separate pages for each team in your project's Workspace page. Check out the [Creating a New Repository Insights Page](../docs/maintainers-guide.md#adding-repositories-to-your-workspace). +If you have said yes to these questions, it's time to develop your growth strategies. If you haven't already, consider creating different teams for specific purposes. For example, you can create a docs team for documentation maintenance, a triage team for reviewing and approving issues, or a maintainer team to help you with overall oversight of the project. Once you have decided the types of teams you want to add to your project, you can create separate pages for each team in your project's Workspace page. Check out the [Creating a New Repository Insights Page](../docs/maintainers-guide.md#adding-repositories-to-your-workspace). ### How to identify new contributors and team members -Like Superman, Wonder Woman, the Flash, and Batman in ***The Justice League***, the people you bring on your team(s) and your project's contributors are key to its success, which is why picking the right people is important. When doing this process, consider going to their OpenSauced profiles and ask yourself the following questions: +Like Superman, Wonder Woman, the Flash, and Batman in ***The Justice League***, the people you bring on your team(s) and your project's contributors are key to its success, which is why picking the right people is important. When doing this process, consider going to their OpenSauced profiles and checking their [dev card](../docs/features/dev-card.md). While you do this, ask yourself the following questions: - How often do they contribute to yours and other open source projects in general? - Are they invested in your project's success? -Once you have your list of potential candidates, [create an Insights page for your project](../docs/maintainers-guide.md#creating-a-new-repository-insight-page), and add your candidates. From there, monitor their progress by reviewing the contributions that they post in the Highlights section. As you analyze this information, conisder using the following questions to help with this step in your open source project's growth journey: +Once you have your list of potential candidates, [create an Insights page for your project](../docs/maintainers-guide.md#creating-a-new-repository-insight-page), and add your candidates. From there, monitor their progress by reviewing the contributions that they post in the Highlights section. As you analyze this information, consider using the following questions to help with this step in your open source project's growth journey: - How have they grown since you found their profile? - What types of contributions does this person frequently make to yours and other open source projects? @@ -35,16 +35,19 @@ From there, consider narrowing down your list to If you need more tips on how to ### Recruiting team members and contributors -When you're ready to recruit your team members, consider going to their OpenSauced profiles and send them a message via the contact information they provide. If you and they have a PRO account, you can also send them invites using the [connections feature](../../docs/features-connections.md). +When you're ready to recruit your team members, consider creating an Insights page with projects that are similar to yours. From there, determine which contributors you think suits your project, add them to a list, and monitor their progress. Once you've finished your observations, recruit them. You can do this by going to their OpenSauced profiles and sending them a message via the contact information they provide. -To recruit new contributors, consider doing the following methods: +:::note If both of you have a PRO account, you can also send them invites using the [connections feature](../../docs/features-connections.md). +::: -- Do posts about your project's new releases via Linkedin, X(Twitter), and other forms of social media +If you want to go beyond sending a direct message, here are some other ways to recruit new contributors and team members: + +- Share your highlights about your project via Linkedin, X(Twitter), and other forms of social media - Host events via Twitch or your project's Slack or Discord servers -- Write blog posts about your project +- Join our "Pitch Your Project" space on X(Twitter). ### Understanding team participation -Once you have picked your official team members, it is crucial to monitior their participation to ensure that they are help the project run efficiently. You can do this by using [the team sync feature](../docs/features/workspaces.md#team-workspaces). +Once you have picked your official team members, it is crucial to monitor their participation to ensure that they are help the project run efficiently. You can do this by using [the team sync feature](../docs/features/workspaces.md#team-workspaces). ![Add People](../../static/img/add-to-workspace.png) From 8175912893377260eb1eb1c46266ae996fbcaac1 Mon Sep 17 00:00:00 2001 From: Christine Date: Sun, 7 Apr 2024 00:20:48 +0000 Subject: [PATCH 12/69] docs: made some edits Signed-off-by: Christine --- docs/maintainers/growing-your-project.md | 27 ++++++++++++------------ 1 file changed, 13 insertions(+), 14 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 6459be96..68da3f90 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -22,32 +22,31 @@ If you have said yes to these questions, it's time to develop your growth strate ### How to identify new contributors and team members -Like Superman, Wonder Woman, the Flash, and Batman in ***The Justice League***, the people you bring on your team(s) and your project's contributors are key to its success, which is why picking the right people is important. When doing this process, consider going to their OpenSauced profiles and checking their [dev card](../docs/features/dev-card.md). While you do this, ask yourself the following questions: +When it comes to planning the growth strategies for your open source project, the people you bring on your team(s) and your project's contributors are key to its success, which is why picking the right people is important. When doing this process, consider going to their OpenSauced profiles and checking their [dev card](../docs/features/dev-card.md). While you do this, ask yourself the following questions: - How often do they contribute to yours and other open source projects in general? - Are they invested in your project's success? -Once you have your list of potential candidates, [create an Insights page for your project](../docs/maintainers-guide.md#creating-a-new-repository-insight-page), and add your candidates. From there, monitor their progress by reviewing the contributions that they post in the Highlights section. As you analyze this information, consider using the following questions to help with this step in your open source project's growth journey: +Once you have your list of potential candidates, [create an a contributor insights page for your project](../docs/features/contributor-insights.md), and add your candidates to the page. From there, monitor their progress. -- How have they grown since you found their profile? -- What types of contributions does this person frequently make to yours and other open source projects? -From there, consider narrowing down your list to If you need more tips on how to pick people that can help grow your project, check out our blog post, ["How to Build Your Open Source Dream Team"](https://dev.to/opensauced/how-to-build-your-open-source-dream-team-a-guide-3i90). +::: tip -### Recruiting team members and contributors +To learn what to look for when monitoring your list of potential team members and contributors, check out our [Understanding Contributor Insights](../docs/maintainers/understanding-contrib-insights.md) guide +::: -When you're ready to recruit your team members, consider creating an Insights page with projects that are similar to yours. From there, determine which contributors you think suits your project, add them to a list, and monitor their progress. Once you've finished your observations, recruit them. You can do this by going to their OpenSauced profiles and sending them a message via the contact information they provide. +After you finished your observations, consider narrowing down your list to the contributors that suit your criteria the most. If you need more tips on how to pick people that can help grow your project, check out our blog post, ["How to Build Your Open Source Dream Team"](https://dev.to/opensauced/how-to-build-your-open-source-dream-team-a-guide-3i90). -:::note If both of you have a PRO account, you can also send them invites using the [connections feature](../../docs/features-connections.md). -::: +### Recruiting team members and contributors + +When you're ready to recruit your team members, consider creating an [repository insights page](../docs/features/repo-insights.md) with projects that are similar to yours. From there, determine which contributors you think suits your project, add them to a list, and monitor their progress. -If you want to go beyond sending a direct message, here are some other ways to recruit new contributors and team members: +:::tip +Consider checking our out [Understanding Repository Insights Data](../docs/features/understanding-repo-insights.md) guide to aid you in this process. -- Share your highlights about your project via Linkedin, X(Twitter), and other forms of social media -- Host events via Twitch or your project's Slack or Discord servers -- Join our "Pitch Your Project" space on X(Twitter). +Once you've finished your observations, recruit them. You can do this by going to their OpenSauced profiles and sending them a message via the contact information they provide. ### Understanding team participation -Once you have picked your official team members, it is crucial to monitor their participation to ensure that they are help the project run efficiently. You can do this by using [the team sync feature](../docs/features/workspaces.md#team-workspaces). +Once you have picked your official team members, it is crucial to monitor their participation to ensure that they are help the project run efficiently. You can do this by using [the team sync feature](../docs/features/contributor-insights.md#how-to-create-a-contributor-insight-page). ![Add People](../../static/img/add-to-workspace.png) From 38b9e91c21b0b78a503198786538a2290964f1f4 Mon Sep 17 00:00:00 2001 From: Christine Date: Sun, 7 Apr 2024 00:53:19 +0000 Subject: [PATCH 13/69] docs: replace image with gif Signed-off-by: Christine --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 68da3f90..d005c70d 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -49,4 +49,4 @@ Once you've finished your observations, recruit them. You can do this by going t Once you have picked your official team members, it is crucial to monitor their participation to ensure that they are help the project run efficiently. You can do this by using [the team sync feature](../docs/features/contributor-insights.md#how-to-create-a-contributor-insight-page). -![Add People](../../static/img/add-to-workspace.png) +![team sync gif](../../static/gif/team-sync.gif) From ccd0cb7c43b8d0bde59e376942dd432ea69d3c3f Mon Sep 17 00:00:00 2001 From: Christine Date: Sun, 7 Apr 2024 03:05:59 +0000 Subject: [PATCH 14/69] feat: hyperlink phrases to guides Signed-off-by: Christine --- docs/maintainers/growing-your-project.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index d005c70d..64c50a97 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -22,7 +22,7 @@ If you have said yes to these questions, it's time to develop your growth strate ### How to identify new contributors and team members -When it comes to planning the growth strategies for your open source project, the people you bring on your team(s) and your project's contributors are key to its success, which is why picking the right people is important. When doing this process, consider going to their OpenSauced profiles and checking their [dev card](../docs/features/dev-card.md). While you do this, ask yourself the following questions: +When it comes to planning the growth strategies for your open source project, the people you bring on your team(s) and your project's contributors are key to its success, which is why picking the right people is important. When doing this process, consider going to their [OpenSauced profile](../docs/contributors/contributors-guide.md#your-profile) and checking their [dev card](../docs/features/dev-card.md). While you do this, ask yourself the following questions: - How often do they contribute to yours and other open source projects in general? - Are they invested in your project's success? @@ -31,7 +31,7 @@ Once you have your list of potential candidates, [create an a contributor insigh ::: tip -To learn what to look for when monitoring your list of potential team members and contributors, check out our [Understanding Contributor Insights](../docs/maintainers/understanding-contrib-insights.md) guide +To learn what to look for when monitoring your list of potential team members and contributors, check out our [Understanding Contributor Insights](../docs/maintainers/understanding-contrib-insights.md) guide. ::: After you finished your observations, consider narrowing down your list to the contributors that suit your criteria the most. If you need more tips on how to pick people that can help grow your project, check out our blog post, ["How to Build Your Open Source Dream Team"](https://dev.to/opensauced/how-to-build-your-open-source-dream-team-a-guide-3i90). From 5fe6061026e838a0cbc9cf89cf5692243ad8caeb Mon Sep 17 00:00:00 2001 From: Christine Date: Sun, 7 Apr 2024 03:40:06 +0000 Subject: [PATCH 15/69] docs: fix tip format Signed-off-by: Christine --- docs/maintainers/growing-your-project.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 64c50a97..e0191b4b 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -42,6 +42,7 @@ When you're ready to recruit your team members, consider creating an [repository :::tip Consider checking our out [Understanding Repository Insights Data](../docs/features/understanding-repo-insights.md) guide to aid you in this process. +::: Once you've finished your observations, recruit them. You can do this by going to their OpenSauced profiles and sending them a message via the contact information they provide. From 4d005629b9e8dfd517e4ea02a79ac8c80189c263 Mon Sep 17 00:00:00 2001 From: Christine Date: Sun, 7 Apr 2024 03:57:49 +0000 Subject: [PATCH 16/69] docs: made some changes --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index e0191b4b..1faecb7e 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -41,7 +41,7 @@ After you finished your observations, consider narrowing down your list to the c When you're ready to recruit your team members, consider creating an [repository insights page](../docs/features/repo-insights.md) with projects that are similar to yours. From there, determine which contributors you think suits your project, add them to a list, and monitor their progress. :::tip -Consider checking our out [Understanding Repository Insights Data](../docs/features/understanding-repo-insights.md) guide to aid you in this process. +Consider checking out our [Understanding Repository Insights Data](../docs/features/understanding-repo-insights.md) guide to give you an idea on what to look for when narrowing down your list. ::: Once you've finished your observations, recruit them. You can do this by going to their OpenSauced profiles and sending them a message via the contact information they provide. From b0a71d272d3a92997d7ed52e5c198ce0eeeabb04 Mon Sep 17 00:00:00 2001 From: Christine Date: Sun, 7 Apr 2024 04:24:24 +0000 Subject: [PATCH 17/69] docs: revise ending sentence --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 1faecb7e..c55f5415 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -18,7 +18,7 @@ When it comes to deciding on whether your open source project is ready to grow, - Are there tasks that are becoming too overwhelming for me and/or team? - How can I improve and maintaining my project's current and pending features? - How many stars and forks do I want to reach this time, and who can help me achieve it? -If you have said yes to these questions, it's time to develop your growth strategies. If you haven't already, consider creating different teams for specific purposes. For example, you can create a docs team for documentation maintenance, a triage team for reviewing and approving issues, or a maintainer team to help you with overall oversight of the project. Once you have decided the types of teams you want to add to your project, you can create separate pages for each team in your project's Workspace page. Check out the [Creating a New Repository Insights Page](../docs/maintainers-guide.md#adding-repositories-to-your-workspace). +If you have said yes to these questions, it's time to develop your growth strategies. If you haven't already, consider creating different teams for specific purposes. For example, you can create a docs team for documentation maintenance, a triage team for reviewing and approving issues, or a maintainer team to help you with overall oversight of the project. Once you have decided the types of teams you want to add to your project, it's time to start to building the open source team of your dreams. ### How to identify new contributors and team members From a34d4c4e6a94e96ac01d36ec9a373d5d1ce7dfe2 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Tue, 9 Apr 2024 23:09:26 -0400 Subject: [PATCH 18/69] docs: made changes to third section --- docs/maintainers/growing-your-project.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index c55f5415..335698b7 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -13,7 +13,7 @@ Growth is the the crucial aspect of a successful open source project. If you're ### When to grow your project -When it comes to deciding on whether your open source project is ready to grow, consider reviewing your project's repository insights page in its Workspace page and asking yourself the following questions: +When it comes to deciding on whether your open source project is ready to grow, consider reviewing your project's Repository Insights page and asking yourself the following questions: - Are there tasks that are becoming too overwhelming for me and/or team? - How can I improve and maintaining my project's current and pending features? @@ -22,12 +22,16 @@ If you have said yes to these questions, it's time to develop your growth strate ### How to identify new contributors and team members -When it comes to planning the growth strategies for your open source project, the people you bring on your team(s) and your project's contributors are key to its success, which is why picking the right people is important. When doing this process, consider going to their [OpenSauced profile](../docs/contributors/contributors-guide.md#your-profile) and checking their [dev card](../docs/features/dev-card.md). While you do this, ask yourself the following questions: +When it comes to planning the growth strategies for your open source project, the people you bring on your team(s) and your project's contributors are key to its success, which is why picking the right people is important. When doing this process, consider going to the Contributors tab in your project's Repository Insights page. While you do this, ask yourself the following questions: - How often do they contribute to yours and other open source projects in general? - Are they invested in your project's success? -Once you have your list of potential candidates, [create an a contributor insights page for your project](../docs/features/contributor-insights.md), and add your candidates to the page. From there, monitor their progress. +Once you have made your observations, [create an a contributor insights page for your project](../docs/maintainers/maintainers-guide.md#creating-a-new-contributor-insight-page). This will help you to make decisions about what steps you want to take next. Here are some approaches you can use to help you: + +- Monitor contributors to see if they are active enough in your repositories to contribute as a team member. +- Identify your top contributors to extend an invitation to join a team. +- Identify active contributors in other repositories who may be interested in joining your team. ::: tip From 3d8b32aabaa38e7debd9a600167374e908a42fe4 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Tue, 9 Apr 2024 23:15:42 -0400 Subject: [PATCH 19/69] docs: remove tip --- docs/maintainers/growing-your-project.md | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 335698b7..db14a0b9 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -33,12 +33,7 @@ Once you have made your observations, [create an a contributor insights page for - Identify your top contributors to extend an invitation to join a team. - Identify active contributors in other repositories who may be interested in joining your team. -::: tip - -To learn what to look for when monitoring your list of potential team members and contributors, check out our [Understanding Contributor Insights](../docs/maintainers/understanding-contrib-insights.md) guide. -::: - -After you finished your observations, consider narrowing down your list to the contributors that suit your criteria the most. If you need more tips on how to pick people that can help grow your project, check out our blog post, ["How to Build Your Open Source Dream Team"](https://dev.to/opensauced/how-to-build-your-open-source-dream-team-a-guide-3i90). +If you need more tips on how to pick people that can help grow your project, check out our blog post, ["How to Build Your Open Source Dream Team"](https://dev.to/opensauced/how-to-build-your-open-source-dream-team-a-guide-3i90). ### Recruiting team members and contributors From e4f14ee5f362b63646fc883b18889e1f3c585843 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Tue, 9 Apr 2024 23:19:46 -0400 Subject: [PATCH 20/69] docs: revise last section --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index db14a0b9..e4b52958 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -47,6 +47,6 @@ Once you've finished your observations, recruit them. You can do this by going t ### Understanding team participation -Once you have picked your official team members, it is crucial to monitor their participation to ensure that they are help the project run efficiently. You can do this by using [the team sync feature](../docs/features/contributor-insights.md#how-to-create-a-contributor-insight-page). +Once you have picked your official team members, consider adding them to your project's Contributors Insights page by using [the team sync feature](../docs/features/contributor-insights.md#how-to-create-a-contributor-insight-page). This can be useful in monitoring their progress. ![team sync gif](../../static/gif/team-sync.gif) From 521f3eaa883403f74dbb6a12a966339a262f3968 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Tue, 9 Apr 2024 23:25:30 -0400 Subject: [PATCH 21/69] docs: revise sentence --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index e4b52958..e1488c5f 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -43,7 +43,7 @@ When you're ready to recruit your team members, consider creating an [repository Consider checking out our [Understanding Repository Insights Data](../docs/features/understanding-repo-insights.md) guide to give you an idea on what to look for when narrowing down your list. ::: -Once you've finished your observations, recruit them. You can do this by going to their OpenSauced profiles and sending them a message via the contact information they provide. +Once you've finished your observations, recruit them. You can do this by going to their [OpenSauced profiles](../docs/contributors/contributors-guide.md#your-profile) and sending them a message via the contact information they provide. ### Understanding team participation From 18fde854f807fe8a4341a930e8528e9b9539accf Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Tue, 9 Apr 2024 23:29:57 -0400 Subject: [PATCH 22/69] docs: fix hyperlinks Signed-off-by: Christine Belzie --- docs/maintainers/growing-your-project.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index e1488c5f..c7004bfc 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -27,7 +27,7 @@ When it comes to planning the growth strategies for your open source project, th - How often do they contribute to yours and other open source projects in general? - Are they invested in your project's success? -Once you have made your observations, [create an a contributor insights page for your project](../docs/maintainers/maintainers-guide.md#creating-a-new-contributor-insight-page). This will help you to make decisions about what steps you want to take next. Here are some approaches you can use to help you: +Once you have made your observations, [create an a contributor insights page for your project](../maintainers/maintainers-guide.md#creating-a-new-contributor-insight-page). This will help you to make decisions about what steps you want to take next. Here are some approaches you can use to help you: - Monitor contributors to see if they are active enough in your repositories to contribute as a team member. - Identify your top contributors to extend an invitation to join a team. @@ -37,16 +37,16 @@ If you need more tips on how to pick people that can help grow your project, che ### Recruiting team members and contributors -When you're ready to recruit your team members, consider creating an [repository insights page](../docs/features/repo-insights.md) with projects that are similar to yours. From there, determine which contributors you think suits your project, add them to a list, and monitor their progress. +When you're ready to recruit your team members, consider creating an [repository insights page](../features/repo-insights.md) with projects that are similar to yours. From there, determine which contributors you think suits your project, add them to a list, and monitor their progress. :::tip -Consider checking out our [Understanding Repository Insights Data](../docs/features/understanding-repo-insights.md) guide to give you an idea on what to look for when narrowing down your list. +Consider checking out our [Understanding Repository Insights Data](../features/repo-insights.md) guide to give you an idea on what to look for when narrowing down your list. ::: -Once you've finished your observations, recruit them. You can do this by going to their [OpenSauced profiles](../docs/contributors/contributors-guide.md#your-profile) and sending them a message via the contact information they provide. +Once you've finished your observations, recruit them. You can do this by going to their [OpenSauced profiles](../contributors/contributors-guide.md#creating-your-profile) and sending them a message via the contact information they provide. ### Understanding team participation -Once you have picked your official team members, consider adding them to your project's Contributors Insights page by using [the team sync feature](../docs/features/contributor-insights.md#how-to-create-a-contributor-insight-page). This can be useful in monitoring their progress. +Once you have picked your official team members, consider adding them to your project's Contributors Insights page by using [the team sync feature](../features/contributor-insights.md#how-to-create-a-contributor-insight-page). This can be useful in monitoring their progress. ![team sync gif](../../static/gif/team-sync.gif) From 1473e27fdfa709ef2eac52be87af15cf1cbcf801 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Thu, 11 Apr 2024 15:08:58 -0400 Subject: [PATCH 23/69] docs: add more keywords --- docs/maintainers/growing-your-project.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index c7004bfc..9a01ed78 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -3,8 +3,10 @@ id: growing-your-project title: "Growing Your Project" sidebar_label: "Growing Your Project" keywords: - - "maintainers" - - "guides" + - "open source maintainers" + - "maintainers guides" + - "open source project success" + - "growing an open source project" --- ## Growing your project From 9e3725b26cd59ef7d8e1e8583124e50a8b802abe Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Thu, 11 Apr 2024 15:27:59 -0400 Subject: [PATCH 24/69] fix: change vocab Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com> --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 9a01ed78..4bbd1ea0 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -11,7 +11,7 @@ keywords: ## Growing your project -Growth is the the crucial aspect of a successful open source project. If you're at this stage in your open source maintainer journey, here are some things to consider when thinking of growth strategies. +Growth is the crucial aspect of a successful open source project. If you're at this stage in your open source maintainer journey, here are some things to consider when thinking of growth strategies. ### When to grow your project From e736399ac23ede52308c5920966bcc79f203f903 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Thu, 11 Apr 2024 15:28:18 -0400 Subject: [PATCH 25/69] Update growing-your-project.md Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com> --- docs/maintainers/growing-your-project.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 4bbd1ea0..1254c1f4 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -17,8 +17,8 @@ Growth is the crucial aspect of a successful open source project. If you're at t When it comes to deciding on whether your open source project is ready to grow, consider reviewing your project's Repository Insights page and asking yourself the following questions: -- Are there tasks that are becoming too overwhelming for me and/or team? -- How can I improve and maintaining my project's current and pending features? +- Are there tasks that are becoming too overwhelming for me and the team? +- How can I improve and maintain my project's current and pending features? - How many stars and forks do I want to reach this time, and who can help me achieve it? If you have said yes to these questions, it's time to develop your growth strategies. If you haven't already, consider creating different teams for specific purposes. For example, you can create a docs team for documentation maintenance, a triage team for reviewing and approving issues, or a maintainer team to help you with overall oversight of the project. Once you have decided the types of teams you want to add to your project, it's time to start to building the open source team of your dreams. From 4cbc58eefc819501f603e6d8e90b7415d6f0a341 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Thu, 11 Apr 2024 15:29:20 -0400 Subject: [PATCH 26/69] docs: fix grammar error Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com> --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 1254c1f4..8ebe695c 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -20,7 +20,7 @@ When it comes to deciding on whether your open source project is ready to grow, - Are there tasks that are becoming too overwhelming for me and the team? - How can I improve and maintain my project's current and pending features? - How many stars and forks do I want to reach this time, and who can help me achieve it? -If you have said yes to these questions, it's time to develop your growth strategies. If you haven't already, consider creating different teams for specific purposes. For example, you can create a docs team for documentation maintenance, a triage team for reviewing and approving issues, or a maintainer team to help you with overall oversight of the project. Once you have decided the types of teams you want to add to your project, it's time to start to building the open source team of your dreams. +If you have said yes to these questions, it's time to develop your growth strategies. If you haven't already, consider creating different teams for specific purposes. For example, you can create a docs team for documentation maintenance, a triage team for reviewing and approving issues, or a maintainer team to help you with overall project oversight. Once you have decided the types of teams you want to add to your project, it's time to start building the open source team of your dreams. ### How to identify new contributors and team members From 3bb5f59c340e596f3ee2b941f097aaa26422a71b Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Thu, 11 Apr 2024 15:30:06 -0400 Subject: [PATCH 27/69] fix: revise grammar Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com> --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 8ebe695c..c182bbca 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -24,7 +24,7 @@ If you have said yes to these questions, it's time to develop your growth strate ### How to identify new contributors and team members -When it comes to planning the growth strategies for your open source project, the people you bring on your team(s) and your project's contributors are key to its success, which is why picking the right people is important. When doing this process, consider going to the Contributors tab in your project's Repository Insights page. While you do this, ask yourself the following questions: +When it comes to planning the growth strategies for your open source project, the people you bring on your team(s) and your project's contributors are key to its success, which is why picking the right people is important. When doing this process, consider going to the "Contributors" tab in your project's Repository Insight Page. While you do this, ask yourself the following questions: - How often do they contribute to yours and other open source projects in general? - Are they invested in your project's success? From fcb1137a15ee924366a27631fff16e20ca2d21cc Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Thu, 11 Apr 2024 15:30:40 -0400 Subject: [PATCH 28/69] docs: fix capitalization error Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com> --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index c182bbca..8cf882b5 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -29,7 +29,7 @@ When it comes to planning the growth strategies for your open source project, th - How often do they contribute to yours and other open source projects in general? - Are they invested in your project's success? -Once you have made your observations, [create an a contributor insights page for your project](../maintainers/maintainers-guide.md#creating-a-new-contributor-insight-page). This will help you to make decisions about what steps you want to take next. Here are some approaches you can use to help you: +Once you have made your observations, [create a Contributor Insight Page for your project](../maintainers/maintainers-guide.md#creating-a-new-contributor-insight-page). This will help you to make decisions about what steps you want to take next. Here are some approaches you can use to help you: - Monitor contributors to see if they are active enough in your repositories to contribute as a team member. - Identify your top contributors to extend an invitation to join a team. From eec89e28ab06fe2e760a2460affc0690e7530b28 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Thu, 11 Apr 2024 15:31:37 -0400 Subject: [PATCH 29/69] docs: add space at the bottom Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com> --- docs/maintainers/growing-your-project.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 8cf882b5..e53b8cbc 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -42,7 +42,9 @@ If you need more tips on how to pick people that can help grow your project, che When you're ready to recruit your team members, consider creating an [repository insights page](../features/repo-insights.md) with projects that are similar to yours. From there, determine which contributors you think suits your project, add them to a list, and monitor their progress. :::tip + Consider checking out our [Understanding Repository Insights Data](../features/repo-insights.md) guide to give you an idea on what to look for when narrowing down your list. + ::: Once you've finished your observations, recruit them. You can do this by going to their [OpenSauced profiles](../contributors/contributors-guide.md#creating-your-profile) and sending them a message via the contact information they provide. From 17f13a11370795fc6fa205c65fd228cf99f6a846 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Thu, 11 Apr 2024 15:32:11 -0400 Subject: [PATCH 30/69] docs: fix more grammar erry Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com> --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index e53b8cbc..557fd4b4 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -39,7 +39,7 @@ If you need more tips on how to pick people that can help grow your project, che ### Recruiting team members and contributors -When you're ready to recruit your team members, consider creating an [repository insights page](../features/repo-insights.md) with projects that are similar to yours. From there, determine which contributors you think suits your project, add them to a list, and monitor their progress. +When you're ready to recruit your team members, consider creating a [Repository Insight Page](../features/repo-insights.md) with projects that are similar to yours. From there, determine which contributors suit your project, add them to a list, and monitor their progress. :::tip From cb4d91df8f311803d2a0e89eacac25a579bacb27 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Thu, 11 Apr 2024 15:33:44 -0400 Subject: [PATCH 31/69] docs: add space after bullet point --- docs/maintainers/growing-your-project.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 557fd4b4..3f7f7410 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -20,6 +20,7 @@ When it comes to deciding on whether your open source project is ready to grow, - Are there tasks that are becoming too overwhelming for me and the team? - How can I improve and maintain my project's current and pending features? - How many stars and forks do I want to reach this time, and who can help me achieve it? + If you have said yes to these questions, it's time to develop your growth strategies. If you haven't already, consider creating different teams for specific purposes. For example, you can create a docs team for documentation maintenance, a triage team for reviewing and approving issues, or a maintainer team to help you with overall project oversight. Once you have decided the types of teams you want to add to your project, it's time to start building the open source team of your dreams. ### How to identify new contributors and team members From a793266b0b3a31c8c7ee830c62513be5a67a0267 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Thu, 11 Apr 2024 16:20:21 -0400 Subject: [PATCH 32/69] docs: make changes to the headings --- docs/maintainers/growing-your-project.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 3f7f7410..365ce5bf 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -9,11 +9,9 @@ keywords: - "growing an open source project" --- -## Growing your project - Growth is the crucial aspect of a successful open source project. If you're at this stage in your open source maintainer journey, here are some things to consider when thinking of growth strategies. -### When to grow your project +## When to grow your project When it comes to deciding on whether your open source project is ready to grow, consider reviewing your project's Repository Insights page and asking yourself the following questions: @@ -23,7 +21,7 @@ When it comes to deciding on whether your open source project is ready to grow, If you have said yes to these questions, it's time to develop your growth strategies. If you haven't already, consider creating different teams for specific purposes. For example, you can create a docs team for documentation maintenance, a triage team for reviewing and approving issues, or a maintainer team to help you with overall project oversight. Once you have decided the types of teams you want to add to your project, it's time to start building the open source team of your dreams. -### How to identify new contributors and team members +## How to identify new contributors and team members When it comes to planning the growth strategies for your open source project, the people you bring on your team(s) and your project's contributors are key to its success, which is why picking the right people is important. When doing this process, consider going to the "Contributors" tab in your project's Repository Insight Page. While you do this, ask yourself the following questions: @@ -38,7 +36,7 @@ Once you have made your observations, [create a Contributor Insight Page for you If you need more tips on how to pick people that can help grow your project, check out our blog post, ["How to Build Your Open Source Dream Team"](https://dev.to/opensauced/how-to-build-your-open-source-dream-team-a-guide-3i90). -### Recruiting team members and contributors +## Recruiting team members and contributors When you're ready to recruit your team members, consider creating a [Repository Insight Page](../features/repo-insights.md) with projects that are similar to yours. From there, determine which contributors suit your project, add them to a list, and monitor their progress. @@ -50,7 +48,7 @@ Consider checking out our [Understanding Repository Insights Data](../features/r Once you've finished your observations, recruit them. You can do this by going to their [OpenSauced profiles](../contributors/contributors-guide.md#creating-your-profile) and sending them a message via the contact information they provide. -### Understanding team participation +## Understanding team participation Once you have picked your official team members, consider adding them to your project's Contributors Insights page by using [the team sync feature](../features/contributor-insights.md#how-to-create-a-contributor-insight-page). This can be useful in monitoring their progress. From 60e92d126240e891b6682b7d807b934620562add Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Thu, 11 Apr 2024 16:20:47 -0400 Subject: [PATCH 33/69] Update docs/maintainers/growing-your-project.md Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com> --- docs/maintainers/growing-your-project.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 365ce5bf..3f4ef871 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -19,6 +19,7 @@ When it comes to deciding on whether your open source project is ready to grow, - How can I improve and maintain my project's current and pending features? - How many stars and forks do I want to reach this time, and who can help me achieve it? + If you have said yes to these questions, it's time to develop your growth strategies. If you haven't already, consider creating different teams for specific purposes. For example, you can create a docs team for documentation maintenance, a triage team for reviewing and approving issues, or a maintainer team to help you with overall project oversight. Once you have decided the types of teams you want to add to your project, it's time to start building the open source team of your dreams. ## How to identify new contributors and team members From 250504764e585cea5a77b015f622f8cdb142c34b Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 13 Apr 2024 15:41:24 -0400 Subject: [PATCH 34/69] docs: fix heading format Signed-off-by: Christine Belzie --- docs/maintainers/growing-your-project.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 3f4ef871..365ce5bf 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -19,7 +19,6 @@ When it comes to deciding on whether your open source project is ready to grow, - How can I improve and maintain my project's current and pending features? - How many stars and forks do I want to reach this time, and who can help me achieve it? - If you have said yes to these questions, it's time to develop your growth strategies. If you haven't already, consider creating different teams for specific purposes. For example, you can create a docs team for documentation maintenance, a triage team for reviewing and approving issues, or a maintainer team to help you with overall project oversight. Once you have decided the types of teams you want to add to your project, it's time to start building the open source team of your dreams. ## How to identify new contributors and team members From c41207cfc8806db15e0f90d92cdac243a41b709d Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 13 Apr 2024 15:46:13 -0400 Subject: [PATCH 35/69] docs: add link to repoinsights page Signed-off-by: Christine Belzie --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 365ce5bf..a37dc124 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -13,7 +13,7 @@ Growth is the crucial aspect of a successful open source project. If you're at t ## When to grow your project -When it comes to deciding on whether your open source project is ready to grow, consider reviewing your project's Repository Insights page and asking yourself the following questions: +When it comes to deciding on whether your open source project is ready to grow, consider reviewing your project's [Repository Insights page](../features/repo-insights.md) and asking yourself the following questions: - Are there tasks that are becoming too overwhelming for me and the team? - How can I improve and maintain my project's current and pending features? From f01196dc0cfe9406477487426acaf04b7267a645 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Wed, 17 Apr 2024 17:25:27 -0400 Subject: [PATCH 36/69] docs: revise sentence in recruitment section Signed-off-by: Christine Belzie --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index a37dc124..58be9a82 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -46,7 +46,7 @@ Consider checking out our [Understanding Repository Insights Data](../features/r ::: -Once you've finished your observations, recruit them. You can do this by going to their [OpenSauced profiles](../contributors/contributors-guide.md#creating-your-profile) and sending them a message via the contact information they provide. +Once you've picked the people you want to join your project, recruit them. You can do this by going to their [OpenSauced profiles](../contributors/contributors-guide.md#creating-your-profile) and sending them a message via the contact information they provide. ## Understanding team participation From 206c542f9053015d3f0f8150aa6cab1c522e6c0d Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Wed, 17 Apr 2024 17:26:49 -0400 Subject: [PATCH 37/69] docs: revise typo Signed-off-by: Christine Belzie --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 58be9a82..f86ff11a 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -50,6 +50,6 @@ Once you've picked the people you want to join your project, recruit them. You c ## Understanding team participation -Once you have picked your official team members, consider adding them to your project's Contributors Insights page by using [the team sync feature](../features/contributor-insights.md#how-to-create-a-contributor-insight-page). This can be useful in monitoring their progress. +Once you have recruited your official team members, consider adding them to your project's Contributors Insights page by using [the team sync feature](../features/contributor-insights.md#how-to-create-a-contributor-insight-page). This can be useful in monitoring their progress. ![team sync gif](../../static/gif/team-sync.gif) From 24604d83c6b87800f31a454dc224d714274463a6 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Sat, 20 Apr 2024 13:38:16 -0400 Subject: [PATCH 38/69] docs: omit line 12 --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index f86ff11a..10d21a3a 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -9,7 +9,7 @@ keywords: - "growing an open source project" --- -Growth is the crucial aspect of a successful open source project. If you're at this stage in your open source maintainer journey, here are some things to consider when thinking of growth strategies. + ## When to grow your project From 56f112b8d4acc6a19b287a6fb855fd0875d2b2cf Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 20 Apr 2024 13:47:58 -0400 Subject: [PATCH 39/69] docs: improve sentence Signed-off-by: Christine Belzie --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 10d21a3a..2ee217fc 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -23,7 +23,7 @@ If you have said yes to these questions, it's time to develop your growth strate ## How to identify new contributors and team members -When it comes to planning the growth strategies for your open source project, the people you bring on your team(s) and your project's contributors are key to its success, which is why picking the right people is important. When doing this process, consider going to the "Contributors" tab in your project's Repository Insight Page. While you do this, ask yourself the following questions: +If you have a reliable group of contributors, adding them to a Contributor Insight Page can help you to better understand their contributions to your project and the open source ecosystem - How often do they contribute to yours and other open source projects in general? - Are they invested in your project's success? From 905dddeec4bf7e1383110ff6a73b85f1e6351c3a Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 20 Apr 2024 13:49:54 -0400 Subject: [PATCH 40/69] docs: add hyperlink Signed-off-by: Christine Belzie --- docs/maintainers/growing-your-project.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 2ee217fc..df0f4db7 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -23,10 +23,8 @@ If you have said yes to these questions, it's time to develop your growth strate ## How to identify new contributors and team members -If you have a reliable group of contributors, adding them to a Contributor Insight Page can help you to better understand their contributions to your project and the open source ecosystem +If you have a reliable group of contributors, adding them to a [Contributor Insight Page](../maintainers/maintainers-guide.md#creating-a-new-contributor-insight-page) can help you to better understand their contributions to your project and the open source ecosystem -- How often do they contribute to yours and other open source projects in general? -- Are they invested in your project's success? Once you have made your observations, [create a Contributor Insight Page for your project](../maintainers/maintainers-guide.md#creating-a-new-contributor-insight-page). This will help you to make decisions about what steps you want to take next. Here are some approaches you can use to help you: From 7c205f92dd88ed8647b9a6a4971702ade9e8868c Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 20 Apr 2024 13:57:57 -0400 Subject: [PATCH 41/69] docs: made a few updates Signed-off-by: Christine Belzie --- docs/maintainers/growing-your-project.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index df0f4db7..24dd01f3 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -23,10 +23,7 @@ If you have said yes to these questions, it's time to develop your growth strate ## How to identify new contributors and team members -If you have a reliable group of contributors, adding them to a [Contributor Insight Page](../maintainers/maintainers-guide.md#creating-a-new-contributor-insight-page) can help you to better understand their contributions to your project and the open source ecosystem - - -Once you have made your observations, [create a Contributor Insight Page for your project](../maintainers/maintainers-guide.md#creating-a-new-contributor-insight-page). This will help you to make decisions about what steps you want to take next. Here are some approaches you can use to help you: +If you have a reliable group of contributors, adding them to a [Contributor Insight Page](../maintainers/maintainers-guide.md#creating-a-new-contributor-insight-page) can help you to better understand their contributions to your project and the open source ecosystem. Here are some methods you can use in this process: - Monitor contributors to see if they are active enough in your repositories to contribute as a team member. - Identify your top contributors to extend an invitation to join a team. @@ -34,7 +31,7 @@ Once you have made your observations, [create a Contributor Insight Page for you If you need more tips on how to pick people that can help grow your project, check out our blog post, ["How to Build Your Open Source Dream Team"](https://dev.to/opensauced/how-to-build-your-open-source-dream-team-a-guide-3i90). -## Recruiting team members and contributors +## Recruiting Team Members and Contributors Outside of Your Project When you're ready to recruit your team members, consider creating a [Repository Insight Page](../features/repo-insights.md) with projects that are similar to yours. From there, determine which contributors suit your project, add them to a list, and monitor their progress. From 00f3975441bd46d8335f88fc49937245ae27b8a5 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Sat, 20 Apr 2024 14:21:37 -0400 Subject: [PATCH 42/69] docs: change to simple sentence --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 24dd01f3..e48c547f 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -45,6 +45,6 @@ Once you've picked the people you want to join your project, recruit them. You c ## Understanding team participation -Once you have recruited your official team members, consider adding them to your project's Contributors Insights page by using [the team sync feature](../features/contributor-insights.md#how-to-create-a-contributor-insight-page). This can be useful in monitoring their progress. +Once you've identified the people you want to ask, reach out to them by providing a clear message and a list of expectations. ![team sync gif](../../static/gif/team-sync.gif) From edfb8b5a0b2c25865d00195c6217c8ab854477ce Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 20 Apr 2024 17:47:45 -0400 Subject: [PATCH 43/69] docs: replace the sentence Signed-off-by: Christine Belzie --- docs/maintainers/growing-your-project.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index e48c547f..defe64cd 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -31,7 +31,7 @@ If you have a reliable group of contributors, adding them to a [Contributor Insi If you need more tips on how to pick people that can help grow your project, check out our blog post, ["How to Build Your Open Source Dream Team"](https://dev.to/opensauced/how-to-build-your-open-source-dream-team-a-guide-3i90). -## Recruiting Team Members and Contributors Outside of Your Project +## Recruiting Team Members and Contributors Outside of Your Project When you're ready to recruit your team members, consider creating a [Repository Insight Page](../features/repo-insights.md) with projects that are similar to yours. From there, determine which contributors suit your project, add them to a list, and monitor their progress. @@ -41,7 +41,7 @@ Consider checking out our [Understanding Repository Insights Data](../features/r ::: -Once you've picked the people you want to join your project, recruit them. You can do this by going to their [OpenSauced profiles](../contributors/contributors-guide.md#creating-your-profile) and sending them a message via the contact information they provide. +Once you've identified the people you want to ask, reach out to them, providing a clear message and a list of expectations. ## Understanding team participation From e080148525c53e43fc9d232a567857eb5100f4e9 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 20 Apr 2024 17:55:26 -0400 Subject: [PATCH 44/69] docs: add a note about creating a team on GitHub Signed-off-by: Christine Belzie --- docs/maintainers/growing-your-project.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index defe64cd..bc5ca62a 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -47,4 +47,10 @@ Once you've identified the people you want to ask, reach out to them, providing Once you've identified the people you want to ask, reach out to them by providing a clear message and a list of expectations. +:::note + +In order for the team sync feature to work, create the team on GitHub first. Check out [their tutorial](https://docs.github.com/en/organizations/organizing-members-into-teams/creating-a-team) to learn how. + +::: + ![team sync gif](../../static/gif/team-sync.gif) From 3750ba3e6f2221e9762a528a00e26e5b4d0f1c4c Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 20 Apr 2024 18:07:31 -0400 Subject: [PATCH 45/69] docs: revise the paragraph in the first section Signed-off-by: Christine Belzie --- docs/maintainers/growing-your-project.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index bc5ca62a..caf36862 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -13,17 +13,17 @@ keywords: ## When to grow your project -When it comes to deciding on whether your open source project is ready to grow, consider reviewing your project's [Repository Insights page](../features/repo-insights.md) and asking yourself the following questions: +When it comes to deciding on whether your open source project is ready to grow, consider asking yourself the following question: -- Are there tasks that are becoming too overwhelming for me and the team? -- How can I improve and maintain my project's current and pending features? -- How many stars and forks do I want to reach this time, and who can help me achieve it? +- Are there active community members who would be interested in progressing to an official role? -If you have said yes to these questions, it's time to develop your growth strategies. If you haven't already, consider creating different teams for specific purposes. For example, you can create a docs team for documentation maintenance, a triage team for reviewing and approving issues, or a maintainer team to help you with overall project oversight. Once you have decided the types of teams you want to add to your project, it's time to start building the open source team of your dreams. +If you have said yes, it's time to develop your growth strategies. If you haven't already, consider creating different teams for specific purposes. For example, you can create a docs team for documentation maintenance, a triage team for reviewing and approving issues, or a maintainer team to help you with overall project oversight. Once you have decided the types of teams you want to add to your project, it's time to start building the open source team of your dreams. ## How to identify new contributors and team members -If you have a reliable group of contributors, adding them to a [Contributor Insight Page](../maintainers/maintainers-guide.md#creating-a-new-contributor-insight-page) can help you to better understand their contributions to your project and the open source ecosystem. Here are some methods you can use in this process: +When it comes to planning the growth strategies for your open source project, picking the right people will determine how successful your project will be. You can discover the right people for your project by starting with a [Repository Insight Page](../maintainers/maintainers-guide.md#creating-a-new-repository-insight-page). From there, you can use the Contributors dashboard to help you get a better understanding of your existing contributors. + +Once you have found a reliable group of contributors, consider adding them to a [Contributor Insight Page](../maintainers/maintainers-guide.md#creating-a-new-contributor-insight-page). It can help you better understand their contributions to your project and the open source ecosystem. Here are some methods you can use to analyze the page: - Monitor contributors to see if they are active enough in your repositories to contribute as a team member. - Identify your top contributors to extend an invitation to join a team. From bdc430b219038e941e86cabcc1d46a44422ee532 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 20 Apr 2024 18:09:32 -0400 Subject: [PATCH 46/69] docs: add another section Signed-off-by: Christine Belzie --- docs/maintainers/growing-your-project.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index caf36862..fd334e1e 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -54,3 +54,6 @@ In order for the team sync feature to work, create the team on GitHub first. Che ::: ![team sync gif](../../static/gif/team-sync.gif) + +## Creating Transparency and Communication With Your Team + From 2531e472fbd52123ba3b655afd1c1add8d9cf051 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 20 Apr 2024 18:33:01 -0400 Subject: [PATCH 47/69] docs: revise section on team participation Signed-off-by: Christine Belzie --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index fd334e1e..9681f9b3 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -45,7 +45,7 @@ Once you've identified the people you want to ask, reach out to them, providing ## Understanding team participation -Once you've identified the people you want to ask, reach out to them by providing a clear message and a list of expectations. +Once you've identified the people you want to ask, reach out to them by providing a clear message and a list of expectations. Then, [sync your team](../welcome/faqs.md#sync-your-github-team) to your project's Repository Insight page. :::note From fbdbbe10eaa8149071402e2eb534f2ef5d8d862c Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 20 Apr 2024 21:28:01 -0400 Subject: [PATCH 48/69] docs: add section on transparency --- docs/maintainers/growing-your-project.md | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 9681f9b3..2ac398d6 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -45,7 +45,7 @@ Once you've identified the people you want to ask, reach out to them, providing ## Understanding team participation -Once you've identified the people you want to ask, reach out to them by providing a clear message and a list of expectations. Then, [sync your team](../welcome/faqs.md#sync-your-github-team) to your project's Repository Insight page. +Once you've identified the people you want to ask, reach out to them by providing a clear message and a list of expectations on how they should partake in the project. Then, [sync your team](../welcome/faqs.md#sync-your-github-team) to your project's Repository Insight page. :::note @@ -55,5 +55,21 @@ In order for the team sync feature to work, create the team on GitHub first. Che ![team sync gif](../../static/gif/team-sync.gif) +When monitoring their progress in the [Contributors tab](../maintainers/maintainers-guide.md#contributors), here are some strategies you can use to help you: + +- Identify the amount of repositories they contributed to in the Repositories section to see if they are immersed in the project. +- Take note of the date of their recent contribution in the Last Contributed section to see if it aligns with the number in the Repositories section. +- Check the level in the Act tab to determine how often they contribute to the project + +:::tip + +If you see "Low" in the Act tab, consider messaging your team member about this information and request a meeting to discuss possible strategies to help them progress. + +::: + ## Creating Transparency and Communication With Your Team - + +While having a team is important in your open source project's growth strategy, the methods use to work and communicate with them plays a major role this journey. Creating and sharing your project's workspace with your team members can be a great way to help you facilitate this kind of environment for your project. Once you create this page, here are some strategies you can use its information to connect with your team: + +- Analyze the closed number Pull Requests and Issues tabs and the PR velocity to think of new ways to quickly review and merge people's contributions. +- Use the amount of stars and forks displayed in the Engagement tab to discuss the effectiveness of current promotion strategies and to determine new methods to promote the project. From ddbab509fd1ee22d6aeb2c5ba550b6bdd43acc7d Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 20 Apr 2024 21:49:22 -0400 Subject: [PATCH 49/69] docs: made some revisions --- docs/maintainers/growing-your-project.md | 18 ++++++------------ 1 file changed, 6 insertions(+), 12 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 2ac398d6..e735aeb2 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -33,7 +33,7 @@ If you need more tips on how to pick people that can help grow your project, che ## Recruiting Team Members and Contributors Outside of Your Project -When you're ready to recruit your team members, consider creating a [Repository Insight Page](../features/repo-insights.md) with projects that are similar to yours. From there, determine which contributors suit your project, add them to a list, and monitor their progress. +If you've looked at your project's[Repository Insight Page](../features/repo-insights.md) and realize there is no one that could help you, consider recruiting new contributors. To do that, create another repository insight page with projects that are similar to yours. From there, determine which contributors suit your project, add them to a list, and monitor their progress. :::tip @@ -43,19 +43,13 @@ Consider checking out our [Understanding Repository Insights Data](../features/r Once you've identified the people you want to ask, reach out to them, providing a clear message and a list of expectations. -## Understanding team participation - -Once you've identified the people you want to ask, reach out to them by providing a clear message and a list of expectations on how they should partake in the project. Then, [sync your team](../welcome/faqs.md#sync-your-github-team) to your project's Repository Insight page. - -:::note - -In order for the team sync feature to work, create the team on GitHub first. Check out [their tutorial](https://docs.github.com/en/organizations/organizing-members-into-teams/creating-a-team) to learn how. - -::: +After the people from your list has agreed to join your project, create [your team on GitHub](https://docs.github.com/en/organizations/organizing-members-into-teams/creating-a-team) and [sync it](../welcome/faqs.md#sync-your-github-team) to your project's Repository Insight page. ![team sync gif](../../static/gif/team-sync.gif) -When monitoring their progress in the [Contributors tab](../maintainers/maintainers-guide.md#contributors), here are some strategies you can use to help you: +## Understanding team participation + +To ensure that your open source project reaches it growth strategy goal(s), it is important to ensure that your members actively participate in the project as much as possible. The [Contributors tab](../maintainers/maintainers-guide.md#contributors) in your project's Repository Insights page can be helpful in fostering participation. Here are some strategies you can use this tab to monitor your team member's progress: - Identify the amount of repositories they contributed to in the Repositories section to see if they are immersed in the project. - Take note of the date of their recent contribution in the Last Contributed section to see if it aligns with the number in the Repositories section. @@ -69,7 +63,7 @@ If you see "Low" in the Act tab, consider messaging your team member about this ## Creating Transparency and Communication With Your Team -While having a team is important in your open source project's growth strategy, the methods use to work and communicate with them plays a major role this journey. Creating and sharing your project's workspace with your team members can be a great way to help you facilitate this kind of environment for your project. Once you create this page, here are some strategies you can use its information to connect with your team: +In addition to having an active team, the methods use to work and communicate with them plays a major role in your open source's growth strategy. Creating and sharing your project's workspace with your team members can be a great way to help you facilitate this kind of environment for your project. Once you create this page, here are some strategies you can use its information to connect with your team: - Analyze the closed number Pull Requests and Issues tabs and the PR velocity to think of new ways to quickly review and merge people's contributions. - Use the amount of stars and forks displayed in the Engagement tab to discuss the effectiveness of current promotion strategies and to determine new methods to promote the project. From 513e0538e437e2633af8badf7c35d4ac5d7ffa18 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 20 Apr 2024 21:57:39 -0400 Subject: [PATCH 50/69] docs: add Additional Resources section --- docs/maintainers/growing-your-project.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index e735aeb2..0bc527ea 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -67,3 +67,9 @@ In addition to having an active team, the methods use to work and communicate wi - Analyze the closed number Pull Requests and Issues tabs and the PR velocity to think of new ways to quickly review and merge people's contributions. - Use the amount of stars and forks displayed in the Engagement tab to discuss the effectiveness of current promotion strategies and to determine new methods to promote the project. + +## Additional Resources +If you're looking for more resources to aid you in your open source project's growth journey, check out these posts written by our team on Dev.to: + +- [Scaling Open Source Projects: Navigating Challenges](https://dev.to/opensauced/navigating-the-challenges-of-scaling-open-source-projects-11h2) +- [Collaborate, Conquer, & Grow: Mastering the Art of Issue Management for Open Source Projects](https://dev.to/opensauced/collaborate-conquer-grow-mastering-the-art-of-issue-management-for-open-source-projects-49gi) From 53f1a30f3eb34d742b1122c9f6f27e3a7d13eb76 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 20 Apr 2024 21:58:09 -0400 Subject: [PATCH 51/69] docs: fix markdown formatting errors --- docs/maintainers/growing-your-project.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 0bc527ea..3d82d03a 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -68,7 +68,8 @@ In addition to having an active team, the methods use to work and communicate wi - Analyze the closed number Pull Requests and Issues tabs and the PR velocity to think of new ways to quickly review and merge people's contributions. - Use the amount of stars and forks displayed in the Engagement tab to discuss the effectiveness of current promotion strategies and to determine new methods to promote the project. -## Additional Resources +## Additional Resources + If you're looking for more resources to aid you in your open source project's growth journey, check out these posts written by our team on Dev.to: - [Scaling Open Source Projects: Navigating Challenges](https://dev.to/opensauced/navigating-the-challenges-of-scaling-open-source-projects-11h2) From ef7130793c51a1cf347a371f17e1442829c5913f Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 20 Apr 2024 23:15:52 -0400 Subject: [PATCH 52/69] docs: revise sentence --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 3d82d03a..885f6a8c 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -70,7 +70,7 @@ In addition to having an active team, the methods use to work and communicate wi ## Additional Resources -If you're looking for more resources to aid you in your open source project's growth journey, check out these posts written by our team on Dev.to: +If you're looking for more resources to aid you in your open source project's growth journey, check out these posts written by the OpenSauced team: - [Scaling Open Source Projects: Navigating Challenges](https://dev.to/opensauced/navigating-the-challenges-of-scaling-open-source-projects-11h2) - [Collaborate, Conquer, & Grow: Mastering the Art of Issue Management for Open Source Projects](https://dev.to/opensauced/collaborate-conquer-grow-mastering-the-art-of-issue-management-for-open-source-projects-49gi) From 2e22e0a972b36ad94cf5d3f72fdbfe02655429c0 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 20 Apr 2024 23:18:51 -0400 Subject: [PATCH 53/69] docs: revise sentence Signed-off-by: Christine Belzie --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 885f6a8c..1db998ce 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -49,7 +49,7 @@ After the people from your list has agreed to join your project, create [your te ## Understanding team participation -To ensure that your open source project reaches it growth strategy goal(s), it is important to ensure that your members actively participate in the project as much as possible. The [Contributors tab](../maintainers/maintainers-guide.md#contributors) in your project's Repository Insights page can be helpful in fostering participation. Here are some strategies you can use this tab to monitor your team member's progress: +To ensure that your open source project reaches it growth strategy goal(s), it is important that your team members actively participate in the project as much as possible. The [Contributors tab](../maintainers/maintainers-guide.md#contributors) in your project's Repository Insights page can be helpful in fostering participation. Here are some strategies you can use this tab to monitor your team member's progress: - Identify the amount of repositories they contributed to in the Repositories section to see if they are immersed in the project. - Take note of the date of their recent contribution in the Last Contributed section to see if it aligns with the number in the Repositories section. From 9aecda01e24f35919bb9e04cd5779044764056d3 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 20 Apr 2024 23:24:42 -0400 Subject: [PATCH 54/69] docs: made the paragraph in the section on transparency smoother Signed-off-by: Christine Belzie --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 1db998ce..afe88ec6 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -63,7 +63,7 @@ If you see "Low" in the Act tab, consider messaging your team member about this ## Creating Transparency and Communication With Your Team -In addition to having an active team, the methods use to work and communicate with them plays a major role in your open source's growth strategy. Creating and sharing your project's workspace with your team members can be a great way to help you facilitate this kind of environment for your project. Once you create this page, here are some strategies you can use its information to connect with your team: +The methods utilized to collaborate and communicate with your team play a crucial role in the growth of your open source project. Creating and sharing your project's [workspace](../features/workspaces.md) page with your team members can be helpful in fostering a collaborative environment. After creating this page, here are some ways to leverage its information to engage with your team: - Analyze the closed number Pull Requests and Issues tabs and the PR velocity to think of new ways to quickly review and merge people's contributions. - Use the amount of stars and forks displayed in the Engagement tab to discuss the effectiveness of current promotion strategies and to determine new methods to promote the project. From 60f8a38653aa0293ae37915a1e547bc16c9c7589 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Sat, 20 Apr 2024 23:34:14 -0400 Subject: [PATCH 55/69] docs: revise sentence Signed-off-by: Christine Belzie --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index afe88ec6..4719baf2 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -23,7 +23,7 @@ If you have said yes, it's time to develop your growth strategies. If you haven' When it comes to planning the growth strategies for your open source project, picking the right people will determine how successful your project will be. You can discover the right people for your project by starting with a [Repository Insight Page](../maintainers/maintainers-guide.md#creating-a-new-repository-insight-page). From there, you can use the Contributors dashboard to help you get a better understanding of your existing contributors. -Once you have found a reliable group of contributors, consider adding them to a [Contributor Insight Page](../maintainers/maintainers-guide.md#creating-a-new-contributor-insight-page). It can help you better understand their contributions to your project and the open source ecosystem. Here are some methods you can use to analyze the page: +Once you have found a reliable group of contributors, consider adding them to a [Contributor Insight Page](../maintainers/maintainers-guide.md#creating-a-new-contributor-insight-page). It can help you better understand their contributions to your project and the open source ecosystem. Here are some methods you can use to help you analyze its data: - Monitor contributors to see if they are active enough in your repositories to contribute as a team member. - Identify your top contributors to extend an invitation to join a team. From 7aa45e2d923f514403366d415b3568677489bf92 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Thu, 25 Apr 2024 18:54:53 -0400 Subject: [PATCH 56/69] docs: change formatting Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com> --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 4719baf2..d97ecedf 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -15,7 +15,7 @@ keywords: When it comes to deciding on whether your open source project is ready to grow, consider asking yourself the following question: -- Are there active community members who would be interested in progressing to an official role? +> Are there active community members who would be interested in progressing to an official role? If you have said yes, it's time to develop your growth strategies. If you haven't already, consider creating different teams for specific purposes. For example, you can create a docs team for documentation maintenance, a triage team for reviewing and approving issues, or a maintainer team to help you with overall project oversight. Once you have decided the types of teams you want to add to your project, it's time to start building the open source team of your dreams. From d9e1901628a8bf83b909301dac7fa84b025da998 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Thu, 25 Apr 2024 18:55:28 -0400 Subject: [PATCH 57/69] docs: change wording Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com> --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index d97ecedf..7fc8f84f 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -33,7 +33,7 @@ If you need more tips on how to pick people that can help grow your project, che ## Recruiting Team Members and Contributors Outside of Your Project -If you've looked at your project's[Repository Insight Page](../features/repo-insights.md) and realize there is no one that could help you, consider recruiting new contributors. To do that, create another repository insight page with projects that are similar to yours. From there, determine which contributors suit your project, add them to a list, and monitor their progress. +If you've looked at your project's [Repository Insight Page](../features/repo-insights.md) and realize there is no one that could help you, consider recruiting new contributors. To do that, create another Repository Insight Page with projects that are similar to yours. From there, determine which contributors suit your project, add them to a list, and monitor their progress. :::tip From 67452a03727482f3c3c5d3c0478ee29e5babc390 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Thu, 25 Apr 2024 18:55:52 -0400 Subject: [PATCH 58/69] docs: change formatting Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com> --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 7fc8f84f..4073c836 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -29,7 +29,7 @@ Once you have found a reliable group of contributors, consider adding them to a - Identify your top contributors to extend an invitation to join a team. - Identify active contributors in other repositories who may be interested in joining your team. -If you need more tips on how to pick people that can help grow your project, check out our blog post, ["How to Build Your Open Source Dream Team"](https://dev.to/opensauced/how-to-build-your-open-source-dream-team-a-guide-3i90). +If you need more tips on how to pick people that can help grow your project, check out our blog post, "[How to Build Your Open Source Dream Team](https://dev.to/opensauced/how-to-build-your-open-source-dream-team-a-guide-3i90)". ## Recruiting Team Members and Contributors Outside of Your Project From 32aad75dfada6f1b32a3b0ed0dddf5dedc8dd5d7 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Thu, 25 Apr 2024 18:56:17 -0400 Subject: [PATCH 59/69] docs: change wording Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com> --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 4073c836..5bfd92ce 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -43,7 +43,7 @@ Consider checking out our [Understanding Repository Insights Data](../features/r Once you've identified the people you want to ask, reach out to them, providing a clear message and a list of expectations. -After the people from your list has agreed to join your project, create [your team on GitHub](https://docs.github.com/en/organizations/organizing-members-into-teams/creating-a-team) and [sync it](../welcome/faqs.md#sync-your-github-team) to your project's Repository Insight page. +After the people from your list has agreed to join your project, create [your team on GitHub](https://docs.github.com/en/organizations/organizing-members-into-teams/creating-a-team) and [sync it](../welcome/faqs.md#sync-your-github-team) to your project's Repository Insight Page. ![team sync gif](../../static/gif/team-sync.gif) From 9046e03ca6bf0191a6bf83742f0b78551407b119 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Thu, 25 Apr 2024 18:56:43 -0400 Subject: [PATCH 60/69] docs: change formatting Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com> --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 5bfd92ce..dad6a098 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -63,7 +63,7 @@ If you see "Low" in the Act tab, consider messaging your team member about this ## Creating Transparency and Communication With Your Team -The methods utilized to collaborate and communicate with your team play a crucial role in the growth of your open source project. Creating and sharing your project's [workspace](../features/workspaces.md) page with your team members can be helpful in fostering a collaborative environment. After creating this page, here are some ways to leverage its information to engage with your team: +The methods utilized to collaborate and communicate with your team play a crucial role in the growth of your open source project. Creating and sharing your project's [Workspace](../features/workspaces.md) page with your team members can be helpful in fostering a collaborative environment. After creating this page, here are some ways to leverage its information to engage with your team: - Analyze the closed number Pull Requests and Issues tabs and the PR velocity to think of new ways to quickly review and merge people's contributions. - Use the amount of stars and forks displayed in the Engagement tab to discuss the effectiveness of current promotion strategies and to determine new methods to promote the project. From 864159692ca97b7d6f974a5109fb874e22606634 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Thu, 25 Apr 2024 19:17:31 -0400 Subject: [PATCH 61/69] docs: improving sentence --- docs/maintainers/growing-your-project.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index dad6a098..f09e2c6c 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -47,17 +47,17 @@ After the people from your list has agreed to join your project, create [your te ![team sync gif](../../static/gif/team-sync.gif) -## Understanding team participation +## Understanding Team Participation -To ensure that your open source project reaches it growth strategy goal(s), it is important that your team members actively participate in the project as much as possible. The [Contributors tab](../maintainers/maintainers-guide.md#contributors) in your project's Repository Insights page can be helpful in fostering participation. Here are some strategies you can use this tab to monitor your team member's progress: +To ensure that your open source project reaches it growth strategy goal(s), it is important that your team members actively participate in the project as much as possible. The [Contributors dashboard](../maintainers/maintainers-guide.md#contributors) in your project's Repository Insights Page can be helpful in fostering participation. Here are some strategies you can use this tab to monitor your team member's progress: - Identify the amount of repositories they contributed to in the Repositories section to see if they are immersed in the project. - Take note of the date of their recent contribution in the Last Contributed section to see if it aligns with the number in the Repositories section. -- Check the level in the Act tab to determine how often they contribute to the project +- Check the level in the Activity Ratio section to determine how often they contribute to the project :::tip -If you see "Low" in the Act tab, consider messaging your team member about this information and request a meeting to discuss possible strategies to help them progress. +If your project's Activity Ratio shows "Low", consider messaging your team member about this information and request a meeting to discuss possible strategies to help them progress. ::: @@ -65,7 +65,7 @@ If you see "Low" in the Act tab, consider messaging your team member about this The methods utilized to collaborate and communicate with your team play a crucial role in the growth of your open source project. Creating and sharing your project's [Workspace](../features/workspaces.md) page with your team members can be helpful in fostering a collaborative environment. After creating this page, here are some ways to leverage its information to engage with your team: -- Analyze the closed number Pull Requests and Issues tabs and the PR velocity to think of new ways to quickly review and merge people's contributions. +- Analyze the amount of closed and opened pull requests and issues in their corresponding sections as well as your project's [PR velocity](../welcome/glossary.md#pr-velocity) rate to think of new ways to quickly review and merge people's contributions. - Use the amount of stars and forks displayed in the Engagement tab to discuss the effectiveness of current promotion strategies and to determine new methods to promote the project. ## Additional Resources From 934355b23047b0d13558e5124e8da28dcf1d8ad8 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Thu, 25 Apr 2024 19:30:19 -0400 Subject: [PATCH 62/69] docs: hyperlinks information --- docs/maintainers/growing-your-project.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index f09e2c6c..33d3e7c8 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -52,12 +52,12 @@ After the people from your list has agreed to join your project, create [your te To ensure that your open source project reaches it growth strategy goal(s), it is important that your team members actively participate in the project as much as possible. The [Contributors dashboard](../maintainers/maintainers-guide.md#contributors) in your project's Repository Insights Page can be helpful in fostering participation. Here are some strategies you can use this tab to monitor your team member's progress: - Identify the amount of repositories they contributed to in the Repositories section to see if they are immersed in the project. -- Take note of the date of their recent contribution in the Last Contributed section to see if it aligns with the number in the Repositories section. -- Check the level in the Activity Ratio section to determine how often they contribute to the project +- Take note of the date of their recent contribution in the Last Contributed card to see if it aligns with the number in the Repositories card. +- Check your project's [Activity](../welcome/glossary.md#activity) ratio in your project's statistic card to determine how often they contribute to it. :::tip -If your project's Activity Ratio shows "Low", consider messaging your team member about this information and request a meeting to discuss possible strategies to help them progress. +If your project's Activity ratio presents as "Low", consider messaging your team member about this information and request a meeting to discuss possible strategies to help them progress. ::: @@ -65,7 +65,7 @@ If your project's Activity Ratio shows "Low", consider messaging your team membe The methods utilized to collaborate and communicate with your team play a crucial role in the growth of your open source project. Creating and sharing your project's [Workspace](../features/workspaces.md) page with your team members can be helpful in fostering a collaborative environment. After creating this page, here are some ways to leverage its information to engage with your team: -- Analyze the amount of closed and opened pull requests and issues in their corresponding sections as well as your project's [PR velocity](../welcome/glossary.md#pr-velocity) rate to think of new ways to quickly review and merge people's contributions. +- Analyze the amount of closed and opened pull requests and issues in their corresponding cards of your project's statistic card as well as its [PR velocity](../welcome/glossary.md#pr-velocity) rate to think of new ways to review and merge people's contributions in a quicker timeframe. - Use the amount of stars and forks displayed in the Engagement tab to discuss the effectiveness of current promotion strategies and to determine new methods to promote the project. ## Additional Resources From 5054f515747f373fde5bee95a6e970bb62cac8a3 Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Thu, 25 Apr 2024 19:35:15 -0400 Subject: [PATCH 63/69] docs: change word --- docs/maintainers/growing-your-project.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 33d3e7c8..ae1513f2 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -11,7 +11,7 @@ keywords: -## When to grow your project +## When to Grow your Project When it comes to deciding on whether your open source project is ready to grow, consider asking yourself the following question: @@ -19,7 +19,7 @@ When it comes to deciding on whether your open source project is ready to grow, If you have said yes, it's time to develop your growth strategies. If you haven't already, consider creating different teams for specific purposes. For example, you can create a docs team for documentation maintenance, a triage team for reviewing and approving issues, or a maintainer team to help you with overall project oversight. Once you have decided the types of teams you want to add to your project, it's time to start building the open source team of your dreams. -## How to identify new contributors and team members +## How to Identify New Contributors and Team Members When it comes to planning the growth strategies for your open source project, picking the right people will determine how successful your project will be. You can discover the right people for your project by starting with a [Repository Insight Page](../maintainers/maintainers-guide.md#creating-a-new-repository-insight-page). From there, you can use the Contributors dashboard to help you get a better understanding of your existing contributors. @@ -66,7 +66,7 @@ If your project's Activity ratio presents as "Low", consider messaging your team The methods utilized to collaborate and communicate with your team play a crucial role in the growth of your open source project. Creating and sharing your project's [Workspace](../features/workspaces.md) page with your team members can be helpful in fostering a collaborative environment. After creating this page, here are some ways to leverage its information to engage with your team: - Analyze the amount of closed and opened pull requests and issues in their corresponding cards of your project's statistic card as well as its [PR velocity](../welcome/glossary.md#pr-velocity) rate to think of new ways to review and merge people's contributions in a quicker timeframe. -- Use the amount of stars and forks displayed in the Engagement tab to discuss the effectiveness of current promotion strategies and to determine new methods to promote the project. +- Use the amount of stars and forks displayed in the Engagement card to discuss the effectiveness of current promotion strategies and to determine new methods to promote the project. ## Additional Resources From 274e7f2a0bc0da43894e0ce74b4717d2c3eea49e Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Fri, 26 Apr 2024 21:45:55 -0400 Subject: [PATCH 64/69] docs: revise first bullet point in section about communicating with team members --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index ae1513f2..1f8a4caf 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -65,7 +65,7 @@ If your project's Activity ratio presents as "Low", consider messaging your team The methods utilized to collaborate and communicate with your team play a crucial role in the growth of your open source project. Creating and sharing your project's [Workspace](../features/workspaces.md) page with your team members can be helpful in fostering a collaborative environment. After creating this page, here are some ways to leverage its information to engage with your team: -- Analyze the amount of closed and opened pull requests and issues in their corresponding cards of your project's statistic card as well as its [PR velocity](../welcome/glossary.md#pr-velocity) rate to think of new ways to review and merge people's contributions in a quicker timeframe. +- Analyze the number of open and merged pull requests, as well as open and closed issues in your project's statistic card to think of new ways to improve the speed of reviewing and merging contributions. Also, consider reviewing your project's [PR velocity](../welcome/glossary.md#pr-velocity) to identify more ways to optimize your process of reviewing and merging pull requests. - Use the amount of stars and forks displayed in the Engagement card to discuss the effectiveness of current promotion strategies and to determine new methods to promote the project. ## Additional Resources From 0f212e2064227ad9da55b2eb47e408d1c82901db Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Fri, 26 Apr 2024 21:53:28 -0400 Subject: [PATCH 65/69] docs: fix markdown errors --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 1f8a4caf..05d055a0 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -65,7 +65,7 @@ If your project's Activity ratio presents as "Low", consider messaging your team The methods utilized to collaborate and communicate with your team play a crucial role in the growth of your open source project. Creating and sharing your project's [Workspace](../features/workspaces.md) page with your team members can be helpful in fostering a collaborative environment. After creating this page, here are some ways to leverage its information to engage with your team: -- Analyze the number of open and merged pull requests, as well as open and closed issues in your project's statistic card to think of new ways to improve the speed of reviewing and merging contributions. Also, consider reviewing your project's [PR velocity](../welcome/glossary.md#pr-velocity) to identify more ways to optimize your process of reviewing and merging pull requests. +- Analyze the number of open and merged pull requests, as well as open and closed issues in your project's statistic card to think of new ways to improve the speed of reviewing and merging contributions. Also, consider reviewing your project's [PR velocity](../welcome/glossary.md#pr-velocity) to identify more ways to optimize your process of reviewing and merging pull requests. - Use the amount of stars and forks displayed in the Engagement card to discuss the effectiveness of current promotion strategies and to determine new methods to promote the project. ## Additional Resources From 6875a4e3d65e03e333202cc1459bbc744875b299 Mon Sep 17 00:00:00 2001 From: Christine Date: Mon, 27 May 2024 02:05:11 +0000 Subject: [PATCH 66/69] docs: added a note about the new StarSearch feature --- docs/maintainers/growing-your-project.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 05d055a0..aeec9721 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -23,6 +23,9 @@ If you have said yes, it's time to develop your growth strategies. If you haven' When it comes to planning the growth strategies for your open source project, picking the right people will determine how successful your project will be. You can discover the right people for your project by starting with a [Repository Insight Page](../maintainers/maintainers-guide.md#creating-a-new-repository-insight-page). From there, you can use the Contributors dashboard to help you get a better understanding of your existing contributors. +::: note +Consider using our AI-powered chatbot, [StarSearch](../features/star-search.md#user-guide) if you need more assistance with finding new contributors and team members. +::: Once you have found a reliable group of contributors, consider adding them to a [Contributor Insight Page](../maintainers/maintainers-guide.md#creating-a-new-contributor-insight-page). It can help you better understand their contributions to your project and the open source ecosystem. Here are some methods you can use to help you analyze its data: - Monitor contributors to see if they are active enough in your repositories to contribute as a team member. From 165c670fb6953949ee2015a283f5874a9da01e7b Mon Sep 17 00:00:00 2001 From: Christine Date: Mon, 27 May 2024 02:13:28 +0000 Subject: [PATCH 67/69] docs: fixed formatting of the note --- docs/maintainers/growing-your-project.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index aeec9721..ab2ce1f7 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -24,7 +24,9 @@ If you have said yes, it's time to develop your growth strategies. If you haven' When it comes to planning the growth strategies for your open source project, picking the right people will determine how successful your project will be. You can discover the right people for your project by starting with a [Repository Insight Page](../maintainers/maintainers-guide.md#creating-a-new-repository-insight-page). From there, you can use the Contributors dashboard to help you get a better understanding of your existing contributors. ::: note + Consider using our AI-powered chatbot, [StarSearch](../features/star-search.md#user-guide) if you need more assistance with finding new contributors and team members. + ::: Once you have found a reliable group of contributors, consider adding them to a [Contributor Insight Page](../maintainers/maintainers-guide.md#creating-a-new-contributor-insight-page). It can help you better understand their contributions to your project and the open source ecosystem. Here are some methods you can use to help you analyze its data: From e0ca1267ec8756679fb163e44659ea5176816e28 Mon Sep 17 00:00:00 2001 From: Christine Belzie <105683440+CBID2@users.noreply.github.com> Date: Mon, 27 May 2024 10:56:40 -0400 Subject: [PATCH 68/69] docs: fix formatting --- docs/maintainers/growing-your-project.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index ab2ce1f7..49cfdfe9 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -26,8 +26,8 @@ When it comes to planning the growth strategies for your open source project, pi ::: note Consider using our AI-powered chatbot, [StarSearch](../features/star-search.md#user-guide) if you need more assistance with finding new contributors and team members. - ::: + Once you have found a reliable group of contributors, consider adding them to a [Contributor Insight Page](../maintainers/maintainers-guide.md#creating-a-new-contributor-insight-page). It can help you better understand their contributions to your project and the open source ecosystem. Here are some methods you can use to help you analyze its data: - Monitor contributors to see if they are active enough in your repositories to contribute as a team member. From 7c94f1415b08a715dab2da96a7fc7b16691bd04e Mon Sep 17 00:00:00 2001 From: Christine Belzie Date: Mon, 27 May 2024 12:56:53 -0400 Subject: [PATCH 69/69] docs: redid the note Signed-off-by: Christine Belzie --- docs/maintainers/growing-your-project.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/maintainers/growing-your-project.md b/docs/maintainers/growing-your-project.md index 49cfdfe9..5cb8e848 100644 --- a/docs/maintainers/growing-your-project.md +++ b/docs/maintainers/growing-your-project.md @@ -22,10 +22,10 @@ If you have said yes, it's time to develop your growth strategies. If you haven' ## How to Identify New Contributors and Team Members When it comes to planning the growth strategies for your open source project, picking the right people will determine how successful your project will be. You can discover the right people for your project by starting with a [Repository Insight Page](../maintainers/maintainers-guide.md#creating-a-new-repository-insight-page). From there, you can use the Contributors dashboard to help you get a better understanding of your existing contributors. +:::note -::: note +If you need more assistance with finding new contributors and team members for your project, consider using our AI-powered chatbot, [StarSearch](../features/star-search.md#user-guide). -Consider using our AI-powered chatbot, [StarSearch](../features/star-search.md#user-guide) if you need more assistance with finding new contributors and team members. ::: Once you have found a reliable group of contributors, consider adding them to a [Contributor Insight Page](../maintainers/maintainers-guide.md#creating-a-new-contributor-insight-page). It can help you better understand their contributions to your project and the open source ecosystem. Here are some methods you can use to help you analyze its data: