Revamp contribution guides

docs/content/community/overview.md → docs/content/contributing/community/index.md

@@ -1,9 +1,9 @@
 ---
 type: docs
 title: "Radius Community"
-linkTitle: "Overview"
+linkTitle: "Community"
 description: "Information about the Radius community"
-weight: 100
+weight: 200
 ---
 
 Welcome to the Radius community!
@@ -18,10 +18,6 @@ The best way to interact with the community is via the Radius Discord server:
 
 Every month we host a community meeting to showcase new features, review upcoming milestones, and engage in a Q&A. Anyone from the Radius community can participate, present a topic, or host. All are welcome! For the meeting schedule, links, and more information, visit the Radius [community repo](https://github.com/radius-project/community#community-meetings).
 
-## GitHub Issues & repositories
-
-If you would like to file Issues, access the source code, or use Codespaces please visit the [Radius GitHub repo](https://github.com/radius-project).
-
 ## How can I get involved?
 
 One of the easiest ways to contribute is to participate in discussions at community engagements or via the Discord server referenced above. We are always seeking feedback, especially for suggestions around improving the product and docs.

docs/content/contributing/docs/_index.md

@@ -0,0 +1,7 @@
+---
+type: docs
+title: "Radius Docs"
+linkTitle: "Docs"
+description: "Learn how to contribute and maintain the Radius documentation"
+weight: 300
+---

docs/content/community/contributing/contributing-docs/index.md → docs/content/contributing/docs/contributing-docs/index.md

@@ -3,8 +3,7 @@ type: docs
 title: "How-To: Contribute to the Radius documentation"
 linkTitle: "Contribute to docs"
 description: "How to contribute to the Radius documentation"
-weight: 200
-slug: "docs"
+weight: 10
 ---
 
 The Radius docs are built on [Hugo](https://gohugo.io) with the [Docsy](https://docsy.dev) theme. GitHub Actions are used to build and deploy the docs upon each PR.

docs/content/community/maintainers/docs-maintainers.md → docs/content/contributing/docs/maintainers-docs/index.md

@@ -2,7 +2,7 @@
 type: docs
 title: "How-To: Maintain the Radius docs"
 linkTitle: "Maintain docs"
-weight: 200
+weight: 20
 description: "Learn about the Radius docs maintenance process"
 ---
 

docs/content/contributing/overview/index.md

@@ -0,0 +1,43 @@
+---
+type: docs
+title: "Overview: Contributing to Radius"
+linkTitle: "Overview"
+description: "Guides and requirements for contributing to Radius"
+weight: 100
+---
+
+We welcome contributions to Radius! Contributions can come in different ways such as engaging with the community, contributing code, or improving the documentation. This page provides an overview of the different ways you can contribute to Radius.
+
+## Community
+
+Check out the [Radius Community]({{< ref community >}}) page to learn about the different ways you can engage with the Radius community.
+
+## GitHub
+
+If you would like to file Issues, access the source code, or use Codespaces please visit the [Radius GitHub repo](https://github.com/radius-project). 
+
+### good-first-issues
+
+To quickly get started with contributing to code on Radius, here are some identified [good-first-issues](https://aka.ms/radius-first-issues) that you can `/assign` to yourself and start contributing. 
+
+### Contributing to Radius
+
+Check out the following table to learn where and how you can contribute:
+
+| Repository | Description | Contribution guides |
+|------------|-------------|---------------------|
+| **Radius** | Main repository that contains source code for [`rad` CLI]((https://github.com/radius-project/radius/blob/main/docs/contributing/contributing-code/contributing-code-cli/running-rad-cli.md)), [control plane]((https://github.com/radius-project/radius/blob/main/docs/contributing/contributing-code/contributing-code-control-plane/README.md)) and other components of Radius | [radius-project/radius](https://github.com/radius-project/radius/blob/main/CONTRIBUTING.md)|
+| **Docs** | Documentation for Radius | [[Contributing to docs]]({{< ref contributing-docs>}})|
+| **Recipes** | Commonly used [Recipe](https://docs.radapp.io/recipes) templates for Radius Environments | [radius-project/recipes](https://github.com/radius-project/recipes/blob/main/CONTRIBUTING.md) |(https://github.com/radius-project/recipes/blob/main/CONTRIBUTING.md) |
+| **Dashboard** | The frontend experience for Radius |[radius-project/dashboard](https://github.com/radius-project/dashboard/blob/main/CONTRIBUTING.md) |
+| **Bicep** |  Language and tools which includes the application model as a set of types which will eventually be merged with https://github.com/azure/bicep | [radius-project/bicep](https://github.com/radius-project/bicep/blob/radius-compiler/CONTRIBUTING.md) |
+
+### Troubleshooting common issues
+
+### Visual Studio not authorized for single sign-on
+
+If you receive an error saying Visual Studio Code or another application is not authorized to clone any of the Radius repositories you may need to re-authorize the GitHub app:
+
+1. Open a browser to https://github.com/settings/applications
+1. Find the applicable app and select Revoke
+1. Reopen app on local machine and re-auth

docs/content/tutorials/eshop/_index.md

@@ -39,5 +39,3 @@ Adding Radius to the eShop on containers application allows teams to:
 - Simplify deployment with Bicep and Azure Resource Manager (ARM)
 
 {{< button text="View eShop sample" githubRepo="samples" githubPath="samples/eshop" color="success" size="btn-lg" >}}
-
-*Visit the [GitHub docs]({{< ref github >}}) if you need access to the organization*