Merge branch 'open-sauced:main' into main

Author: CBID2

.github/workflows/auto-add-to-project.yml

@@ -0,0 +1,24 @@
+name: Adds all issues opened in the /docs repo to the Team Dashboard
+
+on:
+  issues:
+    types:
+      - opened
+
+jobs:
+  add-to-project:
+    name: Add issue to project
+    runs-on: ubuntu-latest
+    steps:
+      - name: Generate token
+        id: generate_token
+        uses: tibdex/github-app-token@v1
+        with:
+          app_id: ${{ secrets.OS_GITHUB_APP_ID }}
+          private_key: ${{ secrets.OS_GITHUB_APP_PRIVATE_KEY }}
+    
+      - name: add issue to team dashboard
+        uses: actions/[email protected]
+        with:
+          project-url: https://github.com/orgs/open-sauced/projects/25
+          github-token: ${{ steps.generate_token.outputs.token }}

CHANGELOG.md

@@ -5,6 +5,20 @@
 
 > All notable changes to this project will be documented in this file
 
+## [1.69.0](https://github.com/open-sauced/docs/compare/v1.68.0...v1.69.0) (2024-03-21)
+
+
+### Features
+
+* Add student guide ([#283](https://github.com/open-sauced/docs/issues/283)) ([eb591fd](https://github.com/open-sauced/docs/commit/eb591fdf7aec5b31d3c1f18b88060c759a0f4815))
+
+## [1.68.0](https://github.com/open-sauced/docs/compare/v1.67.1...v1.68.0) (2024-03-20)
+
+
+### Documentation
+
+* Add section on workspaces to maintainers guide ([#279](https://github.com/open-sauced/docs/issues/279)) ([c0fe6b9](https://github.com/open-sauced/docs/commit/c0fe6b96869d88dff8205c05f32f754679ebc457))
+
 ### [1.67.1](https://github.com/open-sauced/docs/compare/v1.67.0...v1.67.1) (2024-03-12)
 
 

docs/contributors/contributors-guide.md

@@ -103,7 +103,7 @@ Sharing the story of your hard work is an opportunity to connect with the reader
 
 1. **Describe the topic**: Begin with an interesting blog post summary to help your peers and potential recruiters understand your writing.
 2. **Discuss the inspiration**: Explain why you wrote this blog post. Is it to guide others on improving their coding skills, raise awareness about an issue in the tech community, or display your progress in learning a new programming language?
-3. **End with a call-to-action**: Encourage readers to read and engage with the post, whether by commenting or sharing it with others on social media.
+3. **End with a call-to-action**: Encourage readers to read and engage with the post.
 
 ## Repository Insights: Connecting Your Repositories
 

docs/maintainers/maintainers-guide.md

@@ -12,11 +12,66 @@ keywords:
 
 ## Introduction to OpenSauced for Maintainers
 
-OpenSauced is a platform dedicated to empowering maintainers and redefining open source contributions. We offer a GitHub-powered dashboard for tracking contributions and gaining insights into your open source projects. You can customize your [Repository Insights](#repository-insights-connecting-your-repositories) and [Contributor Insights](#contributor-insights-connecting-with-contributors) with the repositories you choose and the contributors you want to see.
+OpenSauced is a platform dedicated to empowering maintainers and redefining open source contributions. We offer a GitHub-powered dashboard for tracking contributions and gaining insights into your open source projects. You can create a [Workspace](#your-workspace-streamlining-open-source-project-management) to collaborate with your team and customize your [Repository Insights](#repository-insights-connecting-your-repositories) and [Contributor Insights](#contributor-insights-connecting-with-contributors) with the repositories you choose and the contributors you want to see.
 
 ## Getting Started
 
-To get started, you will need to create an account on OpenSauced. You can do this by visiting the [app.opensauced.pizza](https://app.opensauced.pizza) and clicking the "Connect with GitHub" button. You will be prompted to sign in with your GitHub account. Once you have signed in, you will be redirected to the OpenSauced dashboard.
+To get started, you will need to create an account on OpenSauced. You can do this by visiting the [app.opensauced.pizza](https://app.opensauced.pizza) and clicking the "Connect with GitHub" button. You will be prompted to sign in with your GitHub account. Once you have signed in, you will be redirected to your Workspace.
+
+## Your Workspace: Streamlining Open Source Project Management
+
+When you're working with a team, managing multiple projects or even an assortment of repositories within a single project can become overwhelming, especially as you try to keep everyone up-to-date on key information that impacts your projects. Understanding the direction and value of your project can be challenging. To navigate these challenges effectively, you can use Workspaces to:
+
+- **Understand your project at a high level**: Being able to look at all your repositories and understand them at a high level makes it easier for you to share this information, collaborate with others, and understand where your projects stand in terms of health.
+- **Collaborate and create transparency with your team**: Understanding the activity for all of your projects equips you to make decisions as a team, set goals for your projects, and understand what brings the most value to those using your project. 
+- **Streamline contributor engagement**: Having a high level understanding of your project is a good step in understanding your project’s value, but really understanding what’s happening beneath the surface is the next step in being able to assess project health, growth, and the contributor community. 
+- **Measure and share success**:  Without insight into your project's activity level, health, and contributor community, it can be a challenge to show the value of your projects. Having real-time analytics on your projects can help you to highlight your key achievements, recognize the impact of your contributors, and communicate the hard work that’s been put into your projects.
+
+Workspaces is a feature designed to provide maintainers and teams with a centralized platform for organizing, tracking, and analyzing their open source activity. Workspaces gives you a holistic view of project health, team collaboration, and contributor engagement.
+
+### Creating a New Workspace
+
+To create a workspace, start by accessing the **Workspace switcher** in the sidebar. From there, you can create a new workspace or view an existing one.
+
+![workspace switcher](../../static/img/workspace-switcher.png)
+
+<br/>
+
+:::note
+
+Whenever you select "Home", you'll be taken to the last workspace you opened.
+
+:::
+
+### Adding Repositories to Your Workspace
+
+If you're creating a new workspace, you'll have the option to add repositories at the time of creation.
+
+Start by creating a workspace name, then click "Add repositories." You'll have three options for adding repositories:
+
+1. **Search for Repositories**: Use our search tool by adding an organization name, followed by the repository name, and add them to your workspace.
+2. **Import a GitHub Organization**: Connect to your GitHub organizations to create a workspace from an organization. (If you're having trouble with this, see the "[Sync Your GitHub Team](../welcome/faqs.md#sync-your-github-team)" section in our FAQs.)
+3. **Import Repositories**: Paste a list of repositories to add to your workspace.
+
+Once your repositories are added, you'll be able to see them in your repository dashboard. You can also edit your workspace to add or remove repositories anytime.
+
+### Navigating Your Workspace
+
+Once your repositories are connected, you'll enter your Workspace dashboard. In your workspace dashboards, you can create, view, and manage your workspaces.
+
+#### Repositories Dashboard
+
+![Workspaces](../../static/img/workspace.png)
+
+Within the repositories dashboard, you can view the following metrics, which are over a period of thirty days by default:
+
+- **Pull Requests**: This includes the total opened and merged pull requests for the repositories included in your workspace, as well as the velocity of pull requests being merged.
+- **Issues**: This includes the total opened and closed issues for the repositories included in your workspace, as well as the velocity of issues being closed.
+- **Engagement**: This includes the total stars, forks, and activity ratio for the repositories included in your workspace.
+
+Using Workspaces is a new way of approaching open source project management. By centralizing the oversight of your projects and facilitating team collaboration, Workspaces help you to make informed decisions, prioritize effectively, and foster a thriving open source community.
+
+Beyond workspaces, you may want to get insights into other repositories and contributors to help you understand the health and growth of your projects. One way to do that is through Repository Insights.
 
 ## Repository Insights: Connecting Your Repositories
 

docs/job-seekers-guide/categorize-contributions.md docs/opensauced-guides/job-seekers-guide/categorize-contributions.md

@@ -57,7 +57,7 @@ As you fill out the remaining sections for project contributions, check to see i
 
 After you have filled out the career section of the table, you will want to find open source projects that align with your goals. You can use the explore feature on OpenSauced to explore new repositories in a variety of topics like [JavaScript](https://app.opensauced.pizza/javascript/dashboard/filter/recent?range=30), [Python](https://app.opensauced.pizza/python/dashboard/filter/recent?range=30), and [Machine Learning](https://app.opensauced.pizza/ml/dashboard/filter/recent?range=30).
 
-![Explore Machine Learning projects in OpenSauced](../../static/img/ml-explore-page.png)
+![Explore Machine Learning projects in OpenSauced](../../../static/img/ml-explore-page.png)
 
 Finding a good project to contribute to takes time. So, make sure to look at the frequency of contributions to the project and the types of issues and features the project needs help with. If it aligns with your career goals, then start off with smaller issues before moving to larger features. You will also want to join the project's community chat room or Discord channel to connect with other contributors and core team members of the project.
 
@@ -104,27 +104,27 @@ For each project contribution, you will want to list the date, a brief summary o
 
 ### Using the Highlights Feature to Track Your Contributions
 
-The [Highlights feature](../features/highlights.md) is where you can display your favorite open source contributions and share your open source story.
+The [Highlights feature](../../features/highlights.md) is where you can display your favorite open source contributions and share your open source story.
 
-![OpenSauced Highlights](../../static/gif/highlight.gif)
+![OpenSauced Highlights](../../../static/gif/highlight.gif)
 
 You can use this feature to help you track the open source contributions you are most proud of and share your accomplishments with your network. All your highlights will appear on your OpenSauced profile. So, sharing your profile is another way to let potential employers see the types of contributions you've made and the highlights you've identified as the most important.
 
 ### Using the Contributor Insight Feature to Follow People
 
-The [Contributor Insights feature](../features/contributor-insights.md) enables you to categorize, monitor, and analyze different groups of contributors within open source projects.
+The [Contributor Insights feature](../../features/contributor-insights.md) enables you to categorize, monitor, and analyze different groups of contributors within open source projects.
 
 You can use this feature to create a list of people you interacted with during your open source work. If you continually work with the same individuals, they can act as referrals and references for jobs.
 
 Contributor Insights can also be used to track other people in your network to reach out to about their contributions.
 
-![Contributor Insights page](../../static/img/lists-page.svg)
+![Contributor Insights page](../../../static/img/lists-page.svg)
 
 ### Using the Repository Insights Feature to Track the Repositories You Contributed to
 
-The [Repository Insights feature](../features/repo-insights.md) is a comprehensive view of a project's health and individual contributions. You can use it to track the repositories you contributed to or to track repositories of open source companies that are hiring.
+The [Repository Insights feature](../../features/repo-insights.md) is a comprehensive view of a project's health and individual contributions. You can use it to track the repositories you contributed to or to track repositories of open source companies that are hiring.
 
-![insight-pages-demo](../../static/gif/insight-page-demo.gif)
+![insight-pages-demo](../../../static/gif/insight-page-demo.gif)
 
 ### Networking and Professional Development
 
@@ -141,11 +141,11 @@ If you have corresponded with the same core contributors and maintainers over th
 
 ### Using Your OpenSauced Dev Card for Networking
 
-Your [OpenSauced Dev Card](../features/dev-card.md) serves as your "open source business card" to showcase all of your recent open source activities. You will find recent activity concerning the projects you contribute to, the frequency of PRs, and projects you are interested in.
+Your [OpenSauced Dev Card](../../features/dev-card.md) serves as your "open source business card" to showcase all of your recent open source activities. You will find recent activity concerning the projects you contribute to, the frequency of PRs, and projects you are interested in.
 
 You can easily share your Dev Card on social media platforms like X/Twitter and LinkedIn to gain attention from potential recruiters and hiring managers.
 
-![OpenSauced Dev card](../../static/img/a-dev-card.png)
+![OpenSauced Dev card](../../../static/img/a-dev-card.png)
 
 ### Reflection and Next Steps
 
@@ -166,7 +166,7 @@ After each contribution, you will want to update your LinkedIn profile and resum
 
 The Highlights feature allows you to post about your recent open source contributions on OpenSauced and share them with other social media outlets like Twitter and LinkedIn.
 
-![OpenSauced Highlights Feature](../../static/img/highlights.png)
+![OpenSauced Highlights Feature](../../../static/img/highlights.png)
 
 | **Section**                                | **Details**                                |
 | ------------------------------------------ | ------------------------------------------ |

docs/job-seekers-guide/introduction.md docs/opensauced-guides/job-seekers-guide/introduction.md

@@ -9,7 +9,6 @@ keywords:
   - "open source projects for tech resume"
   - "open source skills for tech employers"
   - "land your dream tech job"
-open sauced:
 ---
 
 When you are looking for a tech job, it is important to stand out amongst the sea of candidates. One great way to stand out and showcase your skills is through open source contributions.
@@ -18,4 +17,4 @@ Open source provides you the opportunity to showcase your code, documentation, c
 
 OpenSauced can help you craft an open source profile that is attractive to hiring managers and recruiters and help you land that next role.
 
-In this guide, you will learn how to use OpenSauced features like your personal [Dev Card](../features/dev-card.md), [Highlights](../features/highlights.md), [Contributor Insights](../features/contributor-insights.md), and [Repository Insights](../features/repo-insights.md) to showcase your open source work and build connections to help you land a job.
+In this guide, you will learn how to use OpenSauced features like your personal [Dev Card](../../features/dev-card.md), [Highlights](../../features/highlights.md), [Contributor Insights](../../features/contributor-insights.md), and [Repository Insights](../../features/repo-insights.md) to showcase your open source work and build connections to help you land a job.