diff --git a/README.md b/README.md index e2e2e27..f14a2a0 100644 --- a/README.md +++ b/README.md @@ -12,35 +12,36 @@ Welcome to the Becoming a Maintainer Course with OpenSauced! This course is desi The course is divided into chapters, with each covering a different aspect of being an open source maintainer: -### [Intro: Understanding the Role of an Open Source Maintainer](/intro.md) +### [Intro: Understanding the Role of an Open Source Maintainer](intro.md) -### [How to Setup Your Open Source Project](/how-to-setup-your-project.md) +### [How to Setup Your Open Source Project](how-to-setup-your-project.md) -### [How to Handle Open Issues and Pull Requests](/issues-and-pull-requests.md) +### [How to Handle Open Issues and Pull Requests](issues-and-pull-requests.md) -### [Maintainer Power Ups](/maintainer-powerups.md) +### [Maintainer Power Ups](maintainer-powerups.md) -### [Building Your Open Source Dream Team](/your-team.md) +### [Building Your Open Source Dream Team](your-team.md) -### [Building and Nurturing a Welcoming and Supportive Community](/building-community.md) +### [Building and Nurturing a Welcoming and Supportive Community](building-community.md) -### [How to Communicate and Collaborate Effectively](/communication-and-collaboration.md) +### [How to Communicate and Collaborate Effectively](communication-and-collaboration.md) -### [How to Maintain Code Quality and Documentation](/maintaining-code-quality.md) +### [How to Maintain Code Quality and Documentation](maintaining-code-quality.md) -### [Let's Get Practical: Starting Your Project](/getting-practical.md) +### [Let's Get Practical: Starting Your Project](getting-practical.md) -### [The Power of Metrics and Analytics](/metrics-and-analytics.md) +### [The Power of Metrics and Analytics](metrics-and-analytics.md) ### Additional Information As this is the beginning of your open source maintainer journey, we've also provided additional information in these chapters: -- [Glossary](/glossary.md): A glossary of common terms and definitions used by open source maintainers. +- [Glossary](glossary.md): A glossary of common terms and definitions used by open source maintainers. +- [Additional Resources](additional-resources.md): A list of resources for further learning about open source maintainers. ## Getting Started -To start the course, navigate to the [`intro` file](/intro.md) in the repository or visit the [Becoming a Maintainer Course with OpenSauced website](https://maintainer.opensauced.pizza/) and start reading! Each chapter builds on the previous one, so we recommend reading them in order. +To start the course, navigate to the [`intro` file](intro.md) in the repository or visit the [Becoming a Maintainer Course with OpenSauced website](https://maintainer.opensauced.pizza/) and start reading! Each chapter builds on the previous one, so we recommend reading them in order. As you work through the course, we encourage you to experiment with the tools and concepts covered in the chapters. @@ -60,9 +61,9 @@ Happy learning and contributing! ## 🤝 Contributing to this Repository -We encourage you to contribute to OpenSauced! All contributors are required to abide by our [Code of Conduct](https://github.com/open-sauced/.github/blob/main/CODE_OF_CONDUCT.md). Please check out the [Contributing Guidelines](/CONTRIBUTING.md) for information on how to contribute. +We encourage you to contribute to OpenSauced! All contributors are required to abide by our [Code of Conduct](https://github.com/open-sauced/.github/blob/main/CODE_OF_CONDUCT.md). Please check out the [Contributing Guidelines](CONTRIBUTING.md) for information on how to contribute. -If you want to translate our Becoming a Maintainer Course with OpenSauced course, check out our [🌐 i18n Guidelines](/i18n-guidelines.md). +If you want to translate our Becoming a Maintainer Course with OpenSauced course, check out our [🌐 i18n Guidelines](i18n-guidelines.md). ## ⚖️ LICENSE diff --git a/_layouts/sidebar.md b/_layouts/sidebar.md index b527c9e..7ee56d8 100644 --- a/_layouts/sidebar.md +++ b/_layouts/sidebar.md @@ -1,15 +1,14 @@ - **Chapters** - - [Open Source Maintainer](/intro.md) - - [Setting Up Your Project](/how-to-setup-your-project.md) - - [Issues and Pull Requests](/issues-and-pull-requests.md) - - [Maintainer Power Ups](/maintainer-powerups.md) - - [Setting Up Your Team](/your-team.md) - - [Building and Nurturing Community](/building-community.md) - - [Effective Communication and Collaboration](/communication-and-collaboration.md) - - [Maintaining Code Quality and Documentation](/maintaining-code-quality.md) - - [The Power of Metrics and Analytics](/metrics-and-analytics.md) - - [Let's Get Practical](/getting-practical.md) - -- **Resources** - - [Resources](/resources.md) + - [Open Source Maintainer](intro.md) + - [Setting Up Your Project](how-to-setup-your-project.md) + - [Issues and Pull Requests](issues-and-pull-requests.md) + - [Maintainer Power Ups](maintainer-powerups.md) + - [Setting Up Your Team](your-team.md) + - [Building and Nurturing Community](building-community.md) + - [Effective Communication and Collaboration](communication-and-collaboration.md) + - [Maintaining Code Quality and Documentation](maintaining-code-quality.md) + - [The Power of Metrics and Analytics](metrics-and-analytics.md) + - [Let's Get Practical](getting-practical.md) + - [Maintainers Guestbook](maintainers-guestbook.md) + - [Additional Resources](additional-resources.md) diff --git a/additional-resources.md b/additional-resources.md new file mode 100644 index 0000000..c413f6e --- /dev/null +++ b/additional-resources.md @@ -0,0 +1,21 @@ +# Additional Resources + +On this page, you will find additional resources to help you learn more about all things around open source maintainers. + +## Guides + +- [Open Source Guide](https://opensource.guide/) by GitHub: Open Source Guides are a collection of resources for individuals, communities, and companies who want to learn how to run and contribute to an open-source project. +- [Contributor Ladder Template](https://github.com/cncf/project-template/blob/main/CONTRIBUTOR_LADDER.md) by cncf: This is a template for a contributor ladder that outlines the different contributor roles within a project, along with the responsibilities and privileges that come with them. +- [Maintainer Community](https://maintainers.github.com/auth/signin) by GitHub: The Maintainer Community is a private space for maintainers to connect with peers, preview GitHub features, and help GitHub support the open source community. + +## Blog Posts + +- [New Maintainer Resources Series](https://dev.to/bekahhw/series/25520) +- [Maintainer Toolkit Series](https://dev.to/bekahhw/series/24725) by BekahHW +- [Maintainer Toolkit Series](https://dev.to/nickytonline/series/24726) by Nick Taylor +- [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) +- [The Lonely Journey of Open-Source Maintainers: A Call for Connection and Recognition](https://dev.to/opensauced/the-lonely-journey-of-open-source-maintainers-a-call-for-connection-and-recognition-2ghe) +- [The Role of Documentation in Open Source Success](https://dev.to/opensauced/the-role-of-documentation-in-open-source-success-2lbn) +- [How To Make a Delicious Contributing Guide](https://dev.to/opensauced/how-to-make-a-delicious-contributing-guide-4bp3) +- [What Does an Open Source Triage Team Do?](https://dev.to/opensauced/what-does-an-open-source-triage-team-do-2egd) diff --git a/assets/img/pizza-slice.png b/assets/img/pizza-slice.png new file mode 100644 index 0000000..7272365 Binary files /dev/null and b/assets/img/pizza-slice.png differ diff --git a/getting-practical.md b/getting-practical.md index 86de2ba..29c6c2e 100644 --- a/getting-practical.md +++ b/getting-practical.md @@ -367,4 +367,8 @@ Once your project is up and running, monitoring its health and activity is impor You can learn more about how to create a successful project with OpenSauced with our [Maintainers Guide to OpenSauced](https://docs.opensauced.pizza/maintainers/maintainers-guide-to-open-sauced/). -Congratulations on creating your first project! Remember, these steps are guidelines; the key to a healthy open source project is to foster an open, inclusive, and collaborative environment. +--- + +Congratulations on creating your first project! Now, you can share it on our [Maintainers Guestbook](./maintainers-guestbook.md) page. + +?> Remember, these steps are guidelines; the key to a healthy open source project is to foster an open, inclusive, and collaborative environment. diff --git a/index.html b/index.html index 174cef0..cf06f19 100644 --- a/index.html +++ b/index.html @@ -1,61 +1,61 @@ - - - Open Sauced - - - - - - - -
- - - - - - - + + + Open Sauced + + + + + + + +
+ + + + + + + diff --git a/maintainers-guestbook.md b/maintainers-guestbook.md new file mode 100644 index 0000000..e2953ff --- /dev/null +++ b/maintainers-guestbook.md @@ -0,0 +1,10 @@ +# Maintainers Guestbook + +Congratulations on finishing the Becoming a Maintainer Course with OpenSauced. Welcome to our Maintainers Guestbook, where you can share your first project with us! + +## Projects List + + +